Как создать макет отчета в 1С 8.3

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

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

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

Выбор типа макета: табличный документ или СКД

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

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

Если сомневаетесь, ориентируйтесь на вопрос: будет ли пользователь менять состав колонок и группировок? Если да — СКД. Если отчет всегда выглядит одинаково и его нужно точно сверстать «как в образце» — табличный макет.

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

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

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

Для удобства сразу задайте формат ячеек с числами и датами: выделите ячейку, откройте свойства (правый клик — «Свойства») и установите формат, например «ЧДЦ=2» для сумм. Формат, заданный в макете, сработает автоматически при выводе и избавит от форматирования в коде.

Области и параметры макета

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

Параметры — это ячейки, в которые программа подставит значения. Выделите ячейку, откройте свойства и установите свойство «Заполнение» в значение «Параметр», а в свойстве «Параметр» укажите имя, например «Номенклатура» или «Сумма». Текст ячейки при этом станет служебным и в результат не попадет — вместо него выведется переданное значение.

Есть и третий режим заполнения — «Шаблон». В ячейке-шаблоне можно смешивать статичный текст и параметры в квадратных скобках: «Акт № [Номер] от [Дата]». Это удобно для строк, где значения встроены в предложение, и избавляет от конкатенации строк в коде.

1. 1
   Создайте макет типа «Табличный документ» в отчете или общих макетах
2. 2
   Нарисуйте шапку: заголовок отчета и строку с именами колонок
3. 3
   Выделите строки шапки и назначьте область «Шапка»
4. 4
   Создайте строку данных, задайте в ячейках параметры через свойство «Заполнение — Параметр»
5. 5
   Назначьте строке данных область «Строка»
6. 6
   Добавьте область «Подвал» с ячейками для итогов
7. 7
   Сохраните конфигурацию и проверьте, что имена областей и параметров не содержат пробелов

Программное заполнение макета данными

Заполнение выполняется в модуле объекта отчета или в общем модуле. Логика стандартная: получить макет, получить из него области, в цикле заполнить параметры и вывести области в результирующий табличный документ. Результат обычно помещают в реквизит формы типа «ТабличныйДокумент», чтобы пользователь увидел его на экране.

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

Обратите внимание на метод Параметры.Заполнить(Выборка): он автоматически переносит в параметры области значения полей выборки, имена которых совпадают с именами параметров. Это избавляет от построчного присваивания, но требует, чтобы имена в запросе и в макете совпадали в точности, включая регистр.

Для группировок (например, строки внутри контрагента) добавьте область «Группа» и выводите ее при смене значения группировочного поля. Для многоуровневых отчетов используйте метод НачатьГруппуСтрок/ЗакончитьГруппуСтрок результата — тогда пользователь сможет сворачивать группы, как в типовых отчетах.

Вариант со схемой компоновки данных

Если выбран путь СКД, на вкладке «Макеты» создайте макет типа «Макет компоновки данных», а основную работу выполните в «Основной схеме компоновки данных» отчета. Там на закладке «Наборы данных» пишется запрос, на закладке «Настройки» задаются группировки, выбранные поля и отборы по умолчанию. Платформа сама построит макет и выведет результат — код формирования сводится к нескольким строкам или вообще не нужен, если отчет работает в стандартной форме.

Ручной макет СКД нужен, когда стандартное оформление не подходит: например, нужен особый заголовок, объединенные ячейки или нестандартные итоги. В редакторе макета компоновки создаются макеты областей (заголовок группировки, поля, ресурсы), где ячейки привязываются к полям схемы. Это более трудоемкий путь, поэтому начинайте с автоматического оформления и добавляйте ручной макет только для тех областей, которые нужно изменить.

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

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

Отдельно проверьте печатную форму: выведите результат на печать или сохраните в PDF и Excel. Расхождения обычно видны именно там: слишком широкие колонки, не задана область печати, текст обрезан из-за фиксированной высоты строк. Свойства «АвтоВысотаСтроки» и «Размещение текста» в макете решают большинство таких проблем без изменения кода.

Ограничения и безопасная работа с типовыми конфигурациями

Табличный макет не умеет сам строить группировки, отборы и диаграммы — все это программируется вручную. Если требования к отчету регулярно меняются пользователями, табличный макет превратится в источник постоянных доработок; в этом случае переносите отчет на СКД. Обратное ограничение СКД — слабый контроль над пиксельной версткой, поэтому строгие печатные формы (с точным соответствием утвержденному бланку) делают табличным макетом.

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

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