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