Как открыть макет внешней обработки в 1С

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

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

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

Что такое макет внешней обработки и где он хранится

Макет — это встроенный в файл обработки ресурс, который программист использует как шаблон. В отличие от макетов конфигурации, макеты внешней обработки хранятся внутри самого файла .epf и переносятся вместе с ним, что удобно для распространения печатных форм и отчётов без изменения основной конфигурации.

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

Какие типы макетов можно встретить

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

• Табличный документ — самый частый вариант для печатных форм; открывается в редакторе, похожем на электронную таблицу, с областями и параметрами.
• Схема компоновки данных (СКД) — основа отчётов; открывается конструктор с набором данных, ресурсами и настройками.
• Текстовый документ — шаблоны писем, запросов, скриптов.
• Двоичные данные — картинки, библиотеки, файлы, встроенные в обработку.
• Макет оформления компоновки данных, HTML-документ, географическая схема, графическая схема — реже встречающиеся специализированные типы.

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

Пошаговая инструкция: открытие макета в конфигураторе

Основной сценарий одинаков для всех актуальных версий платформы 1С:Предприятие 8.3. Потребуются права на запуск конфигуратора и сам файл обработки.

1. 1
   Запустите 1С в режиме «Конфигуратор» для любой информационной базы (содержимое базы не важно, обработка открывается из файла).
2. 2
   В меню выберите «Файл → Открыть» и укажите файл внешней обработки с расширением .epf.
3. 3
   После загрузки появится окно со структурой обработки. Если оно не открылось автоматически, найдите его в списке окон или откройте обработку повторно.
4. 4
   В дереве структуры разверните узел «Макеты» — он находится на одном уровне с «Формами» и «Модулями».
5. 5
   Дважды щёлкните по нужному макету: откроется редактор, соответствующий типу макета.
6. 6
   Внесите изменения и сохраните файл через «Файл → Сохранить» или Ctrl+S.

Если узла «Макеты» в дереве нет, значит, в обработке ещё не создан ни один макет. Его можно добавить: щёлкните правой кнопкой по корню структуры или по ветке «Макеты», выберите «Добавить», задайте имя и тип.

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

Редактирование табличного макета печатной формы

Табличный документ — наиболее востребованный тип макета, поэтому разберём работу с ним подробнее. Редактор состоит из ячеек, объединённых в именованные области: шапка, строка, подвал и т. п. Код обработки получает эти области по имени и заполняет параметры.

Чтобы ячейка работала как параметр, выделите её, откройте свойства (правый клик → «Свойства») и установите свойство «Заполнение» в значение «Параметр», а в свойстве «Параметр» укажите имя. Если оставить заполнение «Текст», значение из кода подставлено не будет — это одна из самых частых причин «пустых» печатных форм.

Имена областей задаются в левой серой колонке редактора: выделите строки и введите имя области. Именно эти имена используются в коде: Макет.ПолучитьОбласть("Шапка"). Переименование области без правки кода приведёт к ошибке выполнения.

Как обратиться к макету из кода

Открытие макета в редакторе нужно для настройки, но конечная цель — использование в коде. Для внешней обработки вызов выполняется в модуле объекта:

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

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

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

Типичные ошибки и как их избежать

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

Проверка результата после редактирования

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

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