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