Как вывести макет на экран в 1С

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

Выбор способа зависит от контекста. Если документ нужно просто показать и, возможно, отправить на печать, достаточно метода Показать(). Если данные должны жить внутри формы обработки или документа — потребуется реквизит формы типа «ТабличныйДокумент» и элемент «ПолеТабличногоДокумента». Ниже разобраны оба сценария с рабочим кодом, проверкой результата и типичными ошибками.

Что такое макет и табличный документ в 1С

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

Рабочим объектом является табличный документ. Программно создаётся командой Новый ТабличныйДокумент, после чего в него последовательно выводятся области макета методом Вывести() или Присоединить(). Параметры областей заполняются через обращение к свойствам: Область.Параметры.Номенклатура = Строка.Товар;.

Быстрый способ: метод Показать()

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

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

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

Вывод макета на форму: поле табличного документа

Если документ должен отображаться внутри формы, добавьте в форму реквизит типа «ТабличныйДокумент» (например, РезультатДокумент) и перетащите его в дерево элементов — платформа создаст поле табличного документа. После этого заполнение реквизита автоматически отображается на экране.

Типичная ошибка — заполнять реквизит в серверной процедуре через Новый ТабличныйДокумент с последующим присваиванием. Правильнее работать с самим реквизитом: РезультатДокумент.Очистить(); и далее РезультатДокумент.Вывести(Область);. Присваивание РезультатДокумент = ТабДок; на сервере вызовет ошибку, потому что типы реквизита формы и объекта различаются.

1. 1
   Добавьте реквизит формы с типом ТабличныйДокумент
2. 2
   Перетащите реквизит в элементы формы — появится ПолеТабличногоДокумента
3. 3
   В коде очистите реквизит: РезультатДокумент.Очистить()
4. 4
   Получите макет и выводите области в реквизит методом Вывести()
5. 5
   Установите свойства отображения: ТолькоПросмотр, ОтображатьСетку, Защита
6. 6
   Обновите форму и проверьте результат в пользовательском режиме

Настройка отображения табличного документа

Перед показом полезно задать свойства, влияющие на восприятие. ТабДок.ТолькоПросмотр = Истина; запрещает редактирование ячеек пользователем. ТабДок.ОтображатьСетку = Ложь; и ТабДок.ОтображатьЗаголовки = Ложь; делают печатную форму визуально чистой. Для защиты от изменений важных областей используется ТабДок.Защита = Истина; — тогда редактируемыми остаются только ячейки с признаком «СодержитЗначение».

Для многостраничных документов настройте разбиение: АвтоМасштаб, МасштабПечати, ЧерноБелаяПечать, а также повторение шапки через ТабДок.ПовторятьПриПечатиСтроки. Эти свойства влияют и на предварительный просмотр, который пользователь открывает из окна табличного документа.

Вывод печатной формы из документа

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

В самописной конфигурации без БСП команда печати обычно размещается на форме документа или в командном интерфейсе. В обработчике формируется табличный документ и вызывается Показать() либо Напечатать(РежимИспользованияДиалогаПечати.Использовать), если нужно сразу открыть диалог печати без предварительного просмотра.

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

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

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

Проверка результата и отладка

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

Полезный приём — временно сохранить документ в файл: ТабДок.Записать(ПолучитьИмяВременногоФайла(\"mxl\")); и открыть его в конфигураторе. Так видно итоговый результат независимо от механизма показа, что помогает отделить проблемы формирования от проблем отображения.

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