Как добавить свой макет в 1С: от шаблона до интеграции в конфигурацию

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

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

Если вы никогда не занимались программированием в 1С, но хотите научиться адаптировать систему под нужды бизнеса — этот материал станет отличным стартом. Для опытных разработчиков мы подготовили нюансы работы с МакетомКомпоновкиДанных и динамическим формированием шаблонов.

1. Что такое макет в 1С и зачем он нужен

Макет в 1С:Предприятие — это объект конфигурации, который хранит данные в заранее определённом формате. Он может содержать:

• 📄 Табличные документы (например, шаблоны Excel для выгрузки отчётов)
• 🖼️ Графические файлы (логотипы, иконки, фоновые изображения)
• 📑 Текстовые шаблоны (HTML, XML, JSON для интеграций)
• 📊 Схемы компоновки данных (для сложных отчётов)
• 💾 Двоичные данные (шрифты, сертификаты, архивы)

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

Без макетов невозможно:

• 📋 Печатать документы с уникальным дизайном (например, счета с логотипом компании)
• 🔄 Автоматизировать обмен данными с внешними системами (выгрузка в Excel, загрузка из XML)
• 📈 Строить сложные отчёты с нестандартной компоновкой

⚠️ Внимание: Макеты, добавленные через Файл → Открыть в пользовательском режиме, не сохраняются в конфигурации! Они доступны только текущему пользователю и исчезнут после обновления базы.

2. Подготовка макета: требования к формату и структуре

Перед тем как добавлять макет в 1С, его нужно правильно подготовить. Формат зависит от типа данных:

Для табличных документов (.mxl) рекомендуется использовать встроенный редактор 1С. Он позволяет:

• 📏 Настраивать ширину столбцов и высоту строк с привязкой к данным
• 🎨 Применять условное форматирование (например, красный цвет для отрицательных чисел)
• 🔗 Вставлять гиперссылки и динамические поля (например, &НомерДокумента)

Если вы работаете с внешними файлами (например, .xlsx), убедитесь, что:

• 🔢 Ячейки с данными имеют правильный формат (дата, число, текст)
• 🔍 Имена листов не содержат специальных символов (разрешены только буквы, цифры и подчёркивание)
• 📌 Заголовки столбцов совпадают с именами реквизитов в 1С (регистр важен!)

⚠️ Внимание: При использовании HTML-макетов избегайте тегов <script> и внешних стилей — они могут блокироваться системой безопасности 1С.

3. Добавление макета через Конфигуратор: пошаговая инструкция

Самый надёжный способ добавить макет — использовать Конфигуратор. Этот метод гарантирует, что макет станет частью конфигурации и будет доступен всем пользователям. Инструкция подходит для 1С:Предприятие 8.3 (все редакции).

Шаги:

1. Откройте конфигурацию в режиме Конфигуратор (правый клик по базе → Конфигуратор).
2. В дереве объектов найдите раздел, куда нужно добавить макет:
   • 📁 Для документов: Документы → [ВашДокумент] → Макеты
   • 📊 Для отчётов: Отчёты → [ВашОтчёт] → Макеты
   • ⚙️ Для общих макетов: Общие → Макеты

После добавления макет будет доступен в коде через метод:

Макет = Документы.ВашДокумент.ПолучитьМакет("ШаблонСчета");

⚠️ Внимание: Если макет добавляется в управляемое приложение, убедитесь, что у пользователей есть права на чтение объекта конфигурации, иначе они не увидят печатную форму.

Имя макета без пробелов и спецсимволов|

Тип макета соответствует формату файла|

Файл оптимизирован (нет лишних стилей/данных)|

Права доступа настроены для пользователей|

Конфигурация сохранена и база обновлена

-->

4. Работа с макетами через встроенный язык 1С

Иногда макеты нужно создавать или модифицировать динамически — например, когда шаблон зависит от данных документа. Для этого используется встроенный язык 1С.

Пример 1: Загрузка табличного макета и заполнение данными

// Получаем макет из конфигурации
Макет = Документы.СчетНаОплату.ПолучитьМакет("ШаблонСчета");

// Создаём табличный документ на основе макета
ТабДок = Новый ТабличныйДокумент;
ТабДок.ПрочитатьМакет(Макет);

// Заполняем динамические поля (например, номер и дату)
ТабДок.Параметры.Номер = Документ.Номер;
ТабДок.Параметры.Дата = Формат(Документ.Дата, "ДФ=dd.MM.yyyy");

// Выводим на печать
ТабДок.Показать();

ТекстHTML = "
|
|
|
|    
|      
|      &ТаблицаТоваров
|    

Товар
Кол-во
Цена


|
|";

// Подставляем параметры
ТекстHTML = СтроковыеФункции.ПодставитьПараметры(ТекстHTML,
Новый Структура("Номер,Дата,ТаблицаТоваров", Документ.Номер, Документ.Дата, ПолучитьТаблицуТоваров()));

// Сохраняем как макет (например, для email-рассылки)
Макет = Новый ТекстовыйДокумент;
Макет.УстановитьТекст(ТекстHTML);
Документы.СчетНаОплату.Макеты.Добавить("HTMLШаблон", Макет);

Схема = Новый МакетКомпоновкиДанных;
Схема.ЗагрузитьИзФайла("C:\Отчеты\СхемаОборотов.mxl");

// Настраиваем параметры
Схема.Параметры.Добавить("Период", Тип("Строка"));

// Сохраняем в конфигурацию
Отчеты.ОборотыПоСчетам.Макеты.Добавить("ОсновнаяСхема", Схема);

Если ТекстовыйДокумент.Кодировка <> КодировкаТекста.UTF8 Тогда
Сообщить("Макет в неправильной кодировке!");
КонецЕсли;

Попытка
Макет = Документы.СчетНаОплату.ПолучитьМакет("ШаблонСчета");
Исключение
ЗаписьЖурналаРегистрации("ОшибкаМакета", УровеньЖурналаРегистрации.Ошибка, ,
"Не удалось загрузить макет: " + ОписаниеОшибки());
КонецПопытки;

// В модуле объекта (например, документа "СчетНаОплату")
Процедура ПриПечати(Макет)
Если НЕ Пользователь.ГруппаДоступа = "Бухгалтерия" Тогда
ВызватьИсключение "Доступ к печатной форме запрещён!";
КонецЕсли;
КонецПроцедуры

Хранилище = Новый ХранилищеЗначений;
Хранилище.Записать(Новый ДвоичныеДанные(ПутьКФайлу));

// Сохраняем ссылку в справочнике
Справочник.Филиалы.НайтиПоНаименованию("Московский").ХранилищеЛоготипа = Хранилище;

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