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