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

Другое · 6 мин

Вызов сервера в 1С: что это значит на практике

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

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

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

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

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

Когда в 1С используется вызов сервера

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

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

Операции с данными и регистрация

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

Доступ к общим настройкам и правам

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

Как пометить процедуру для выполнения на сервере

В модуле объекта или обычном модуле процедуре добавляется директива &НаСервере. Тогда при вызове из клиента выполнение переносится на сервер приложений.

Если контекст клиента не нужен, используется &НаСервереБезКонтекста. Такой вариант легче, но не имеет доступа к некоторым клиентским сущностям и требует явной передачи всех нужных данных.

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

Порядок действий
  1. 1
    Определите, какая часть логики должна работать с базой
  2. 2
    Поместите процедуру под директиву &НаСервере или &НаСервереБезКонтекста
  3. 3
    Передайте в параметры только необходимые идентификаторы и значения
  4. 4
    Проверьте права пользователя и результат на тестовой базе

Что можно передавать, а что нельзя

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

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

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

Ограничения, риски и типичные ошибки

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

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

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

Типичные ошибки
01
Вызов сервера внутри цикла по каждой строке таблицы — лишняя нагрузка и медленная работа
02
Обращение к элементам клиентской формы из серверной процедуры — исключение при выполнении
03
Перенос длительных расчётов в интерактивный вызов без оценки блокировок — задержки для других пользователей

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

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

Сравните поведение в толстом и тонком клиенте: некоторые вызовы работают одинаково, а доступ к клиентским объектам проявляется только в одном режиме.

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

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

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

Данные обновлены, права соблюдены

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

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

Перед изменением рабочей базы протестируйте серверную процедуру на копии или в обучающей базе. Это исключает случайную блокировку или порчу данных.

Альтернативы и оптимизация

Если операция не требует общей базы, оставьте её на клиенте: это сократит сетевые вызовы и ускорит ответ интерфейса. Для фоновой обработки используйте задания или расписание, а не интерактивный серверный вызов.

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

Клиентский код

Для интерфейса и локальных расчётов, без доступа к общей базе

Серверный вызов

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

Фоновое задание

Для долгих расчётов, чтобы не блокировать интерактивный сеанс

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

Выбор между толстым, тонким и веб-клиентом влияет на комфорт отладки, но не меняет суть серверного вызова: код по-прежнему выполняется на сервере приложений.

Итог

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

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

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

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

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

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

Что делать, если серверный вызов работает медленно?

Проверьте частоту вызовов, объём передаваемых данных и индексы базы.