Создание макетов в 1С: от простого к сложному

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

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

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

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

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

• 📄 Печатных форм документов (счёта, накладные, акты)
• 📊 Отчётов с таблицами, диаграммами и графиками
• 🖼️ Интерфейсных элементов (например, шапки документа с логотипом)
• 📑 Текстовых документов (договоры, письма с подстановкой данных)

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

В платформе 1С:Предприятие 8.3 макеты хранятся в дереве меток конфигурации (раздел Общие → Макеты) или могут быть созданы динамически через Новый Макет. Они поддерживают несколько форматов:

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

Подготовка к созданию макета: выбор инструментов

Прежде чем приступить к созданию макета, определите:

1. Где будет храниться макет — в конфигурации (для повторного использования) или создаваться динамически (для разовых задач).
2. Какой тип макета нужен — табличный, текстовый или другой (см. таблицу выше).
3. Источник данных — будут ли данные подгружаться из базы через запрос, передаваться параметрами или формироваться вручную.

Для работы с макетами в Конфигураторе используйте:

• 🛠️ Конструктор макетов — визуальный редактор для табличных и текстовых документов (вызывается двойным кликом по макету в дереве конфигурации).
• 📝 Встроенный язык — для динамического создания макетов через Новый МакетКомпоновкиДанных или Новый ТабличныйДокумент.
• 🔄 Построитель отчёта — если макет используется для сложных отчётов с группировками.

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

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

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

Табличные макеты — самый распространённый тип. Они используются для печатных форм документов, прайс-листов, отчётов. Рассмотрим процесс на примере создания макета для счёта на оплату.

Шаг 1. Создание макета в конфигурации

1. Откройте Конфигуратор и перейдите в раздел Общие → Макеты.
2. Добавьте новый макет через контекстное меню (Добавить → Макет).
3. Укажите имя (например, МакетСчетаНаОплату) и тип Табличный документ.
4. Дважды кликните по макету, чтобы открыть Конструктор макетов.

Шаг 2. Настройка структуры таблицы

В конструкторе:

• 📏 Задайте количество строк и столбцов (например, 20×6 для шапки и табличной части счёта).
• 🔠 Объедините ячейки для шапки документа (название организации, реквизиты).
• 📌 Создайте области с именами (например, Шапка, ТаблицаТоваров, Итоги) через контекстное меню Имя области.
• 🎨 Настройте шрифты, выравнивание и границы для визуального оформления.

Имена областей указаны корректно|

Ширина столбцов соответствует данным|

Объединённые ячейки не перекрывают важные области|

Заданы границы для табличной части-->

Шаг 3. Привязка данных к макету

Чтобы заполнить макет данными, используйте метод Вывести() в коде. Пример для печати счёта:

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

// Заполнение шапки
ТабличныйДокумент.Область("Шапка").Параметры.Заполнить(ДокументОбъект);

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

// Вывод итогов
ТабличныйДокумент.Область("Итоги").Параметры.Сумма = ДокументОбъект.ИтоговаяСумма;

ТабличныйДокумент.Показать();
КонецПроцедуры

⚠️ Внимание: Если данные не отображаются в макете, проверьте совпадение имён параметров в области макета и в коде. Например, если в макете область имеет параметр НомерДокумента, а в коде вы передаёте Номер — значение не подставится.

Работа с текстовыми макетами: шаблоны писем и договоров

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

Пример создания макета договора:

1. Создайте макет типа Текстовый документ с именем ШаблонДоговора.
2. В редакторе введите текст договора, добавив плейсхолдеры для динамических данных:

   ДОГОВОР №#НомерДоговора#
   от #ДатаДоговора#
   
   ООО "#НазваниеОрганизации#", в лице генерального директора #ФИОДиректора#,
   действующего на основании Устава, с одной стороны, и #Контрагент#, с другой стороны,
   заключили настоящий договор о нижеследующем...

3. Сохраните макет и используйте его в коде через ТекстовыйДокумент:

Процедура СформироватьДоговор(ДанныеДоговора)
Макет = ПолучаемМакет("ШаблонДоговора");
ТекстовыйДокумент = Новый ТекстовыйДокумент;
ТекстовыйДокумент.Прочитать(Макет);

// Замена плейсхолдеров на реальные данные
Текст = ТекстовыйДокумент.ПолучитьТекст();
Текст = СтроковыеФункции.Заменить(Текст, "#НомерДоговора#", ДанныеДоговора.Номер);
Текст = СтроковыеФункции.Заменить(Текст, "#ДатаДоговора#", Формат(ДанныеДоговора.Дата, "ДФ=dd.MM.yyyy"));
// ... остальные замены

ТекстовыйДокумент.УстановитьТекст(Текст);
ТекстовыйДокумент.Показать();
КонецПроцедуры

Важно: Для работы с плейсхолдерами в текстовых макетах используйте функцию СтроковыеФункции.Заменить(), а не СтрЗаменить() — она корректнее обрабатывает многобайтовые символы (например, кириллицу).

Динамическое формирование макетов через запрос

Иногда макет нужно создавать "на лету" — например, когда структура отчёта зависит от пользовательских настроек. В таких случаях используйте динамические макеты, формируемые через Запрос и ПостроительОтчёта.

Пример: Создание отчёта по продажам с группировкой по периодам

