Как обратиться к процедуре общего модуля в 1С

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

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

Сложности возникают не из-за синтаксиса, а из-за контекста исполнения: клиентская процедура не может напрямую обратиться к серверному модулю без флага «Вызов сервера», а попытка вызвать неэкспортную процедуру или модуль с неверными флагами приводит к ошибкам компиляции. Ниже разобраны все условия, примеры и типичные проблемы.

Синтаксис обращения к процедуре общего модуля

Базовый вызов выглядит так: ИмяОбщегоМодуля.ИмяПроцедуры(Параметр1, Параметр2);. Имя модуля указывается так, как оно задано в дереве конфигурации в ветке «Общие» → «Общие модули». Пробелы и кириллица в именах допустимы, но на практике удобнее использовать имена без пробелов, чтобы код читался единообразно.

Если вызывается функция, её результат можно присвоить переменной или использовать в выражении: Результат = РаботаСоСтроками.УбратьЛишниеПробелы(ИсходнаяСтрока);. Если функция вызвана как процедура (без присвоения результата), платформа выдаст ошибку — встроенный язык требует использовать возвращаемое значение либо оформлять метод именно как процедуру.

Параметры передаются по позиции в том порядке, в котором объявлены в заголовке процедуры. Пропущенные необязательные параметры в середине списка обозначаются запятыми: Модуль.Процедура(Параметр1, , Параметр3);. Значения по умолчанию подставляются только для параметров, у которых они заданы в объявлении.

// Вызов экспортной процедуры общего модуля
ОбщегоНазначения.СообщитьПользователю("Операция завершена");

// Вызов экспортной функции с результатом
КурсВалюты = РаботаСКурсамиВалют.ПолучитьКурс(Валюта, ТекущаяДатаСеанса());

Какие процедуры доступны извне: роль ключевого слова «Экспорт»

Общий модуль может содержать десятки процедур и функций, но снаружи видны только те, что помечены словом Экспорт после списка параметров: Процедура РассчитатьИтог(Документ) Экспорт. Все остальные методы считаются внутренними и доступны только в пределах самого модуля — это стандартный приём инкапсуляции вспомогательной логики.

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

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

Настройка флагов контекста: Сервер, Клиент, Вызов сервера

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

Модуль с флагом «Сервер» доступен только в серверном контексте. Чтобы клиентская форма могла обратиться к нему, нужно дополнительно установить флаг «Вызов сервера» — тогда платформа разрешит вызов с тонкого клиента, выполняя код на сервере. Без этого флага обращение из клиентского модуля вызовет ошибку компиляции.

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

Вызов серверной процедуры из клиентского кода формы

Самый частый практический сценарий — вызвать серверную процедуру общего модуля из клиентского обработчика формы, например по нажатию кнопки. Прямой вызов возможен, если у модуля стоит «Вызов сервера»: пишете МойМодуль.ВыполнитьРасчет(Параметры); прямо в клиентской процедуре, и платформа сама организует серверный вызов.

При этом действует ограничение на передаваемые параметры: они должны быть сериализуемыми, то есть допустимыми для передачи между клиентом и сервером. Примитивные типы, структуры, массивы, ссылки на объекты передаются свободно. А вот объекты типа ДокументОбъект, Запрос, ТабличныйДокумент или COMОбъект передать нельзя — получите ошибку о недопустимом типе параметра.

Если в клиентском контексте формы нужен серверный вызов без «Вызов сервера» у общего модуля, используют директиву &НаСервере в модуле формы: создают серверную процедуру формы, а уже из неё обращаются к общему модулю. Это чуть длиннее, но даёт контроль над контекстом и позволяет работать с данными формы как с прикладным объектом через РеквизитФормыВЗначение.

1. 1
   Откройте общий модуль в конфигураторе и убедитесь, что нужная процедура объявлена с ключевым словом Экспорт
2. 2
   Проверьте флаги модуля: для вызова из клиентской формы нужны «Сервер» и «Вызов сервера»
3. 3
   В месте вызова напишите ИмяМодуля.ИмяПроцедуры(Параметры) — воспользуйтесь Ctrl+Пробел для подсказки состава модулей
4. 4
   Убедитесь, что передаваемые параметры допустимы для передачи между клиентом и сервером
5. 5
   Обновите конфигурацию базы данных и проверьте вызов в режиме предприятия
6. 6
   Выполните синтаксическую проверку модулей (Конфигурация — Проверка конфигурации), чтобы поймать ошибки до запуска

Обращение из других общих модулей и объектов конфигурации

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

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

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

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

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

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

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

Как проверить, что вызов работает правильно

Первый уровень проверки — синтаксический контроль: в конфигураторе меню «Конфигурация» → «Проверка конфигурации» с включённой проверкой модулей. Она выявит несуществующие имена, неверное число параметров и конфликты контекстов ещё до запуска базы.

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

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

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