К статье
Практический материал

Другое · 7 мин

Передача данных с клиента на сервер в 1С

Как передать данные с клиента на сервер в 1С: способы вызова серверных процедур, параметры, проверка результата, ограничения и типичные ошибки.

В клиент-серверной архитектуре 1С клиент отвечает за интерфейс и ввод, а сервер — за хранение данных и выполнение бизнес-логики. Любая запись, которая должна сохраниться в информационной базе, в конечном итоге выполняется на стороне сервера.

Передача данных с клиента на сервер реализуется через вызов серверной процедуры с параметрами. Клиент отправляет значения, сервер обрабатывает их и может вернуть результат — например, признак успешной записи, ссылку на объект или сообщение об ошибке.

Важно понимать, что не все данные, введённые в форму, автоматически попадают на сервер. Нужно явно вызвать серверный код, передать нужные реквизиты и обработать возможные исключения.

Когда данные уходят с клиента на сервер

Передача требуется, когда пользователь ввёл значения в реквизиты формы, выбрал элементы справочника или заполнил табличную часть, и эти изменения должны быть сохранены в базе. На этом этапе клиент только готовит пакет данных, а сервер принимает решение о записи.

Серверный код может выполняться при сохранении документа, проведении, перезаписи реквизитов или выборе из справочника. Инициатором всегда остаётся клиент, но фактическая запись происходит в сеансе сервера, где проверяются права и целостность данных.

Клиент ввёл данныеЗначения остаются в форме

Проверьте, есть ли вызов серверного кода

Серверная процедура выполненаДанные обработаны на сервере

Убедитесь в наличии результата или ошибки

Способы вызова серверного кода из клиента

Вызов процедуры с пометкой серверного выполнения

Процедура, предназначенная для выполнения на сервере, вызывается из клиентского контекста с набором параметров. Клиент передаёт значения, сервер выполняет логику и возвращает управление с результатом или исключением.

Такой подход подходит для сохранения документов, проведения операций и записи справочников. Важно, чтобы параметры были доступны на клиенте в момент вызова и не содержали ссылок только на клиентские объекты формы.

Передача через параметры команды или обработчика

Данные могут передаваться через параметры серверной команды, обработчика события или общего модуля. На клиенте формируется структура значений, которая отправляется серверу при выполнении действия.

При таком способе нужно следить за типами параметров: несовпадение типов или передача неинициализированного значения может привести к ошибке на сервере ещё до начала записи.

Порядок передачи данных
  1. 1
    Подготовьте параметры на клиенте
  2. 2
    Вызовите серверную процедуру
  3. 3
    Передайте реквизиты в параметрах
  4. 4
    Проверьте возвращаемый результат
  5. 5
    Обработайте возможную ошибку

Какие данные можно передать

На сервер можно передавать примитивные значения: строки, числа, даты, булевы флаги. Также допустимы сложные составные типы, например структуры, массивы и таблицы значений, если они поддерживаются в используемом клиентском приложении.

Ссылки на объекты базы, такие как справочники или документы, передаются через их уникальные идентификаторы. Сервер по идентификатору находит объект и выполняет с ним нужные операции.

Тип данныхКогда подходитОграничение
ПримитивыОдин реквизит или флагНе подходят для больших наборов
СтруктураНесколько связанных полейНужно соблюдать порядок ключей
Таблица значенийСтроки табличной частиРазмер зависит от сеанса и конфигурации
МассивСписок однородных значенийЭлементы должны быть сериализуемы
Ссылка на объектРабота с существующей записьюОбъект должен существовать на сервере

Перед передачей больших таблиц значений стоит убедиться, что объём данных не приведёт к превышению лимитов сеанса или длительному выполнению. В таких случаях целесообразно разбить передачу на части или использовать отложенную обработку.

Контрольные точки

Как проверить результат

Возвращаемое значение сервера
Норма

Успешный код или ссылка на объект

Тревожный признак

Пустое значение или текст ошибки

Данные в информационной базе
Норма

Запись отображается после обновления

Тревожный признак

Старые значения или отсутствие записи

Как получить результат и проверить запись

После завершения серверной процедуры клиент получает результат: признак успешного выполнения, ссылку на созданный объект или сообщение об ошибке. Именно этот результат нужно анализировать перед тем, как информировать пользователя.

Если сервер вернул исключение, изменения могут быть отменены автоматически, в зависимости от настроек транзакции. В этом случае повторная запись без анализа причины может привести к дублированию или конфликту данных.

Ограничения и риски

Не все операции, доступные на клиенте, разрешены на сервере. Некоторые команды работают только в клиентском сеансе и не имеют серверного аналога. Перед передачей данных нужно проверить, поддерживается ли нужная логика в серверном контексте.

Права доступа пользователя на сервере могут отличаться от прав в клиентском интерфейсе. Даже если форма открыта, запись может быть заблокирована на уровне сервера из-за отсутствия ролей или ограничений по данным.

Типичные ошибки
01
Передача ссылки на форму вместо значения — сервер не получит данные
02
Забыли обработать исключение — запись прерывается без уведомления
03
Попытка сохранить на клиенте без серверного вызова — изменения не попадают в базу

Типичные ошибки

Одна из частых ошибок — попытка сохранить данные только на клиенте без вызова серверного кода. В этом случае изменения видны в форме, но не попадают в информационную базу и пропадают при закрытии сеанса.

Другая ошибка — передача ссылки на клиентский объект формы вместо значения реквизита. Сервер не может использовать такие ссылки и выдаст ошибку или проигнорирует параметр.

Маршрут решения

Как выбрать действие

Нужно сохранить один документ или справочникВызовите серверную процедуру с параметрами реквизитов
Передаётся много строк табличной частиИспользуйте таблицу значений или массив
Сервер возвращает ошибку доступаПроверьте права пользователя, не повторяйте запись

Как выбрать подходящий способ

Выбор зависит от объёма данных, частоты вызова и необходимости получения результата. Для одной записи подходит простой вызов серверной процедуры с параметрами, для массового ввода — таблица значений или массив.

Если операция длительная, лучше использовать асинхронный или отложенный вызов, чтобы клиент не зависал в ожидании. Точный набор способов зависит от вида приложения: управляемое, обычное или веб-клиент.

Итог

Что важно запомнить

Передача требует явного серверного вызова, правильных параметров и проверки результата; без этого данные не сохранятся.

Нужно ли всегда вызывать сервер для сохранения данных?

Да, если изменения должны остаться в информационной базе после закрытия формы. Клиентские изменения без серверного вызова не записываются в базу.

Что делать, если сервер вернул ошибку?

Прочитайте текст ошибки, проверьте права пользователя и корректность переданных параметров. Повторяйте запись только после устранения причины, чтобы избежать дублей.

Можно ли передать на сервер ссылку на форму?

Нет, сервер не работает с клиентскими объектами формы. Передавайте значения реквизитов, ссылки на объекты базы или идентификаторы записей.

Какие данные лучше не передавать большими объёмами?

Большие таблицы значений и массивы могут увеличить нагрузку на сервер и сеанс. Для объёмных данных рассмотрите разбивку на части или отложенную обработку.