Как получить макет в обработке 1С: Инструкция и примеры

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

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

Основы работы с макетами в модуле объекта

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

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

Макет = ЭтотОбъект.ПолучитьМакет("ИмяМакета");

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

⚠️ Внимание: Метод ПолучитьМакет не поддерживает динамическое формирование имени макета через переменную в некоторых старых релизах платформы без явного приведения типов. Убедитесь, что имя передается как строковая константа или явно описанная строковая переменная.

💡

Если вы часто обращаетесь к одному и тому же макету в разных местах кода, сохраняйте ссылку на него в переменную модуля при инициализации, чтобы избежать повторного чтения из метаданных.

Получение макета из формы обработки

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

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

ОбъектФормы = ЭтотОбъект.ПолучитьФорму("ИмяФормы");
Макет = ОбъектФормы.ПолучитьМакет("ИмяМакетаВФорме");

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

📁 Макеты в форме удобно использовать для интерфейсных отчетов, которые пользователь видит сразу после открытия окна.
⚙️ Использование формы позволяет наследовать макеты, если форма создается на основе другой формы.
🔄 При изменении макета в форме не требуется перезагрузка всего объекта обработки, достаточно обновить форму.

Работа с макетами системы компоновки данных (СКД)

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

Обычно макет оформления СКД имеет имя по умолчанию МакетОформления или задается в свойствах схемы компоновки. Для доступа к нему в коде обработки, формирующей отчет, нужно обратиться к схеме компоновки данных, которая также является макетом. Часто схема и макет оформления хранятся вместе.

Если макет оформления вынесен в отдельный ресурс, его получение аналогично работе с обычными табличными документами. Однако, если вы используете стандартные механизмы отчета, система часто подхватывает макет автоматически. Ручное получение требуется при динамической смене стиля отчета в зависимости от настроек пользователя:

Схема = ЭтотОбъект.ПолучитьМакет("ОсновнаяСхемаКомпоновкиДанных");
МакетОформления = ЭтотОбъект.ПолучитьМакет("СтрогийСтиль");
Отчет = Новый ОтчетКомпоновкиДанных;
Отчет.СкомпоноватьРезультат(Схема, , МакетОформления);

⚠️ Внимание: При передаче макета оформления в метод СкомпоноватьРезультат убедитесь, что структура макета соответствует версии системы компоновки данных, иначе отчет может сформироваться с ошибками верстки.

Тип макета	Метод получения	Возвращаемый тип
Табличный документ	`ПолучитьМакет("Имя")`	ТабличныйДокумент
Макет оформления СКД	`ПолучитьМакет("Имя")`	МакетОформленияКомпоновкиДанных
Схема компоновки	`ПолучитьМакет("Имя")`	СхемаКомпоновкиДанных
HTML-документ	`ПолучитьМакет("Имя")`	HTMLДокумент

Использование общих макетов конфигурации

В крупных конфигурациях, таких как 1С:Бухгалтерия предприятия или 1С:Управление торговлей, часто используются общие макеты. Это позволяет переиспользовать шаблоны шапок документов, подвалов или стандартных таблиц в разных местах системы без дублирования кода.

Для получения общего макета используется глобальный контекст или объект метаданных ОбщиеМакеты. Синтаксис несколько отличается от получения макета конкретной обработки. Здесь мы обращаемся к коллекции общих макетов конфигурации:

ОбщийМакет = ОбщиеМакеты.ИмяОбщегоМакета.ПолучитьМакет();

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

Особенности кэширования общих макетов

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

Обработка ошибок и проверка существования

При работе с макетами критически важно обрабатывать ситуации, когда макет отсутствует. Попытка получить несуществующий макет приведет к ошибке выполнения, которая остановит работу обработки. Для предотвращения сбоев рекомендуется использовать конструкцию Попытка...Исключение.

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

Попытка
Макет = ЭтотОбъект.ПолучитьМакет("НужныйМакет");
Исключение
Сообщить("Макет не найден! Проверьте наличие ресурса в конфигурации.");
Возврат;
КонецПопытки;

Такой подход позволяетGracefully (корректно) завершить процедуру формирования отчета или переключиться на резервный вариант вывода данных. Игнорирование этой проверки — частая причина жалоб пользователей на то, что "кнопка печати не работает".

🛡️ Всегда оборачивайте вызов ПолучитьМакет в блок обработки исключений в пользовательском режиме.
🔍 Проверяйте имя макета на соответствие справочнику ресурсов перед компиляцией модуля.
📝 Используйте комментарии в коде для указания точного имени макета, чтобы упростить поддержку.

⚠️ Внимание: В файловом варианте работы 1С отсутствие макета может не вызывать явной ошибки сразу, а приводить к созданию пустого объекта. В клиент-серверном варианте ошибка будет строгой. Учитывайте это при отладке.

💡

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

Особенности работы в управляемых формах

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

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

Пример правильной архитектуры: серверная процедура формирует содержание макета, заполняет его данными, а затем передает готовый ТабличныйДокумент в реквизит формы для вывода. Прямая работа с объектом макета на клиенте невозможна без специальных приемов сериализации.

☑️ Алгоритм безопасного получения макета

Проверить имя макета в конфигуратореУбедиться в серверном контексте вызоваОбернуть в Попытка-ИсключениеПроверить тип возвращаемого объекта

Выполнено: 0 / 4

Часто задаваемые вопросы (FAQ)

Почему метод ПолучитьМакет возвращает "Неопределено"?

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

Можно ли получить макет из внешней обработки?

Да, если внешняя обработка подключена корректно и макет является её ресурсом. Синтаксис аналогичен работе с внутренней обработкой: ВнешняяОбработка.ПолучитьМакет("Имя"). Однако права доступа могут ограничивать этот процесс.

Как получить макет, если я знаю только его синоним?

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

В чем разница между ПолучитьМакет и ПолучитьФорму?

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

Нужно ли освобождать память после работы с макетом?

В 1С:Предприятие 8 управление памятью автоматическое (сборка мусора). Явно уничтожать объекты макетов не требуется, они будут удалены автоматически при выходе из области видимости переменных.

Как получить макет в обработке 1С: Полное руководство