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