Как вызвать функцию из общего модуля в 1С

Общий модуль в 1С — это контейнер для процедур и функций, которые должны быть доступны из разных объектов конфигурации: документов, справочников, отчётов, обработок. Чтобы вызвать функцию из общего модуля, достаточно написать имя модуля, точку и имя функции: МойМодуль.МояФункция(Параметр). Никакого создания экземпляра или подключения не требуется — платформа разрешает обращение автоматически, если модуль и функция правильно настроены.

Главные условия успешного вызова — экспортная функция (ключевое слово Экспорт после объявления) и корректно выставленные флаги контекста исполнения модуля: «Сервер», «Клиент (обычное приложение)», «Клиент (управляемое приложение)», «Внешнее соединение». Если контекст вызова не совпадает с контекстом модуля, вы получите ошибку «Процедура или функция с указанным именем не определена».

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

Что такое общий модуль и когда выносить в него функции

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

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

Общие модули принято группировать по смыслу и называть с суффиксами, отражающими контекст: РаботаСоСтроками, РасчетыСервер, ИнтерфейсКлиент. Суффиксы «Сервер», «Клиент», «ВызовСервера» помогают сразу понять, где исполняется код, и избежать ошибок с контекстом.

Как подготовить общий модуль к вызову

Откройте конфигуратор, найдите в дереве конфигурации ветку «Общие» → «Общие модули» и создайте новый модуль или откройте существующий. В палитре свойств модуля установите флаги контекста. Для серверной логики включите «Сервер»; для кода, выполняемого на клиенте, — «Клиент (управляемое приложение)». Флаг «Вызов сервера» включайте только у клиентских модулей, которые должны вызываться с сервера, — это редкий сценарий.

Объявите функцию с ключевым словом Экспорт. Без него функция остаётся приватной и доступна только внутри самого модуля — попытка вызова снаружи завершится ошибкой компиляции.

Функция РассчитатьСуммуСНДС(Сумма, СтавкаНДС) Экспорт

Если СтавкаНДС = 0 Тогда
Возврат Сумма;
КонецЕсли;

Возврат Сумма + Сумма * СтавкаНДС / 100;

КонецФункции

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

1. 1
   Создайте общий модуль: Конфигурация → Общие → Общие модули → Добавить
2. 2
   В свойствах модуля включите нужные флаги контекста (Сервер и/или Клиент)
3. 3
   Напишите функцию с ключевым словом Экспорт
4. 4
   Сохраните конфигурацию и обновите конфигурацию базы данных (F7)
5. 5
   Вызовите функцию по схеме ИмяМодуля.ИмяФункции(Параметры) и проверьте результат

Синтаксис вызова функции

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

// Присвоение результата переменной
ИтоговаяСумма = РасчетыСервер.РассчитатьСуммуСНДС(10000, 20);

// Использование в выражении
Если РасчетыСервер.РассчитатьСуммуСНДС(СуммаДокумента, 20) > Лимит Тогда
Сообщить("Превышен лимит");
КонецЕсли;

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

Если у функции есть параметры со значениями по умолчанию (Параметр = Неопределено), необязательные параметры можно опускать, но пропускать параметр в середине списка нельзя — можно только не указывать хвостовые.

Результат = РасчетыСервер.РассчитатьСуммуСНДС(СуммаДокумента, 20);

Вызов с клиента и с сервера: в чём разница

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

Вызов серверной функции из клиентского обработчика

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

&НаКлиенте
Процедура Пересчитать(Команда)
Итог = ПересчитатьНаСервере(Сумма);
КонецПроцедуры

&НаСервереБезКонтекста
Функция ПересчитатьНаСервере(Сумма)
Возврат РасчетыСервер.РассчитатьСуммуСНДС(Сумма, 20);
КонецФункции

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

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

После внедрения вызова проверьте три вещи: функция компилируется без ошибок, возвращает ожидаемое значение на контрольных данных и корректно обрабатывает граничные случаи (пустые параметры, Неопределено, нулевые суммы). Быстрая проверка — временный вызов из обработчика команды или через консоль кода с выводом результата через Сообщить().

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

Типичные ошибки и ограничения

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

Вторая группа проблем — производительность. Клиент-серверные вызовы в цикле (например, обращение к серверному общему модулю при обходе тысячи строк таблицы) резко замедляют работу. Решение — вынести весь цикл на сервер и вызывать его один раз, передав массив или таблицу значений.

Третья группа — избыточная компиляция. Общие модули с флагом «Клиент (управляемое приложение)» компилируются при запуске каждого сеанса; большое количество тяжёлых клиентских модулей увеличивает время старта. По возможности переносите логику на сервер и используйте модули с повторным использованием возвращаемых значений («На время вызова» или «На время сеанса») для функций, которые часто запрашивают одни и те же данные.

Когда выбрать другой подход

Общий модуль — не единственный способ переиспользовать код. Если логика относится к одному объекту, используйте модуль объекта или модуль менеджера: функции модуля менеджера вызываются как Справочники.Номенклатура.ИмяФункции(), и это семантически точнее для операций над конкретным типом данных.

Для кода, завязанного на форму, подходят команды формы и серверные процедуры формы. Для интеграционных сценариев, где нужен доступ извне, рассмотрите HTTP-сервисы вместо общих модулей. Общий модуль остаётся оптимальным выбором именно для прикладной логики, общей для нескольких объектов конфигурации.

Частые вопросы