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

Другое · 8 мин

Как на сервере 1С получить значение реквизита формы

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

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

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

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

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

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

Клиент вызывает серверную процедуру из обработчика события

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

&НаКлиенте
Процедура КнопкаВыполнитьНажатие(Элемент)
Знач Значение = Объект.Сумма;
Результат = СервернаяОбработка(Значение);
Объект.Сумма = Результат;
КонецПроцедуры

&НаСервере
Функция СервернаяОбработка(Знач Значение)
// действия на сервере
Возврат Значение * 1.1;
КонецФункции

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

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

Получение значения без прямого параметра: допустимые обходные пути

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

Через ссылку на объект базы данных

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

Через общий модуль и реквизит объекта, а не формы

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

Обновление формы после выполнения на сервере

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

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

Отличия тонкого клиента, веб-клиента и управляемого приложения

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

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

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

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

Параметр на сервере
Норма

Значение получено и совпадает с введённым на форме

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

Параметр неопределён или содержит значение по умолчанию

Результат на форме
Норма

Реквизит обновлён после возврата из серверной функции

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

Значение на форме не изменилось после серверного вызова

Данные в базе
Норма

Объект записан и доступен после переоткрытия

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

Изменения не сохранились или вышли ошибки доступа

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

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

Если после серверного вызова форма показывает старые данные, вероятная причина — отсутствие присвоения результата реквизиту формы или отсутствие перечитывания объекта из базы. Это не означает, что сервер не отработал; значит, клиент не применил результат к интерфейсу.

Типичные ошибки
01
Обращение к форме и её элементам из серверного кода — ошибка доступа
02
Передача самой формы вместо значения реквизита или ссылки на объект
03
Забывание присвоить возвращённое сервером значение реквизиту формы на клиенте
04
Расчёт только на сервере без учёта прав доступа к записи объекта

Типичные ошибки и границы самостоятельной работы

Самая частая ошибка — попытка обратиться к форме или её элементам из &НаСервере. Другая ошибка — передача объекта формы вместо значения или ссылки на объект базы. Также часто забывают обновить форму после серверного вызова, из-за чего пользователь не видит изменений.

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

Итог

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

Реквизит формы на сервере недоступен напрямую; значение передаётся параметром клиентом, а результат применяется к форме на клиенте после проверки и записи.

Можно ли прочитать реквизит формы на сервере без параметра?

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

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

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

Обновится ли форма автоматически после записи на сервере?

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

Что делать, если после серверного вызова форма показывает старые данные?

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

Различается ли порядок действий для тонкого клиента и веб-клиента?

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