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