Как получить общий макет в 1С 8

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

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

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

Что такое общий макет и когда он нужен

Общий макет — это объект конфигурации, расположенный в дереве метаданных по пути «Общие» → «Общие макеты». Внутри макета может храниться табличный документ, текст, схема компоновки данных, макет оформления, двоичные данные, HTML-документ, географическая схема, графическая схема или ActiveDocument.

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

Как создать общий макет в конфигураторе

Откройте конфигуратор, разверните ветку «Общие» и найдите пункт «Общие макеты». Через контекстное меню выберите «Добавить». В конструкторе макета задайте имя (например, МакетПечатиСчета) и выберите тип макета — чаще всего это «Табличный документ».

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

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

1. 1
   Откройте конфигуратор, ветка «Общие» → «Общие макеты» → «Добавить»
2. 2
   Задайте имя макета и выберите тип (например, «Табличный документ»)
3. 3
   Создайте именованные области и задайте параметры в ячейках
4. 4
   Обновите конфигурацию базы данных (F7)
5. 5
   В коде вызовите ПолучитьОбщийМакет("ИмяМакета") и проверьте результат

Как получить общий макет программно

Базовый вызов выглядит так: Макет = ПолучитьОбщийМакет("МакетПечатиСчета");. Метод возвращает объект того типа, который был выбран при создании макета, — чаще всего ТабличныйДокумент. Дальше из макета получают области, заполняют параметры и выводят в итоговый табличный документ.

Типовой фрагмент формирования печатной формы на основе общего макета:

Функция СформироватьПечатнуюФорму(СсылкаНаДокумент) Экспорт

Макет = ПолучитьОбщийМакет("МакетПечатиСчета");
ТабДок = Новый ТабличныйДокумент;

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

ОбластьСтрока = Макет.ПолучитьОбласть("Строка");
Для Каждого СтрокаТовара Из СсылкаНаДокумент.Товары Цикл
ОбластьСтрока.Параметры.Заполнить(СтрокаТовара);
ТабДок.Вывести(ОбластьСтрока);
КонецЦикла;

Возврат ТабДок;

КонецФункции

Обратите внимание: метод ПолучитьОбласть() каждый раз возвращает новую область, поэтому в цикле её можно получать один раз до цикла, а параметры заполнять на каждой итерации. Для заполнения параметров по совпадающим именам удобен метод Параметры.Заполнить().

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

Получение макета на клиенте и на сервере

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

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

Во внешнем соединении (COM, HTTP-сервисы, веб-сервисы) общий макет получается так же — методом ПолучитьОбщийМакет() в контексте сервера. Ограничений здесь нет, но помните, что табличный документ нельзя напрямую сериализовать в JSON или XML: наружу передают готовый файл (PDF, MXL, HTML) или двоичные данные.

Работа с разными типами общих макетов

Тип возвращаемого значения зависит от вида макета. Табличный документ используют для печатных форм, текстовый документ — для шаблонов писем и скриптов, схему компоновки данных — для программно формируемых отчётов, двоичные данные — для хранения файлов (например, шаблона Excel).

Для макета типа «Двоичные данные» типичный приём — сохранить файл во временный каталог и открыть его прикладной программой: ДвоичныеДанные = ПолучитьОбщийМакет("ШаблонExcel"); ДвоичныеДанные.Записать(ИмяВременногоФайла);. Для макета типа «Схема компоновки данных» полученную схему передают в КомпоновщикМакетаКомпоновкиДанных вместе с настройками.

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

Типичные ошибки и их устранение

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

Вторая частая ситуация — попытка получить несуществующую область: Макет.ПолучитьОбласть("Шапка") вызывает ошибку, если области «Шапка» в макете нет или имя задано с пробелом. Проверяйте имена областей в самом макете через свойства выделенного диапазона.

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

Как проверить результат

Минимальная проверка — вывести сформированный табличный документ на экран и убедиться, что все области присутствуют, параметры заполнены, а пустые значения не оставили «дырок» в печатной форме. Для отладки удобно временно вывести макет целиком, без заполнения, чтобы увидеть структуру областей.

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

FAQ