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