Вызов сервера в 1С: общие модули и контексты выполнения

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

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

Контексты выполнения кода в 1С

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

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

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

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

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

Серверный контекст

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

Серверный контекст используют для:

• Массовой обработки данных — обход больших выборок, групповые изменения
• Проведения документов — расчёт движений, проверка остатков
• Выполнения запросов к базе данных
• Операций, требующих транзакционной целостности
• Логики, которая не должна зависеть от клиентского окружения

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

Где выполняется модуль приложения

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

Модуль	Контекст в управляемых формах	Контекст в обычных формах
Модуль приложения	Клиент	Сервер
Модуль внешнего соединения	Сервер	Сервер
Модуль сеанса	Сервер	Сервер
Модуль управляемой формы (без директив)	Клиент	—
Модуль объекта (документ, справочник)	Сервер	Сервер

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

Общие модули: типы и назначение

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

Серверный модуль

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

Пример серверного модуля: ОбщегоНазначения в типовых конфигурациях. В нём функции для работы с запросами, обходом данных, изменением реквизитов объектов.

Клиентский модуль

Флаг «Клиент» включён — код выполняется на стороне клиента. Клиентский модуль нельзя вызвать из серверного контекста. Используется для работы с интерфейсом, файловой системой пользователя, локальных вычислений.

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

Клиент-серверный модуль

Флаги «Клиент» и «Сервер» включены одновременно. Код модуля может выполняться как на клиенте, так и на сервере, в зависимости от контекста вызова. Если клиентская процедура вызывает функцию из клиент-серверного модуля, функция выполнится на клиенте. Если серверная процедура вызывает ту же функцию — она выполнится на сервере.

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

Пример: СтроковыеФункцииКлиентСервер — функции форматирования строк, разбора подстрок, работы с регулярными выражениями. Они не обращаются к базе данных и одинаково работают везде.

Вызов сервера из общего модуля

Флаг «Вызов сервера» — ключевая настройка для взаимодействия клиента и сервера. Если в клиентском или клиент-серверном модуле этот флаг включён, клиентский код может вызывать процедуры серверного модуля через специальную конструкцию.

Пример: создаём серверный модуль РаботаСДаннымиСервер с флагом «Вызов сервера». В нём процедура:

Процедура ПолучитьДанныеКлиента(Клиент) Экспорт
    Запрос = Новый Запрос;
    Запрос.Текст = "ВЫБРАТЬ ...";
    Запрос.УстановитьПараметр("Клиент", Клиент);
    Результат = Запрос.Выполнить();
    // обработка
КонецПроцедуры

Из клиентского модуля формы вызываем эту процедуру так:

&НаКлиенте
Процедура КнопкаЗагрузитьНажатие(Команда)
    РаботаСДаннымиСервер.ПолучитьДанныеКлиента(Объект.Клиент);
КонецПроцедуры

Платформа видит, что РаботаСДаннымиСервер — это серверный модуль с флагом «Вызов сервера», и автоматически передаёт вызов на сервер. Клиентский код приостанавливается, ждёт выполнения серверной процедуры, затем продолжает работу.

Без флага «Вызов сервера» такой вызов невозможен — платформа выдаст ошибку компиляции. Флаг нужен для защиты: разработчик явно помечает, какие серверные методы можно вызывать с клиента. Это важно для безопасности, потому что клиентский код может быть изменён пользователем через отладчик или внешние инструменты.

Как вызвать серверный код с клиента

Есть несколько способов вызвать серверную логику из клиентского контекста. Выбор зависит от того, нужна ли интерактивность, должен ли клиент ждать результат, как часто происходит вызов.

Прямой вызов через общий модуль

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

Пример: клиентская форма документа, кнопка «Рассчитать». При нажатии нужно выполнить запрос к базе, обработать результат на сервере и вернуть итог клиенту.

// Серверный модуль РасчётыСервер

Функция РассчитатьСумму(Документ) Экспорт
    Запрос = Новый Запрос;
    Запрос.Текст = "ВЫБРАТЬ СУММА(Сумма) ИЗ ...";
    Результат = Запрос.Выполнить().Выбрать();
    Результат.Следующий();
    Возврат Результат.Сумма;
КонецФункции

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

&НаКлиенте
Процедура РассчитатьНажатие(Команда)
    Сумма = РасчётыСервер.РассчитатьСумму(Объект.Ссылка);
    Объект.ИтоговаяСумма = Сумма;
КонецПроцедуры

Клиент вызывает серверную функцию синхронно: пользовательский интерфейс замораживается до получения ответа. Если запрос быстрый (до 1 секунды), это нормально. Если дольше — лучше использовать асинхронный вызов.

Серверная процедура в модуле формы

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

// Модуль управляемой формы

&НаКлиенте
Процедура ПриОткрытии(Отказ)
    ЗагрузитьДанныеНаСервере();
КонецПроцедуры

&НаСервере
Процедура ЗагрузитьДанныеНаСервере()
    Запрос = Новый Запрос;
    // выполнение запроса и заполнение реквизитов формы
КонецПроцедуры

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

Вызов через СерверноеВзаимодействие

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

