Произвольные колонтитулы и повтор шапки таблицы в табличном документе (функция)

07.10.20

Разработка - Универсальные функции

Пример рекурсивной функции, при помощи которой в табличный документ можно выводить верхний или нижний колонтитулы с произвольным содержимым, а также делать повтор шапки таблицы (или таблиц, если их несколько).

В данной статье будет приведен пример рекурсивной функции, при помощи которой в табличный документ можно выводить верхний или нижний колонтитулы с произвольным содержимым, а также делать повтор шапки произвольной таблицы в документе (или таблиц, если в документе их несколько).
Сразу уточню, что функция не тестировалась на очень объемных документах, поэтому, если кто-то проведет такое испытание, пожалуйста, напишите результаты в комментариях.

Задача состояла в следующем: 
1) выводить не очень большой табличный документ (до 30 листов) с несколькими таблицами,
2) на каждой странице в колонтитуле добавлять нумерацию (если страниц больше одной) и картинку (QR-код) (в том числе корректно выводить нижний колонтитул на последней странице),
3) если какие-либо из таблиц переносились на следующую страницу, необходимо было производить повтор шапки переносимой таблицы, при этом не допустить, чтобы на предыдущей странице осталась только шапка без хотя бы одной строки данных в ней,
4) предусмотреть возможность вывода произвольного верхнего колонтитула (изначально макетом заложен не был).

В частности, это была печатная форма электронной зачетной книжки студента с разбивкой по курсам и семестрам.

Статей на данную тему с примерами вывода колонтитулов и повторов шапки таблицы в интернете, в том числе и здесь на Инфостарте довольно много. Однако, когда возникла описанная выше задача, готового варианта реализации всех названных условий не нашлось (лишь фрагментарно), поэтому был написан некий свой универсальный вариант.
Основным источником идеи для алгоритма был этот пост на Инфостарте от Игоря (за что ему большое спасибо!) под названием "Что делать если в табличный документ нужно выводить колонтитулы с картинками".

Привожу код получившейся основной рекурсивной функции вывода в табличный документ колонтитулов и повторения шапки таблицы:

 
 Код функции

 

Как использовать данную функцию

Что понадобится задать в макете для использования функции:
    1) область пустой строки,
    2) область верхнего колонтитула с произвольным содержимым,
    3) область нижнего колонтитула с произвольным содержимым,
    4) области шапок таблиц.

Пример:

 

В коде их соответственно зачитываем:

ОбластьВерхнегоКолонтитула = Макет.ПолучитьОбласть("ВерхнийКолонтитул");
ОбластьНижнегоКолонтитула = Макет.ПолучитьОбласть("НижнийКолонтитул");
ОбластьПустойСтроки = Макет.ПолучитьОбласть("ПустаяСтрока");

 

Заполняем колонтитулы значениями параметров, если они присутствуют, например:

// картинка кода (здесь исключительно для примера).
ОбластьНижнегоКолонтитула.Параметры.QRCode = QRCode;

 

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

ТабДок = Новый ТабличныйДокумент;
// размер и параметры страницы (необходимо для вычислений страниц)
ТабДок.РазмерСтраницы = "A4";
ТабДок.ОриентацияСтраницы = ОриентацияСтраницы.Ландшафт;
ТабДок.МасштабПечати = 100; // 100%
ТабДок.ПолеСверху = 10;
ТабДок.ПолеСнизу = 5;
ТабДок.ПолеСлева = 15;
ТабДок.ПолеСправа = 10;
НомерСтраницы = 1;

 

Теперь можно формировать табличный документ, обращаясь к функции при построчном выводе данных в ТабДок.

Пример вывода какой-либо области:

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

 

Пример вывода таблицы:

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

 

Параметр ЗапретВисячихШапокТаблицы в функции задан безусловно в Истина, но при использовании данной функции Вы можете вынести параметр за ее пределы и сделать настраиваемым, главное, что есть такая возможность.

Пример повтора шапки таблицы:

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

 

Поэтому, после вывода всех данных в табличный документ делаем завершающий вызов функции, если нужно корректно завершить страницу с нижним колонтитулом:

