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