Произвольные колонтитулы и повтор шапки таблицы в табличном документе (функция)
Разработка - Универсальные функции
В данной статье будет приведен пример рекурсивной функции, при помощи которой в табличный документ можно выводить верхний или нижний колонтитулы с произвольным содержимым, а также делать повтор шапки произвольной таблицы в документе (или таблиц, если в документе их несколько).
Сразу уточню, что функция не тестировалась на очень объемных документах, поэтому, если кто-то проведет такое испытание, пожалуйста, напишите результаты в комментариях.
Задача состояла в следующем:
1) выводить не очень большой табличный документ (до 30 листов) с несколькими таблицами,
2) на каждой странице в колонтитуле добавлять нумерацию (если страниц больше одной) и картинку (QR-код) (в том числе корректно выводить нижний колонтитул на последней странице),
3) если какие-либо из таблиц переносились на следующую страницу, необходимо было производить повтор шапки переносимой таблицы, при этом не допустить, чтобы на предыдущей странице осталась только шапка без хотя бы одной строки данных в ней,
4) предусмотреть возможность вывода произвольного верхнего колонтитула (изначально макетом заложен не был).
В частности, это была печатная форма электронной зачетной книжки студента с разбивкой по курсам и семестрам.
Статей на данную тему с примерами вывода колонтитулов и повторов шапки таблицы в интернете, в том числе и здесь на Инфостарте довольно много. Однако, когда возникла описанная выше задача, готового варианта реализации всех названных условий не нашлось (лишь фрагментарно), поэтому был написан некий свой универсальный вариант.
Основным источником идеи для алгоритма был этот пост на Инфостарте от Игоря (за что ему большое спасибо!) под названием "Что делать если в табличный документ нужно выводить колонтитулы с картинками".
Привожу код получившейся основной рекурсивной функции вывода в табличный документ колонтитулов и повторения шапки таблицы:
Как использовать данную функцию
Что понадобится задать в макете для использования функции:
1) область пустой строки,
2) область верхнего колонтитула с произвольным содержимым,
3) область нижнего колонтитула с произвольным содержимым,
4) области шапок таблиц.
Пример:

В коде их соответственно зачитываем:
ОбластьВерхнегоКолонтитула = Макет.ПолучитьОбласть("ВерхнийКолонтитул");
ОбластьНижнегоКолонтитула = Макет.ПолучитьОбласть("НижнийКолонтитул");
ОбластьПустойСтроки = Макет.ПолучитьОбласть("ПустаяСтрока");
Заполняем колонтитулы значениями параметров, если они присутствуют, например:
// картинка кода (здесь исключительно для примера).
ОбластьНижнегоКолонтитула.Параметры.QRCode = QRCode;
При создании табличного документа необходимо задать размер и параметры страницы, чтобы корректно вычислялись страницы при переносе:
ТабДок = Новый ТабличныйДокумент;
// размер и параметры страницы (необходимо для вычислений страниц)
ТабДок.РазмерСтраницы = "A4";
ТабДок.ОриентацияСтраницы = ОриентацияСтраницы.Ландшафт;
ТабДок.МасштабПечати = 100; // 100%
ТабДок.ПолеСверху = 10;
ТабДок.ПолеСнизу = 5;
ТабДок.ПолеСлева = 15;
ТабДок.ПолеСправа = 10;
НомерСтраницы = 1;
Теперь можно формировать табличный документ, обращаясь к функции при построчном выводе данных в ТабДок.
Пример вывода какой-либо области:
Область = Макет.ПолучитьОбласть("ШапкаДокумента");
// заполняем значениями параметров, если есть.
Область.Параметры.Заполнить(ПараметрыОтчетаВВидеСтруктуры);
НомерСтраницы = ВыводВТабДокСКолонтитулами(ТабДок, Область,
ОбластьПустойСтроки, ОбластьВерхнегоКолонтитула, ОбластьНижнегоКолонтитула,, НомерСтраницы);
Пример вывода таблицы:
ОбластьШапкаТаблицы = Макет.ПолучитьОбласть(ИмяТаблицы + "ШапкаТаблицы");
// Вывод шапки таблицы (с проверкой ЗапретВисячихШапокТаблицы)
НомерСтраницы = ВыводВТабДокСКолонтитулами(ТабДок, ОбластьШапкаТаблицы,
ОбластьПустойСтроки, ОбластьВерхнегоКолонтитула,
ОбластьНижнегоКолонтитула, ОбластьШапкаТаблицы, НомерСтраницы);
// Построчный вывод строк таблицы с данными.
Для каждого Строка из ВыводимаяТаблица Цикл
Область = Макет.ПолучитьОбласть(ИмяТаблицы + "Данные");
Область.Параметры.Заполнить(ПараметрыОтчетаВВидеСтруктуры); // заполняем значениями параметров.
// Вывод очередной строки таблицы с проверкой переноса и повтором шапки таблицы.
НомерСтраницы = ВыводВТабДокСКолонтитулами(ТабДок, Область, ОбластьПустойСтроки, О
бластьВерхнегоКолонтитула, ОбластьНижнегоКолонтитула,
ОбластьШапкаТаблицы, НомерСтраницы);
КонецЦикла;
Параметр ЗапретВисячихШапокТаблицы в функции задан безусловно в Истина, но при использовании данной функции Вы можете вынести параметр за ее пределы и сделать настраиваемым, главное, что есть такая возможность.
Пример повтора шапки таблицы:

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

Поэтому, после вывода всех данных в табличный документ делаем завершающий вызов функции, если нужно корректно завершить страницу с нижним колонтитулом:
// завершающий вывод
НомерСтраницы = ВыводВТабДокСКолонтитулами(ТабДок,,
ОбластьПустойСтроки,, ОбластьНижнегоКолонтитула,, НомерСтраницы);
Полный пример:
Скачать готовый пример отчета с данной функцией можно здесь (в примере используется тот же код, что представлен в статье):
Произвольные колонтитулы и повтор шапки таблицы в табличном документе (пример в виде внешнего отчета)
См. также:
- Как в СКД по щелчку на какой-либо ячейке в отчете получить значение другой ячейки
- Как программно открыть внешний отчет из "Дополнительных отчетов и обработок" и передать параметры (при помощи БСП)
Возможно будут интересны статьи:
Вступайте в нашу телеграмм-группу Инфостарт
Вы можете заказать платную адаптацию этой статьи под ваши задачи на «Бирже заказов».
- 0% комиссии — оплата напрямую исполнителю;
- Исполнители любого масштаба — от отдельных специалистов до команд под проект;
- Прямой обмен контактами между заказчиком и исполнителем;
- Безопасная сделка — при необходимости;
- Рейтинги, кейсы и прозрачная система откликов.