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