Как получить макет в управляемой форме 1С

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

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

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

Где физически хранится макет и какие виды бывают

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

Макет, созданный внутри документа «РеализацияТоваровУслуг», доступен через менеджер этого документа. Макет из общей ветки доступен глобально через ПолучитьОбщийМакет(). Макет внешней обработки получают через объект обработки после её подключения.

Тип макета тоже влияет на результат: табличный документ, текстовый документ, макет СКД, макет оформления компоновки, двоичные данные, ActiveDocument. Метод ПолучитьМакет() вернёт значение того типа, который задан в конфигураторе, — приводить его вручную не нужно.

Базовый синтаксис: ПолучитьМакет на сервере

Стандартный вызов из кода формы выглядит так: сначала серверная функция, которая обращается к менеджеру объекта, затем клиентский обработчик, который её вызывает и работает с результатом.

&НаСервере
Функция ПолучитьМакетПечатиНаСервере()
Возврат Документы.РеализацияТоваровУслуг.ПолучитьМакет("МакетПечати");
КонецФункции

&НаКлиенте
Процедура Печать(Команда)
ТабДок = ПолучитьМакетПечатиНаСервере();
ТабДок.Показать("Печать документа");
КонецПроцедуры

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

Если код находится в модуле объекта или модуле менеджера, директивы компиляции не нужны — там весь код серверный, и ПолучитьМакет("ИмяМакета") вызывается напрямую, без указания менеджера.

&НаСервере
Функция ПолучитьМакетПечатиНаСервере()
    Возврат Документы.РеализацияТоваровУслуг.ПолучитьМакет("МакетПечати");
КонецФункции

Получение общего макета конфигурации

Общие макеты хранятся в ветке «Общие → Макеты» и не привязаны к конкретному объекту. Для них используется глобальный метод ПолучитьОбщийМакет("ИмяМакета"). Он тоже доступен только на сервере и в толстом клиенте.

&НаСервере
Функция ПолучитьОбщийМакетНаСервере()
Возврат ПолучитьОбщийМакет("ШаблонПисьма");
КонецФункции

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

Проверить имя макета можно в конфигураторе: откройте ветку «Общие → Макеты» и сверьте имя точно, с учётом регистра не важен, но лишние пробелы и опечатки приведут к ошибке «Макет не найден».

Макет внешней обработки или отчёта

У внешних обработок макеты хранятся внутри epf-файла. Чтобы их получить, сначала нужно получить объект обработки через ВнешниеОбработки.Создать(ИмяФайла), а затем вызвать у него ПолучитьМакет():

&НаСервере
Функция ПолучитьМакетВнешнейОбработки(ИмяФайла)
Обработка = ВнешниеОбработки.Создать(ИмяФайла, Ложь);
Возврат Обработка.ПолучитьМакет("МакетДанных");
КонецФункции

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

Получение макета из формы объекта: типовой сценарий печати

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

1. 1
   Создайте макет типа «Табличный документ» в ветке «Макеты» нужного документа в конфигураторе
2. 2
   Разметьте области (Шапка, Строка, Подвал) и задайте параметры в ячейках
3. 3
   В форме документа добавьте команду и клиентский обработчик
4. 4
   В серверной функции получите макет через Документы.Имя.ПолучитьМакет(), заполните области и верните табличный документ
5. 5
   На клиенте вызовите Показать() или откройте форму печати БСП

&НаСервере
Функция СформироватьПечатнуюФорму(Ссылка)
Макет = Документы.РеализацияТоваровУслуг.ПолучитьМакет("МакетПечати");
ТабДок = Новый ТабличныйДокумент;

ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
ОбластьШапка.Параметры.НомерДокумента = Ссылка.Номер;
ТабДок.Вывести(ОбластьШапка);

Возврат ТабДок;
КонецФункции

Если в конфигурации внедрена Библиотека стандартных подсистем, предпочтительнее регистрировать печатную форму через механизм «Управление печатью» — тогда макет получается внутри процедуры Печать() модуля менеджера, а форма документа получает кнопку автоматически.

Макет как реквизит формы и работа без серверного вызова

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

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Макет = ПолучитьОбщийМакет("ИнструкцияПользователя");
РеквизитПредпросмотр.Очистить();
РеквизитПредпросмотр.Вывести(Макет);
КонецПроцедуры

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

Проверка результата и типичные ошибки

После вызова убедитесь, что макет реально получен и содержит нужные области. Простейшая проверка — попытка получить область: если макет не найден, ошибка возникнет уже на этапе ПолучитьМакет(), если области нет — на ПолучитьОбласть().

FAQ