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

Другое · 9 мин

Вызов клиентской процедуры с сервера в 1С

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

Серверный код в 1С и клиентский код выполняются в разных средах, поэтому сервер не может напрямую запустить процедуру, помеченную как клиентская. Процедуры на сервере обычно помечаются директивой &НаСервере, а на клиенте — &НаКлиенте. Это архитектурное ограничение, а не ошибка конфигурации.

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

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

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

1c
&НаСервере
Процедура ИнициироватьКлиентскоеДействие()
    Оповестить(ТекущийПользователь(), "ОбновитьФорму", Новый Структура);
КонецПроцедуры

&НаКлиенте
Процедура ОбработкаОповещения(Сообщение, Данные, Источник) Экспорт
    Если Сообщение = "ОбновитьФорму" Тогда
        ОбновитьФорму();
    КонецЕсли;
КонецПроцедуры

Почему прямой вызов клиентской процедуры с сервера недоступен

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

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

Прямой вызовНе поддерживается

Сервер не имеет доступа к клиентской сессии

ОповещениеБыстрая инициизация

Проверьте доставку и подписку клиента

Признак в данныхНадёжная фиксация

Требуется проверка и сброс флага клиентом

Способ оповещения клиента

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

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

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

Признак в данных и проверка клиентом

Альтернативой оповещению является запись признака в регистр сведений, реквизит объекта или временное хранилище. Сервер устанавливает флаг, например «ТребуетсяОбновлениеФормы», и завершает работу. Клиент по таймеру, при открытии формы или при действии пользователя проверяет этот признак и, если он установлен, вызывает клиентскую процедуру и снимает флаг.

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

Вызов клиентского метода формы, если поддерживается

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

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

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

Ограничения, проверка результата и безопасная работа

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

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

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

Флаг обновления на клиенте
Норма

Снят после вызова процедуры

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

Остаётся установленным после обработки

Сообщение пользователю
Норма

Отображается на форме

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

Изменение данных
Норма

Выполнено в клиентской сессии

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

Дублирование при повторном оповещении

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

Частые ошибки и порядок действий

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

Типичные ошибки
01
Прямой вызов клиентской процедуры с сервера — не работает
02
Считание оповещения гарантией выполнения без проверки клиента
03
Блокировка сервера в ожидании клиентского кода

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

Как проверить, что клиентская процедура запустилась

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

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

Оповещение клиента

Подходит для активных сессий, не гарантирует мгновенного выполнения

Признак в данных

Надёжен при разрыве связи, требует клиентской проверки и сброса

Клиентский метод формы

Ограничен поддержкой платформы и типа формы

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

Что выбрать в зависимости от задачи

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

Итог

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

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

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

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

Что делать, если клиент отключён в момент оповещения?

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

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

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

Нужно ли тестировать решение на всех типах клиентов?

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