Как вывести область табличного документа в 1С

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

Типовая схема выглядит так: создаётся объект ТабличныйДокумент, из макета последовательно получаются области (шапка, строка, подвал), в параметры областей подставляются данные, и каждая область выводится в результат. Ошибки на этом пути встречаются предсказуемые: несовпадение имён областей, незаполненные параметры, потеря форматирования при неправильном порядке вывода.

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

Как устроен механизм вывода областей

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

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

Базовый пример: получить область и вывести её

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

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

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

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

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

После заполнения документ показывают пользователю методом ТабДок.Показать() либо отправляют на печать через ТабДок.Напечатать(). Для управляемых форм чаще используют Показать() с режимом или передают документ в стандартную команду печати БСП.

1. 1
   Создайте объект: ТабДок = Новый ТабличныйДокумент
2. 2
   Получите макет: Макет = ПолучитьМакет("ИмяМакета") или ЭтотОбъект.ПолучитьМакет() в модуле объекта
3. 3
   Получите область: Область = Макет.ПолучитьОбласть("ИмяОбласти")
4. 4
   Заполните параметры области данными
5. 5
   Выведите область: ТабДок.Вывести(Область)
6. 6
   Покажите результат: ТабДок.Показать() или отправьте на печать

Способы указания области в ПолучитьОбласть

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

На практике именованные области предпочтительнее: адресация по координатам ломается при любом редактировании макета (добавили строку — сместились все R-ссылки). Имена же сохраняются при вставке и удалении строк, если сама область не затронута.

Вывести или Присоединить: вертикальный и горизонтальный вывод

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

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

Проверка поместится ли область: ВывестиГоризонтально и ПроверитьВывод

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

МассивОбластей = Новый Массив;
МассивОбластей.Добавить(ОбластьСтрока);
МассивОбластей.Добавить(ОбластьПодвал);

Если Не ТабДок.ПроверитьВывод(МассивОбластей) Тогда
    ТабДок.ВывестиГоризонтальныйРазделительСтраниц();
КонецЕсли;
ТабДок.Вывести(ОбластьСтрока);

Метод ВывестиГоризонтальныйРазделительСтраниц() принудительно начинает новую страницу. Без связки «проверка + разделитель» подвал документа может оказаться на отдельном листе без последней строки, что выглядит непрофессионально и иногда недопустимо для регламентированных форм.

Типичные ошибки и их диагностика

Большинство проблем при выводе областей сводится к нескольким повторяющимся причинам. Их легко распознать по тексту ошибки или по внешнему виду результата.

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

Проверка результата и ограничения механизма

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

Из ограничений стоит помнить: табличный документ не предназначен для очень больших объёмов (десятки тысяч строк формируются медленно и занимают много памяти — для таких задач подходит СКД или выгрузка в файл). Также метод Вывести() не позволяет вставить область в середину документа — только в конец; для вставки используют ВставитьОбласть() с указанием целевого диапазона.

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