Как правильно получить макет из внешней печатной формы, если в конфигурации есть дубль?

← На главную

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

Причина возникновения проблемы

Основная причина кроется в контексте выполнения кода. Когда вы вызываете метод ПолучитьМакет() без указания конкретного объекта, система пытается найти макет в текущем контексте исполнения. Если в конфигурации имеется объект с аналогичным именем или если вызов происходит из глобального контекста, платформа выбирает приоритетный объект из состава конфигурации. Чтобы избежать этой путаницы, необходимо явно указывать, к какому экземпляру объекта обработки мы обращаемся.

Решение 1: Использование свойства ЭтотОбъект в модуле объекта

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

Рассмотрим пример правильного вызова:


// В модуле объекта внешней обработки
Процедура Печать() Экспорт
    // Явное указание на текущий экземпляр обработки
    Макет = ЭтотОбъект.ПолучитьМакет("ИмяВашегоМакета");
    // Дальнейшая работа с макетом...
КонецПроцедуры

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

Решение 2: Получение объекта из реквизита формы

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

Выполним это в несколько шагов:

Убедитесь, что у вашей обработки в форме назначен основной реквизит, имеющий тип ВнешняяОбработкаОбъект.
В серверной процедуре используйте метод РеквизитФормыВЗначение, чтобы извлечь объект.

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


&НаСервере
Процедура ПолучитьМакетНаСервере()
    // Извлекаем объект из реквизита формы с именем "Объект"
    ОбработкаОбъект = РеквизитФормыВЗначение("Объект");
    
    // Теперь вызываем метод макета у полученного объекта
    Макет = ОбработкаОбъект.ПолучитьМакет("ИмяВашегоМакета");
КонецПроцедуры

Важно помнить, что РеквизитФормыВЗначение создает копию объекта на сервере, что дает нам доступ к методам, отсутствующим у элементов формы напрямую.

Решение 3: Программное создание объекта через ВнешниеОбработки.Создать

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

Пример использования менеджера внешних обработок:


// Создаем объект по пути к файлу
ВнешняяОбработка = ВнешниеОбработки.Создать("C:\МоиОбработки\УниверсальныйПередаточныйДокумент.epf");

// Получаем макет из созданного экземпляра
Макет = ВнешняяОбработка.ПолучитьМакет("ИмяВашегоМакета");

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

Подведем итог

Для корректной работы с макетами во внешних печатных формах придерживайтесь следующих правил:

Никогда не вызывайте ПолучитьМакет() без уточняющего объекта, если имя макета не является уникальным в масштабах всей конфигурации.
В модулях объекта всегда используйте ЭтотОбъект.ПолучитьМакет().
В модулях форм всегда переходите от реквизита к объекту через РеквизитФормыВЗначение("ИмяРеквизита").
При программном вызове используйте ВнешниеОбработки.Создать() для формирования контекста.

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