Урок 9. Настройка печатных форм
Цель данного урока, ознакомить слушателя с принципами создания отчетов.
2. Шаблоны отчетов
Шаблоны документов имеют одинаковую разметку, что позволяет, научившись размечать шаблоны одного типа, создавать отчёты других типов.
Рассмотрим основные положения.
Основным элементом разметки шаблона является
-
Тэг
Текст окружённый спецсимволами, управляющий формированием отчёта.
Все тэги имеют следующий вид: [#{значение}#]
Простейшим случаем является Тэг, возвращающий значение атрибута строки: [#{имя атрибута}#]
.
С помощью таких тэгов обозначаются места, которые должны быть заполнены данными. Если в данных не будет найден атрибут или параметр с именем {имя атрибута}
, текст будет заменён на пустоту.
Для печати в отчете набора данных предназначены переменные части, позволяющие выполнять запросы и выводить в отчёт данные с изменяющимся количеством строк.
Переменной частью называется область шаблона, ограниченная открывающим и закрывающим тэгами. Переменная часть будет выведена в отчёт столько раз, сколько записей находится в выборке переменной части.
Форматы тегов для печати данных из запроса:
- открывающий тэг
[#&{произвольное системное имя}={SQL запрос}#]
-
закрывающий тэг
[#/{произвольное системное имя}#]
- Внимание
-
- Важно понимать, что при построении шаблона отчёта все строчки внутри открывающего и закрывающего тэга будут удалены из документа. Поэтому для корректного построения отчёта они не должны содержать ничего лишнего.
Переменная часть обязательно должна заканчиваться закрывающим тэгом, системное имя которого совпадает с системным именем открывающего тэга. Все системные имена открывающих тэгов начинаются с символа &
, а все закрывающие тэги начинаются с символа /
.
При выводе данных в отчет из запроса открывающий тэг переменной части состоит из произвольного уникального в рамках шаблона имени и SQL запроса. В этом случае для данной переменной части также будет создан набор данных с запросом указанным в тэге.
Переменные части могут быть вложенными друг в друга, образовывая связку мастер-деталь.
Настройки вставки изображений в печатную форму типа docx
Данная настройка производится в коллекции к печатной форме.
Для изучения подробнее смотри: Настройки вставки изображений в печатную форму типа docx
Для вставки изображений в печатную форму типа docx должны быть выполнены следующие условия:
-
Печатная форма должна содержать теги вида [SomeTag]
- Внимание
-
- Не путать с тегами разметки шаблона!
- Тип шаблона печатной формы - docx
- Формат печатной формы - pdf
- В коллекции к печатной форме(Настройки вставки изображений в печатную форму) настроены необходимые изображения для вставки
Если все требования выполнены корректно, то при печати такой печатной формы будет получен pdf файл с изображениями на месте тегов.