При разработке расширений для типовых конфигураций, таких как «Бухгалтерия предприятия 3.0», разработчики часто сталкиваются с ситуацией, когда код, скопированный из основной конфигурации в расширение, внезапно перестает работать. Одной из самых коварных ошибок является сообщение Переменная не определена, указывающее на имя общего модуля (например, УправлениеПечатью). Рассмотрим подробно, почему это происходит и как правильно адаптировать код расширения, чтобы избежать подобных проблем.
Для начала проанализируем ситуацию. Ошибка чаще всего проявляется в модулях менеджера или модулях объектов. В нашем случае проблема возникла в модуле менеджера документа при попытке переопределить процедуру печати. Почему же платформа «теряет» общий модуль, который в основной конфигурации виден прекрасно?
Ключ к разгадке кроется в особенностях компиляции модулей менеджера. В системе 1С:Предприятие 8.3 модуль менеджера компилируется в нескольких контекстах одновременно: на стороне сервера и на стороне клиента (например, для проверки доступности команд печати). Если общий модуль, к которому мы обращаемся (в нашем примере УправлениеПечатью), имеет в своих свойствах флажки только «Сервер» и «Внешнее соединение», то при попытке компиляции модуля менеджера для «Тонкого клиента» платформа не находит этот модуль. В основной конфигурации это поведение может быть неявно обработано, но в расширениях проверка синтаксиса и связей объектов работает более строго.
Это самый правильный и надежный способ решения проблемы. Нам необходимо явно указать платформе, что обращение к общему модулю должно происходить только в тех контекстах, где этот модуль физически существует. Проанализируем, как должен выглядеть исправленный код в расширении.
Вместо прямого вызова функции, обернем наш код в инструкции препроцессора. Это гарантирует, что клиентская часть модуля менеджера просто «проигнорирует» этот кусок кода при компиляции, и ошибка исчезнет.
&Вместо("ПечатьОС15")
Функция Расш_ПечатьОС15(МассивОбъектов, ОбъектыПечати, ПараметрыПечати)
#Если Сервер Или ТолстыйКлиентУправляемоеПриложение Или ВнешнееСоединение Тогда
// Здесь идет ваш основной код, скопированный из типовой конфигурации
// Например, получение макета:
Макет = УправлениеПечатью.МакетПечатнойФормы("Документ.ПередачаОборудованияВМонтаж.ПФ_MXL_ОС15");
// ... остальная логика формирования печатной формы ...
#КонецЕсли
КонецФункции
Важно помнить, что если вы используете &Вместо, вы должны обеспечить возврат ожидаемого типа значения (например, Табличного документа), иначе вызывающий код может упасть с другой ошибкой. Поэтому структура функции должна предусматривать инициализацию возвращаемого значения вне блоков препроцессора.
Выясним еще одну причину, которая часто всплывает в релизах БП 3.0 после обновлений. У каждого расширения в дереве конфигурации есть свойство «Безопасный режим». Если этот флажок установлен (а по умолчанию это так), расширение работает в ограниченном окружении.
Посмотрим, как это влияет на работу: в безопасном режиме расширение может быть ограничено в доступе к некоторым серверным процедурам и общим модулям основной конфигурации, особенно если в системе настроены профили безопасности. Если метод препроцессора из первого решения не помог, попробуйте выполнить следующие действия:
Иногда платформа (особенно версий 8.3.13, 8.3.14) демонстрирует странное поведение: она перестает видеть даже глобальные общие модули из расширения. Рассмотрим методику «явного указания». Хотя автор вопроса хотел избежать заимствования лишних объектов, в некоторых случаях это единственный стабильный путь.
Нам не нужно переносить весь код модуля. Достаточно просто добавить общий модуль УправлениеПечатью в расширение. При этом сам модуль в расширении останется абсолютно пустым. Сам факт наличия объекта с таким именем в составе расширения заставляет компилятор корректно сопоставлять ссылки на него в других модулях расширения. Это помогает «пробросить» видимость модуля во все контексты компиляции.
При обновлении конфигурации часто меняется её режим совместимости. Если ваше расширение было создано давно, его собственный режим совместимости может отличаться от режима основной конфигурации. Это критически важно! Выясним, как это проверить:
В свойствах основной конфигурации найдите пункт «Режим совместимости» (например, 8.3.12). Перейдите в свойства расширения и убедитесь, что там установлен либо такой же режим, либо «Не использовать» (что заставит расширение работать в режиме основной конфигурации). Если режимы различаются, механизмы разрешения имен (Resolution) могут работать некорректно, вызывая ошибки Переменная не определена.
Если ни один из стандартных способов не помогает, а решить задачу нужно срочно, можно воспользоваться механизмом динамического исполнения кода. Это позволит обойти проверку синтаксиса на этапе компиляции расширения. Проанализируем этот пример:
// Вместо прямого обращения:
// Макет = УправлениеПечатью.МакетПечатнойФормы("ИмяМакета");
// Используем Вычислить:
ИмяФункции = "УправлениеПечатью.МакетПечатнойФормы";
Макет = Вычислить(ИмяФункции + "(""Документ.ПередачаОборудованияВМонтаж.ПФ_MXL_ОС15"")");
Важное предупреждение: использование Вычислить или Выполнить считается плохим тоном в разработке на платформе 1С. Это затрудняет отладку, делает код «нечитаемым» для синтакс-помощника и может привести к трудноуловимым ошибкам при изменении параметров функции в будущих релизах. Используйте этот метод только в самом крайнем случае, когда все остальные способы исчерпаны.
Подведем итог нашему исследованию. В 90% случаев проблема вызова общего модуля из расширения решается установкой правильного контекста. Посмотрим на контрольный список действий при возникновении ошибки Переменная не определена:
#Если Сервер Тогда.Соблюдение этих правил позволит вам создавать стабильные расширения, которые не будут ломаться при очередном обновлении типовой конфигурации 1С:Бухгалтерия.