Процедура СформироватьОтчетПоПродажам(ПериодНачала, ПериодОкончания)
// 1. Получаем данные через запрос
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Продажи.Дата КАК Дата,
|   Продажи.Контрагент КАК Контрагент,
|   СУММА(Продажи.Сумма) КАК Сумма
|ИЗ
|   Документ.РеализацияТоваровУслуг КАК Продажи
|ГДЕ
|   Продажи.Дата МЕЖДУ &ПериодНачала И &ПериодОкончания
|СГРУППИРОВАТЬ ПО
|   Продажи.Дата,
|   Продажи.Контрагент";

Запрос.УстановитьПараметр("ПериодНачала", ПериодНачала);
Запрос.УстановитьПараметр("ПериодОкончания", ПериодОкончания);
РезультатЗапроса = Запрос.Выполнить();

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

// 3. Формируем шапку отчёта
ОбластьШапка = Макет.Область();
ОбластьШапка.Текст = "Отчёт по продажам за период с " + Формат(ПериодНачала, "ДФ=dd.MM.yyyy") + " по " + Формат(ПериодОкончания, "ДФ=dd.MM.yyyy");
Макет.Вывести(ОбластьШапка);

// 4. Выводим данные из запроса
Выборка = РезультатЗапроса.Выбрать();
Пока Выборка.Следующий() Цикл
ОбластьСтрока = Макет.Область();
ОбластьСтрока.Ячейка(1,1).Текст = Формат(Выборка.Дата, "ДФ=dd.MM.yyyy");
ОбластьСтрока.Ячейка(1,2).Текст = Выборка.Контрагент.Наименование;
ОбластьСтрока.Ячейка(1,3).Текст = Формат(Выборка.Сумма, "ЧДЦ=2; ЧРЗ= ");
Макет.Вывести(ОбластьСтрока);
КонецЦикла;

Макет.Показать();
КонецПроцедуры

Для сложных отчётов с группировками и итогами удобнее использовать ПостроительОтчёта:

Построитель = Новый ПостроительОтчета;
Построитель.ИсточникДанных = Новый ИсточникДанныхДляПостроителяОтчета(РезультатЗапроса);
Построитель.Настройки.ИмяОтчета = "Отчёт по продажам";
Построитель.Настройки.ВыводитьИтоги = Истина;
Макет = Построитель.Построить();

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

Распространённые ошибки и их решение

Даже опытные разработчики сталкиваются с проблемами при работе с макетами. Вот самые частые ошибки и способы их исправления:

Дополнительные советы по отладке:

• 🔍 Используйте Сообщить() для вывода промежуточных значений параметров перед выводом макета.
• 📋 Проверяйте структуру макета через ТабличныйДокумент.Записать("C:\temp\макет.mxl") и откройте файл в блокноте.
• 🔄 Если макет формируется динамически, выводите его пошагово (сначала шапку, потом таблицу), чтобы локализовать ошибку.

ТабличныйДокумент.Записать("C:\temp\debug_maket.mxl", ТипФайлаТабличногоДокумента.MXL);
ТекстовыйДокумент.Записать("C:\temp\debug_tekst.txt", КодировкаТекста.UTF8);

Продвинутые техники: компоновка данных и ActiveDocument

Для сложных отчётов с группировками, диаграммами и динамическими параметрами используйте систему компоновки данных (СКД). Она позволяет:

• 📈 Строить отчёты с иерархией (например, продажи по регионам и менеджерам).
• 📊 Добавлять диаграммы, сводные таблицы и графики.
• ⚙️ Настраивать пользовательские параметры (период, фильтры).

Пример создания отчёта с СКД:

1. Создайте макет типа Макет компоновки данных.
2. В конструкторе настройте наборы данных (запросы к базе), параметры (например, даты) и структуру отчёта (группировки, ресурсы).
3. Используйте отчёт в коде:

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

Для работы с MS Word и Excel используйте макеты типа ActiveDocument. Они позволяют:

• 📄 Создавать документы Word с книжной ориентацией, колонтитулами и стилями.
• 📉 Экспортировать данные в Excel с формулами и условным форматированием.

Пример экспорта в Excel:

Макет = ПолучаемМакет("ШаблонExcel");
ДвоичныеДанные = Макет.ПолучитьДвоичныеДанные();
ИмяФайла = "C:\Отчет.xlsx";
ДвоичныеДанные.Записать(ИмяФайла);

// Открытие файла в Excel
ЗапуститьПриложение(ИмяФайла);

FAQ: Ответы на частые вопросы

&НаКлиенте
Процедура Печать(Команда)
ПечатьСчета(Объект);
КонецПроцедуры

&НаСервере
Процедура ПечатьСчета(ДокументОбъект) Экспорт
// Код вывода макета (см. примеры выше)
КонецПроцедуры

ПутьКЛоготипу = "C:\Images\logo.png";
Картинка = Новый Картинка(ПутьКЛоготипу);
ТабличныйДокумент.Область("Логотип").Картинка = Картинка;

Данные = ВременноеХранилище.Получить(Идентификатор);
Макет = ПолучаемМакет("МакетОтчета");
ТабличныйДокумент = Новый ТабличныйДокумент;
ТабличныйДокумент.Прочитать(Макет);

// Пример заполнения данными из временного хранилища
ОбластьДанные = ТабличныйДокумент.Область("Данные");
ОбластьДанные.Параметры.Заполнить(Данные);

ТабличныйДокумент.Показать();