// завершающий вывод
НомерСтраницы = ВыводВТабДокСКолонтитулами(ТабДок,, 
ОбластьПустойСтроки,, ОбластьНижнегоКолонтитула,, НомерСтраницы);

 

Полный пример:

 
 Пример использования функции

 

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

 

См. также:

Возможно будут интересны статьи:

табличный документ макет печать колонтитулы печатная форма шапка таблицы 8.3 управляемые формы

См. также

Универсальные функции Программист Платформа 1С v8.3 Конфигурации 1cv8 Бесплатно (free)

Благодаря этим пяти строчкам можно больше не заморачиваться с загрузкой из внешних файлов. Пользуюсь везде, всегда и постоянно.

21.05.2024    20125    dimanich70    81    

144

Универсальные функции Программист Платформа 1С v8.3 Конфигурации 1cv8 Абонемент ($m)

Задача: вставить картинку из буфера обмена на форму средствами платформы 1С.

1 стартмани

18.03.2024    4091    3    John_d    11    

57

Универсальные функции Программист Стажер Платформа 1С v8.3 Конфигурации 1cv8 Бесплатно (free)

Пришлось помучиться с GUID-ами немного, решил поделиться опытом, мало ли кому пригодится.

12.02.2024    18060    atdonya    24    

56

Универсальные функции Программист Платформа 1С v8.3 Бесплатно (free)

На заключительных этапах, когда идет отладка или доработка интерфейса, необходимо много раз переоткрыть внешний объект. Вот один из способов автоматизации этого.

30.11.2023    5502    ke.92@mail.ru    16    

65

WEB-интеграция Универсальные функции Механизмы платформы 1С Программист Платформа 1С v8.3 Конфигурации 1cv8 Бесплатно (free)

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

28.08.2023    14730    YA_418728146    7    

166

Пакетная печать Печатные формы Адаптация типовых решений Универсальные функции Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Россия Абонемент ($m)

Расширение для программ 1С:Управление торговлей, 1С:Комплексная автоматизация, 1С:ERP, которое позволяет распечатывать печатные формы для непроведенных документов. Можно настроить, каким пользователям, какие конкретные формы документов разрешено печатать без проведения документа.

2 стартмани

22.08.2023    3580    56    progmaster    8    

4

Инструментарий разработчика Универсальные функции Платформа 1С v8.3 Конфигурации 1cv8 1С:Розница 2 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Зарплата и Управление Персоналом 3.x Абонемент ($m)

Копирует в буфер значения из списков, из ячеек отчетов, таблиц, настроек списков, других отборов и вставляет в выбранную настройку отбора. Работает с Объект не найден. Работает как в одной так и между разными базами 1С. Использует комбинации [Alt+C] Копировать список, [Alt+V] Вставить список. Также для копирования данных используется стандартная [Ctrl+C] (например из открытого xls, mxl, doc и т.п. файла скопировать список наименований)

1 стартмани

13.10.2022    18478    171    sapervodichka    112    

135
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. it-expert 08.10.20 14:01 Сейчас в теме
В макете это просто сделать. Вот когда отчет на СКД то появляется засада
user712426; +1 Ответить
2. user618575_VladimirGluhov.1c 2 18.03.21 11:26 Сейчас в теме
3. user825364 01.09.21 14:42 Сейчас в теме
Оч круто.. например письма на оф бланках формируются на раз.. Спасибо!
4. krlexa 05.08.22 09:26 Сейчас в теме
А можно ли как-то вывести &СтраницВсего как в стандартных колонтитулах?
7. banitBPS 2 07.04.23 12:34 Сейчас в теме
Макет.НижнийКолонтитул.Выводить = Истина;
Макет.НижнийКолонтитул.ТекстВЦентре = "Страница [&НомерСтраницы] из [&СтраницВсего] ";
Andreyyy; +1 Ответить
5. val_ka 28.09.22 08:26 Сейчас в теме
Спасибо от души. Столько времени сэкономлено
6. ketr 128 03.10.22 15:38 Сейчас в теме
Очень помогла ваша статья, благодарю!
8. rava_aal 24.06.24 21:52 Сейчас в теме
Спасибо огромное! Столько времени Вы мне спасли)
Оставьте свое сообщение