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

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

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

Что такое общий модуль и когда его вызывают

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

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

Базовый синтаксис обращения к общему модулю

Вызов выполняется по имени модуля, как оно задано в конфигураторе, без кавычек и без обращения к метаданным:

// Вызов функции с результатом
СуммаНДС = РаботаСДеньгами.РассчитатьНДС(СуммаДокумента, СтавкаНДС);

// Вызов процедуры без возврата значения
Журналирование.ЗаписатьСобытие("Проведение", СсылкаНаДокумент);

// Вызов без параметров
ВерсияКонфигурации = ОбщегоНазначения.ВерсияПрограммы();

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

Результат = ИмяОбщегоМодуля.ИмяЭкспортнойФункции(Параметр1, Параметр2);

Как сделать процедуру доступной для вызова

Чтобы метод можно было вызвать извне, в теле общего модуля он объявляется так:

Функция РассчитатьНДС(Сумма, Ставка) Экспорт
Возврат Сумма * Ставка / (100 + Ставка);
КонецФункции

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

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

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

Клиентский и серверный контексты: главное ограничение

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

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

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

Привилегированный режим и безопасность

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

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

Типичные ошибки при обращении и их диагностика

Большинство проблем при вызове общих модулей распознаётся по тексту ошибки платформы. Сопоставление симптома и причины ускоряет исправление:

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

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

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

FAQ: частые вопросы об общих модулях