&НаКлиенте
Процедура ЗапуститьОбработкуНажатие(Команда)
    ИдентификаторЗадания = ЗапуститьОбработкуНаСервере();
    ОжидатьЗавершения(ИдентификаторЗадания);
КонецПроцедуры

&НаСервере
Функция ЗапуститьОбработкуНаСервере()
    Параметры = Новый Массив;
    Параметры.Добавить(Объект.Ссылка);
    Задание = ФоновыеЗадания.Выполнить("Обработки.МассоваяОбработка.Выполнить", Параметры);
    Возврат Задание.УникальныйИдентификатор;
КонецФункции

&НаКлиенте
Процедура ОжидатьЗавершения(ИдентификаторЗадания)
    // периодическая проверка статуса задания
КонецПроцедуры

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

Вызов через веб-сервис или HTTP-сервис

Если нужно вызвать серверную логику из внешней системы или из JavaScript на веб-клиенте, используют HTTP-сервисы. Это REST API, встроенное в 1С. Клиент отправляет HTTP-запрос, сервер 1С выполняет обработку и возвращает JSON.

Пример HTTP-сервиса:

// HTTP-сервис "api", ресурс "clients", метод GET

Функция ClientsGET(Запрос)
    Ответ = Новый HTTPСервисОтвет(200);
    Запрос = Новый Запрос("ВЫБРАТЬ * ИЗ Справочник.Контрагенты");
    Данные = Запрос.Выполнить().Выгрузить();
    Ответ.Заголовки.Вставить("Content-Type", "application/json");
    Ответ.УстановитьТелоИзСтроки(СериализоватьJSON(Данные));
    Возврат Ответ;
КонецФункции

Вызов из JavaScript:

fetch('http://server/base/hs/api/clients')
    .then(response => response.json())
    .then(data => console.log(data));

HTTP-сервисы применяют для интеграции 1С с веб-приложениями, мобильными приложениями, внешними сервисами.

Практические примеры и сценарии

Заполнение табличной части из базы данных

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

// Клиентский модуль формы документа

&НаКлиенте
Процедура КонтрагентПриИзменении(Элемент)
    ЗаполнитьДоговорыНаСервере();
КонецПроцедуры

&НаСервере
Процедура ЗаполнитьДоговорыНаСервере()
    Объект.Договоры.Очистить();

    Запрос = Новый Запрос;
    Запрос.Текст = "
    |ВЫБРАТЬ
    |   Договоры.Ссылка КАК Договор,
    |   Договоры.Сумма КАК Сумма
    |ИЗ
    |   Справочник.ДоговорыКонтрагентов КАК Договоры
    |ГДЕ
    |   Договоры.Контрагент = &Контрагент";

    Запрос.УстановитьПараметр("Контрагент", Объект.Контрагент);

    Выборка = Запрос.Выполнить().Выбрать();
    Пока Выборка.Следующий() Цикл
        НоваяСтрока = Объект.Договоры.Добавить();
        НоваяСтрока.Договор = Выборка.Договор;
        НоваяСтрока.Сумма = Выборка.Сумма;
    КонецЦикла;
КонецПроцедуры

Обработчик КонтрагентПриИзменении выполняется на клиенте (директива &НаКлиенте). Он вызывает серверную процедуру ЗаполнитьДоговорыНаСервере, которая выполняет запрос к базе и заполняет табличную часть. Все операции с данными происходят на сервере, клиент получает только готовый результат.

Проверка остатков перед проведением

Задача: перед проведением документа расхода проверить, достаточно ли товара на складе.

// Модуль документа РасходнаяНакладная

Процедура ОбработкаПроведения(Отказ, РежимПроведения)

    Запрос = Новый Запрос;
    Запрос.Текст = "
    |ВЫБРАТЬ
    |   ОстаткиТоваров.Номенклатура,
    |   ОстаткиТоваров.КоличествоОстаток
    |ИЗ
    |   РегистрНакопления.ОстаткиТоваров.Остатки(&Дата, Склад = &Склад) КАК ОстаткиТоваров";

    Запрос.УстановитьПараметр("Дата", Дата);
    Запрос.УстановитьПараметр("Склад", Склад);

    Остатки = Запрос.Выполнить().Выгрузить();
    Остатки.Индексы.Добавить("Номенклатура");

    Для Каждого Строка Из Товары Цикл
        НайденнаяСтрока = Остатки.Найти(Строка.Номенклатура, "Номенклатура");
        Если НайденнаяСтрока = Неопределено Или НайденнаяСтрока.КоличествоОстаток < Строка.Количество Тогда
            Сообщить("Недостаточно товара: " + Строка.Номенклатура);
            Отказ = Истина;
            Возврат;
        КонецЕсли;
    КонецЦикла;

    // формирование движений

КонецПроцедуры

Модуль объекта (документа, справочника) всегда выполняется на сервере. Процедура ОбработкаПроведения вызывается при проведении документа. Код выполняется на сервере, даже если пользователь проводит документ из клиентской формы.

Получение данных для отчёта

Задача: клиентская форма отчёта с настройками, пользователь нажимает «Сформировать», нужно выполнить запрос на сервере и вывести результат.

