Как получить общий макет в 1С: пошаговое руководство

Общий макет в 1С — это шаблон, хранящийся на уровне всей конфигурации, а не отдельного объекта. К нему можно обратиться из любого модуля: общего, формы, документа или отчёта. Чаще всего общие макеты используют для печатных форм, схем компоновки данных, двоичных файлов (например, шаблонов Excel или Word) и текстовых заготовок.

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

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

Что такое общий макет и когда его применять

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

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

Типовые сценарии применения: фирменный бланк для всех печатных форм, единый макет этикетки, XSD-схема для обмена данными, шаблон договора в формате Word, встроенный в конфигурацию как двоичные данные.

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

Откройте конфигуратор и разверните дерево конфигурации (меню «Конфигурация» → «Открыть конфигурацию» или «Открыть конфигурацию базы данных», если изменения ещё не применены). Найдите ветку «Общие» и раскройте её — внутри находится узел «Общие макеты».

Двойной щелчок по макету открывает его редактор: для табличного документа — табличный редактор с областями и параметрами, для схемы компоновки — конструктор СКД, для двоичных данных — просмотр с возможностью загрузки файла. Изменения сохраняются стандартно: «Конфигурация» → «Сохранить конфигурацию», а для применения в базе — «Обновить конфигурацию базы данных».

1. 1
   Откройте конфигуратор и дерево конфигурации
2. 2
   Раскройте ветку «Общие» → «Общие макеты»
3. 3
   Найдите нужный макет по имени или создайте новый через «Добавить»
4. 4
   Откройте макет двойным щелчком, отредактируйте и сохраните
5. 5
   Обновите конфигурацию базы данных и проверьте результат в режиме Предприятие

Если макета нет в списке, убедитесь, что вы смотрите именно ветку «Общие макеты», а не макеты конкретного объекта — у документов, справочников и отчётов есть собственные макеты, и визуально ветки похожи.

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

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

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

Тип возвращаемого значения зависит от вида макета: табличный макет вернёт ТабличныйДокумент, схема компоновки — СхемаКомпоновкиДанных, двоичные данные — ДвоичныеДанные, текстовый макет — ТекстовыйДокумент. Учитывайте это при дальнейшей обработке: попытка вызвать ПолучитьОбласть() у текстового макета приведёт к ошибке.

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

Примеры для типовых задач

Получение макета печатной формы

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

Получение схемы компоновки данных

Если общий макет хранит схему компоновки, её передают в компоновщик макета или в отчёт программно: СхемаКД = ПолучитьОбщийМакет("СхемаОтчета"). Далее схема используется как обычно — через КомпоновщикМакетаКомпоновкиДанных и процессор компоновки.

Получение двоичных данных (шаблон Excel, Word)

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

Общий макет против макета объекта: что выбрать

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

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

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

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

Ограничения и безопасная работа

Изменение общего макета затрагивает все объекты, которые его используют. Перед правкой выясните, откуда макет вызывается: воспользуйтесь поиском по конфигурации (Ctrl+Shift+F) по имени макета. Изменение области или параметра, на который опирается чужой код, приведёт к ошибкам в неожиданных местах.

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

Частые вопросы