Как исправить ошибку Переменная не определена при вызове общего модуля из расширения в 1С

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

Разберем подробно, почему возникает такое поведение платформы, как устроен контекст синтаксической проверки и какими способами можно избавиться от этой ошибки при разработке внутри расширения и во внешних обработках.

Причины возникновения ошибки в Конфигураторе

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

1. Рассинхронизация кэша метаданных расширения: если вызов происходит внутри объектов самого расширения (в добавленной форме, команде или другом общем модуле расширения), ошибка проверки возникает из-за того, что дерево метаданных расширения еще не зафиксировано в структуре информационной базы. Пока изменения расширения не применены, статический анализатор Конфигуратора не видит вновь добавленные модули в общем контексте.
2. Изоляция контекста внешних отчетов и обработок: внешние файлы (.epf и .erf) не имеют постоянной привязки к конкретному расширению. Синтаксический контроль внешнего файла опирается строго на состав метаданных основной конфигурации. Любые модули, созданные только в расширениях, отсутствуют в глобальном контексте внешнего файла при его редактировании в Конфигураторе.

Способ 1. Обновление конфигурации базы данных и перезапуск сеанса

Если ошибка «Переменная не определена» появляется при проверке модулей внутри самого расширения, выполним простую последовательность действий для обновления метаданных:

1. Сохраним все открытые модули расширения.
2. Применим изменения расширения к базе данных (команда «Обновить конфигурацию базы данных» или клавиша F7).
3. Если после сохранения синтаксический контроль продолжает выдавать ошибку, закроем и снова откроем Конфигуратор для полной очистки внутреннего кэша контекста метаданных.

После перезапуска сеанса Конфигуратор подтягивает актуальный состав объектов расширения, и проверка синтаксиса проходит штатно.

Способ 2. Динамическое обращение к модулю через Библиотеку стандартных подсистем (БСП)

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

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

// Получаем ссылку на общий модуль динамически по имени
МодульРасширения = ОбщегоНазначения.ОбщийМодуль("ОбщегоНазначенияСерверДобавленный");

// Вызываем требуемую экспортную функцию
Результат = МодульРасширения.ВыполнитьДействие(Параметр1, Параметр2);

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

Способ 3. Вызов через функции Вычислить() и Выполнить()

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

Посмотрим на пример вызова функции:

ИмяФункции = "ОбщегоНазначенияСерверДобавленный.РассчитатьСумму(Параметр1, Параметр2)";
Результат = Вычислить(ИмяФункции);

Если требуется вызвать процедуру, не возвращающую значение, используем оператор Выполнить:

ТекстКоманды = "ОбщегоНазначенияСерверДобавленный.ЗаполнитьДанные(ОбъектОбработки);";
Выполнить(ТекстКоманды);

При таком способе имя модуля проверяется исключительно в момент исполнения на стороне сервера, что предотвращает ошибки синтаксического анализатора при редактировании внешней обработки.

Способ 4. Включение обработки в состав расширения

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

1. Обработка становится полноправным объектом метаданных расширения.
2. Все добавленные общие модули расширения становятся доступны напрямую по имени без использования динамических вызовов.
3. Конфигуратор обеспечивает полноценное автодополнение кода и переход к определениям процедур по клавише F12.

Способ 5. Настройка параметров синтаксической проверки

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

1. Откроем главное меню: «Сервис» → «Параметры».
2. Перейдем на вкладку «Модули» в раздел «Проверка».
3. Отключим флаг автоматической проверки синтаксиса при сохранении модулей.

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