// Модуль управляемой формы отчёта

&НаКлиенте
Процедура СформироватьНажатие(Команда)
    СформироватьОтчётНаСервере();
КонецПроцедуры

&НаСервере
Процедура СформироватьОтчётНаСервере()

    ТабличныйДокумент = Новый ТабличныйДокумент;

    Запрос = Новый Запрос;
    Запрос.Текст = "
    |ВЫБРАТЬ
    |   Продажи.Номенклатура,
    |   СУММА(Продажи.Сумма) КАК Сумма
    |ИЗ
    |   РегистрНакопления.Продажи КАК Продажи
    |ГДЕ
    |   Продажи.Период МЕЖДУ &ДатаНачала И &ДатаОкончания
    |СГРУППИРОВАТЬ ПО
    |   Продажи.Номенклатура";

    Запрос.УстановитьПараметр("ДатаНачала", ДатаНачала);
    Запрос.УстановитьПараметр("ДатаОкончания", ДатаОкончания);

    Результат = Запрос.Выполнить();

    // вывод результата в табличный документ

    РезультатОтчёта = ТабличныйДокумент;

КонецПроцедуры

Вся обработка данных происходит на сервере. Клиент отправляет параметры (даты), получает готовый табличный документ. Это быстрее, чем передавать по сети тысячи строк выборки.

Типичные ошибки при работе с вызовом сервера

Ошибка: обращение к базе данных из клиентского контекста

Попытка выполнить запрос или прочитать реквизит объекта в клиентской процедуре приведёт к ошибке компиляции или медленной работе.

&НаКлиенте
Процедура НеправильныйПример(Команда)
    // Ошибка: запрос нельзя выполнить на клиенте
    Запрос = Новый Запрос;
    Запрос.Текст = "ВЫБРАТЬ * ИЗ Справочник.Номенклатура";
    Результат = Запрос.Выполнить(); // платформа выдаст ошибку
КонецПроцедуры

Решение: вынести работу с базой в серверную процедуру.

Ошибка: вызов серверного модуля без флага «Вызов сервера»

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

// Модуль РаботаСДаннымиСервер (флаг "Вызов сервера" НЕ установлен)

Функция ПолучитьДанные() Экспорт
    // серверная логика
КонецФункции

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

&НаКлиенте
Процедура НеправильныйВызов()
    // Ошибка компиляции: модуль недоступен для вызова с клиента
    Данные = РаботаСДаннымиСервер.ПолучитьДанные();
КонецПроцедуры

Решение: установить флаг «Вызов сервера» в свойствах общего модуля.

Ошибка: передача больших объёмов данных между клиентом и сервером

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

&НаСервере
Функция ПолучитьВсеДанные()
    Запрос = Новый Запрос("ВЫБРАТЬ * ИЗ Справочник.Номенклатура");
    Возврат Запрос.Выполнить().Выгрузить(); // 50000 строк
КонецФункции

&НаКлиенте
Процедура ЗагрузитьНажатие(Команда)
    // клиент зависнет на время передачи данных
    Данные = ПолучитьВсеДанные();
КонецПроцедуры

Решение: обрабатывать данные на сервере, возвращать клиенту только итоги или страницы данных.

Ошибка: попытка изменить интерфейс из серверной процедуры

Серверный код не имеет доступа к элементам формы. Попытка изменить свойство элемента формы на сервере вызовет ошибку.

&НаСервере
Процедура ИзменитьДоступность()
    // Ошибка: элементы формы недоступны на сервере
    Элементы.КнопкаЗаполнить.Доступность = Ложь;
КонецПроцедуры

Решение: вернуть из серверной процедуры флаг или результат, на клиенте изменить интерфейс.

&НаСервере
Функция ПроверитьУсловие()
    // серверная логика
    Возврат Истина;
КонецФункции

&НаКлиенте
Процедура ПроверитьНажатие(Команда)
    Результат = ПроверитьУсловие();
    Если Результат Тогда
        Элементы.КнопкаЗаполнить.Доступность = Ложь;
    КонецЕсли;
КонецПроцедуры

Влияние архитектуры на выбор серверного оборудования

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

Для типовых конфигураций 1С с 10-50 пользователями рекомендуют серверы с 8-16 ядрами процессора и 32-64 ГБ оперативной памяти. Если конфигурация сильно доработана, используются сложные запросы, интеграции с внешними системами — потребность в ресурсах выше.

В высоконагруженных системах (100+ пользователей, большие объёмы данных) применяют кластеры серверов 1С. Центральный сервер управляет распределением нагрузки, рабочие серверные платформы обрабатывают клиентские запросы. СУБД может размещаться на отдельном мощном сервере с быстрыми дисками (SSD NVMe) и большим объёмом памяти.

Современные серверные процессоры — Intel Xeon Scalable, AMD EPYC — обеспечивают высокую производительность на ядро, что важно для 1С. Платформа использует многопоточность, но каждый запрос пользователя обрабатывается в одном потоке. Поэтому важна не только общая мощность процессора, но и производительность одного ядра.

Часто задаваемые вопросы