Другое · 10 мин
Как передать объект с клиента на сервер в 1С
Как передать данные и ссылки на объекты из клиентского приложения 1С на сервер: параметры процедур, сериализация, проверка результата и ошибки.
В архитектуре «клиент — сервер» 1С клиент и сервер работают в разных процессах, а часто и на разных машинах. Поэтому нельзя просто взять переменную из клиентского кода и использовать её на сервере как обычную локальную переменную. Передача объекта означает передачу данных, ссылки на объект или сериализованного представления, которое сервер сможет интерпретировать в своём контексте.
Клиент инициирует вызов серверной процедуры или функции, а сервер выполняет код в сеансе сервера. Все, что нужно серверу, должно быть передано через параметры вызова, через параметры сеанса, через временное хранилище или иной механизм обмена, поддерживаемый платформой. Выбор способа зависит от типа объекта, от того, нужно ли серверу изменить исходные данные, и от того, какая информация должна вернуться клиенту.
Если передаётся справочник, документ, перечисление или другой объект конфигурации, на сервер обычно уходит не копия самого объекта в памяти клиента, а ссылка на него. Сервер может получить доступ к данным объекта через эту ссылку, если объект существует и доступен в текущем сеансе. При этом изменения, сделанные сервером, не станут автоматически видны клиенту, пока клиент не запросит обновлённые данные или не получит результат вызова.
Для сложных структур, наборов значений или данных из внешних источников удобнее передавать копию в виде структуры, массива, таблицы значений или сериализованного представления. Такой подход снижает зависимость от состояния клиентского объекта, но требует дополнительных действий по восстановлению объекта на сервере и контролю целостности данных.
Что понимать под передачей объекта между клиентом и сервером
Под передачей объекта понимается доставка данных из клиентского модуля в серверный модуль так, чтобы сервер мог использовать их в своей логике. Это может быть ссылка на справочник, документ, набор записей регистра, таблица значений, структура или произвольный набор полей. Важное отличие от работы в одном процессе заключается в отсутствии общей области памяти между клиентом и сервером.
Клиент вызывает серверную процедуру, передавая параметры. Сервер получает копию значений или ссылку, в зависимости от типа параметра и способа вызова. Если объект был изменён на клиенте, но изменения не записаны в базу, сервер может увидеть старую версию или вообще не получить актуальные данные, пока клиент не сохранит их или не передаст явно.
При передаче ссылки на объект сервер может обратиться к свойствам и методам этого объекта, но только в рамках прав доступа текущего пользователя и текущего сеанса. Если объект удалён, заблокирован или недоступен из-за прав, сервер получит ошибку или пустой результат. Поэтому перед передачей ссылки полезно убедиться, что объект существует и клиент имеет на него необходимые права.
Проверьте существование объекта и права доступа
Убедитесь, что структура данных полная и актуальная
Используйте возвращаемое значение или выходной параметр
Когда объект можно передать по ссылке, а когда нужно скопировать
Ссылка на объект подходит, когда серверу нужно прочитать или изменить существующую запись базы данных, например документ или элемент справочника. Сервер получает доступ к объекту через платформу, и изменения могут быть записаны в базу, если у серверного кода есть соответствующие права. Это экономит трафик и память, но делает результат зависимым от состояния базы на момент вызова.
Копию данных в виде структуры или таблицы значений стоит использовать, когда клиент формирует промежуточный набор, который ещё не записан в базу, или когда нужно передать набор произвольных полей, не являющихся объектом конфигурации. Сервер получает независимую копию, и изменения на сервере не влияют на клиентскую переменную, если только клиент не примет возвращённый результат.
Если объект содержит вложенные табличные части, вложенные структуры или ссылки на другие объекты, простая копия может не скопировать все уровни автоматически. В таких случаях нужно явно передавать вложенные таблицы значений, структуры или использовать серийлизацию, чтобы сервер получил полный набор данных. Иначе на сервере окажутся только ссылки, которые могут быть недоступны вне клиентского сеанса.
Способы передачи данных на сервер
Наиболее распространённый способ — параметры серверной процедуры или функции. Клиент вызывает процедуру с ключевым словом серверного выполнения и передаёт в параметры нужные значения: ссылки, строки, числа, даты, структуры, массивы или таблицы значений. Серверная процедура обрабатывает эти данные и может вернуть результат клиенту.
Для передачи сложных объектов удобно упаковывать их в структуру или таблицу значений. Структура подходит для набора именованных полей, таблица значений — для списков одинаковых записей, массив — для упорядоченного набора значений. Перед вызовом клиент заполняет эти коллекции, а на сервере код обходит их и восстанавливает нужные объекты или выполняет расчёты.
Если данные представляют собой сложную иерархию, можно использовать сериализацию в XML или XDTO-подобное представление, если платформа и конфигурация поддерживают соответствующие механизмы. Клиент сериализует объект, передаёт строку или двоичные данные на сервер, а сервер десериализует их в рабочую структуру. Этот способ требует осторожности с типами данных, датами и ссылками, которые могут потерять смысл вне исходного контекста.
Вызов серверной логики из управляемой формы и клиентского приложения
В управляемой форме клиентский модуль может вызвать процедуру, помеченную для выполнения на сервере, передав ей параметры из реквизитов формы, табличной части или выбранных элементов списка. Перед вызовом стоит проверить, что реквизиты заполнены, а выбранные объекты существуют. После получения результата клиент обновляет реквизиты формы, табличные части или выводит сообщение пользователю.
В обычном приложении клиент вызывает серверную процедуру через сеанс, а результат возвращается в клиентский код. Если серверная процедура завершается с ошибкой, клиент получает исключение, которое нужно обработать, чтобы пользователь увидел понятное сообщение вместо технического сбоя. Логирование на сервере помогает определить, на каком этапе передачи данных возникла проблема.
При передаче больших объёмов данных стоит оценить влияние на сетевой трафик и производительность сервера. Передача огромных таблиц значений или длинных строк в каждом вызове может замедлить работу. В таких случаях целесообразно передавать только идентификаторы объектов, фильтры или компактные структуры, а на сервере загружать нужные данные запросами к базе.
- 1Определите, какие данные нужны серверу: ссылка, копия или набор полей
- 2Выберите способ передачи: параметры процедуры, структура, таблица значений или сериализация
- 3Проверьте наличие объектов и права доступа перед вызовом
- 4Вызовите серверную процедуру и обработайте возможные ошибки
- 5Обновите клиентские данные на основе возвращённого результата
Проверка результата и типичные ошибки
После серверного вызова клиент должен проверить, что возвращённые данные соответствуют ожиданиям: количество строк, наличие обязательных реквизитов, корректность дат и ссылок. Если сервер вернул ошибку, нужно прояснить, связана ли она с недоступностью объекта, с отсутствием прав или с некорректными переданными параметрами. Без такой проверки клиент может отобразить пользователю устаревшие или некорректные данные.
Частая ошибка — попытка изменить объект на сервере через ссылку, полученную от клиента, без учёта прав доступа и блокировок. Сервер может успешно получить ссылку, но не иметь права записывать изменения, или объект может быть заблокирован другим пользователем. В этом случае операция завершится ошибкой, а клиент должен быть готов повторить попытку позже или сообщить пользователю о конфликте.
Другая ошибка — передача несохранённых изменений. Клиент может изменить реквизит объекта в памяти, но не записать объект в базу. Если затем передать ссылку на этот объект на сервер, сервер увидит записанную в базу версию, а не клиентские изменения. Решение — сначала сохранить изменения клиентом, либо передать изменённые значения явно через параметры.
Ограничения и безопасная самостоятельная работа
Не все объекты можно передать между клиентом и сервером без потерь. Объекты, привязанные к интерфейсу клиента, временные переменные формы, ссылки на элементы управления или открытые внешние соединения не имеют смысла на сервере. Передавать стоит только данные, которые существуют независимо от клиентского окна: записи базы, справочники, документы, наборы значений и сериализуемые структуры.
Как проверить результат
Объект доступен и не удалён
Ссылка ведёт на несуществующий или заблокированный объект
Сервер может читать и при необходимости записывать
Ошибка доступа при попытке чтения или записи
Клиент получает ожидаемые данные и обновляет форму
Результат пуст, содержит ошибку или игнорируется клиентом
Безопасная самостоятельная работа возможна при передаче простых типов, ссылок на существующие объекты базы и коллекций значений, если код не выполняет запись без проверки прав и блокировок. Риск растёт при работе с большими объёмами данных, при изменении критических документов, при использовании внешних источников или при сериализации сложных иерархий. В таких случаях изменения стоит вносить осторожно, предпочтительно после проверки на тестовой копии базы.
Если после передачи объекта данные не появляются на сервере или изменения не сохраняются, проверьте: существует ли объект, есть ли у текущего пользователя права, правильно ли заполнены параметры вызова, возвращает ли серверная процедура результат и обрабатывает ли клиент ошибки. Отсутствие видимого эффекта часто означает, что результат сервера не был принят клиентом или изменения не были записаны в базу.
Что важно запомнить
Передавайте данные через параметры серверного вызова, проверяйте наличие объектов и права, возвращайте и принимайте результат, не полагайтесь на общую память клиента и сервера.
Можно ли передать объект целиком по ссылке на память клиента?
Нет, клиент и сервер работают в разных процессах, поэтому общая память клиента недоступна серверу. Передаётся либо ссылка на объект базы, либо копия значений, либо сериализованные данные.
Что выбрать: ссылку на объект или таблицу значений?
Ссылку выбирайте, если серверу нужно работать с существующей записью базы и у него есть права на чтение или запись. Таблицу значений или структуру выбирайте для набора произвольных полей, списков записей или данных, ещё не записанных в базу.
Почему сервер не видит изменения, сделанные на клиенте?
Клиент мог изменить объект только в своей памяти, не записав изменения в базу. Сервер получает записанную версию или ссылку на объект без клиентских правок. Нужно либо сохранить изменения клиентом, либо передать изменённые значения явно через параметры.
Что делать, если серверная процедура возвращает ошибку?
Обработайте исключение на клиенте, прочитайте текст ошибки и проверьте наличие объекта, права доступа, корректность переданных параметров и состояние блокировок. После устранения причины повторите вызов с исправленными данными.