Как проверить наличие экспортных процедур общего модуля в 1С?

← На главную

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

Почему локальный синтаксический контроль модуля формы не видит ошибку

Когда мы запускаем синтаксический контроль для отдельного модуля формы (например, сочетанием клавиш Ctrl + F7), платформа 1С выполняет только локальную проверку синтаксиса встроенного языка внутри данного конкретного текста. Выясним основные причины такого поведения:

Локальность проверки: Платформа контролирует существование глобального имени общего модуля в метаданных, но связь вызовов с конкретными процедурами неглобальных общих модулей в момент локальной проверки модуля формы не валидируется.
Динамическое связывание: Резолвинг и связывание методов неглобальных общих модулей выполняются платформой при компиляции всего контекста и исполнении кода в соответствующем сеансе.
Отсутствие штатного API рефлексии: В встроенном языке 1С отсутствует встроенный механизм рефлексии (Reflection). Мы не можем средствами языка программно прочитать список объявленных процедур объекта Метаданные.ОбщиеМодули во время выполнения, так как объекты метаданных хранят лишь общие свойства модуля (имя, флаги контекста компиляции), но не структуру внутреннего текста.

Способ 1. Полная проверка конфигурации в режиме «Конфигуратор»

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

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

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

Способ 2. Программный динамический вызов с обработкой исключений

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

Рассмотрим пример кода для клиентского или серверного модуля:


ИмяМодуля = "ОбщегоНазначенияКлиент";
ИмяМетода = "ОбновитьИнтерфейс";

// Проверяем существование самого общего модуля в метаданных
Если Метаданные.ОбщиеМодули.Найти(ИмяМодуля) <> Неопределено Тогда
    
    // Формируем безопасный динамический код
    ТекстТрансляции = 
        "Попытка
        |   " + ИмяМодуля + "." + ИмяМетода + "();
        |Исключение
        |   ВызватьИсключение;
        |КонецПопытки;";
        
    Попытка
        Выполнить(ТекстТрансляции);
        Сообщить("Процедура успешно выполнена.");
    Исключение
        Сообщить("Метод " + ИмяМетода + " не найден или при его выполнении произошла ошибка: " + ОписаниеОшибки());
    КонецПопытки;
    
КонецЕсли;

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

Способ 3. Использование современных средств разработки и статического анализа

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

1C:EDT (Enterprise Development Tool): Среда разработки на базе Eclipse строит индекс всего проекта в фоновом режиме. При вызове несуществующей экспортной процедуры в модуле формы EDT мгновенно подсветит ошибку красным подчеркиванием еще в процессе ввода текста.
Статические анализаторы (BSL Language Server, SonarQube): Инструменты статического анализа проверяют абстрактное синтаксическое дерево (AST) выгруженных исходных файлов конфигурации. Они автоматически находят межмодульные расхождения при сборке проекта на серверах непрерывной интеграции (CI/CD).

Распространенные причины, почему экспортная процедура не видна платформе

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

Отсутствует ключевое слово Экспорт: В заголовке процедуры общего модуля забудут указать ключевое слово (например, написано Процедура МояПроцедура() вместо Процедура МояПроцедура() Экспорт).
Неверные флаги контекста общего модуля: Вызов производится из модуля формы на клиенте, но у общего модуля в свойствах не взведен флажок «Клиент (управляемое приложение)» или «Вызов сервера» (если метод серверный и вызывается с клиента напрямую).
Ограничения инструкциями препроцессора: Текст процедуры в общем модуле обрамлен директивами препроцессора, например:
```
#Если Сервер Тогда
Процедура ВыполнитьРасчет() Экспорт
    // Серверный код
КонецПроцедуры
#КонецЕсли
```
Если попытаться вызвать метод ВыполнитьРасчет() в контексте тонкого клиента напрямую, платформа сообщат об отсутствии данной процедуры.

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