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

Другое · 6 мин

Передача параметра с клиента на сервер в 1С: практическая инструкция

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

Параметр передаётся с клиента на сервер явно: в качестве аргумента экспортной процедуры или функции, исполняемой на сервере. Клиент не может просто «поделиться» переменной формы или глобальной переменной с серверным кодом, если эта переменная не передана в вызов.

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

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

Когда параметр передаётся на сервер

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

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

Сценарий: кнопка команды формы

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

Пример клиентского вызова без выдуманных имён:

МодульМенеджераОбъекта.СервернаяОбработка(ВыбраннаяСсылка);

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

Через экспортную процедуру модуля менеджера

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

Пример описания серверной процедуры:

Процедура СервернаяОбработка(Знач Параметр) Экспорт

// действия на сервере

КонецПроцедуры

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

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

Через значение формы и контекст выполнения

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

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

Сценарий: обработка выбора справочника

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

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

Проверка результата и типичные ошибки

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

Частые ошибки: передача клиентского объекта формы вместо значения, попытка использовать неопределённый параметр на сервере, изменение данных без проверки прав доступа. Также опасно полагаться на глобальные переменные клиента — они не доступны на сервере автоматически.

Ограничения и безопасная работа

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

Сравнение вариантов

Один параметр

Подходит для простых вызовов и ссылок

Структура параметров

Удобна для нескольких связанных значений

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

Необходимо, если клиенту нужен результат серверной обработки

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

Сравнение вариантов передачи

Один параметр подходит для простых команд и справочных ссылок. Структура удобна, когда нужно передать несколько связанных значений сразу. Возвращаемое значение необходимо, если клиент должен получить результат серверной обработки.

Итог

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

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

Нужно ли всегда использовать Знач для параметра?

Не обязательно, но Знач делает передачу по значению и предотвращает неявные изменения переменной на клиенте. Для ссылок на объекты базы разница часто невелика, но для простых значений это более предсказуемый вариант.

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

Нет, не напрямую. Серверный код не имеет доступа к элементам формы и текущему выбору пользователя, если эти данные не переданы в параметрах вызова.

Что делать, если параметр на сервере равен Неопределено?

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

Безопасно ли изменять данные на сервере из клиента?

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