Документация iSZN
01. Структура выходного документа
Первичная выборка документа
Ключевым элементом в структуре выходного документа является первичная выборка. Если она задана (с помощью варианта выборки или напрямую, собственным завершением SQL-запроса), то она определяет набор записей и столбцов, которые могут быть использованы в документе, а также его сортировку. Если же она не задана, то подразумевается, что документ использует единичную выборку, то есть при его формировании в первичной выборке будет выбрана единственная запись, а в числе доступных будут только расчётные столбцы и столбцы с собственным SQL-выражением.
Внешний вид документа
Внешний вид документа определяется следующими элементами:
- Структурой содержимого документа.
- Заданными для документа параметрами страницы (в случае, если выбранный экспортёр их использует).
- Выбранным для формирования экспортёром документа, и, соответственно, форматом файла и связанными с ним ограничениями.
Структура содержимого документа
Содержимое документа составляется из блоков, называемых бэндами. Каждый бэнд представляет собой горизонтальную полосу во всю ширину документа; высота бэнда определяется его типом и содержимым. Бэнды бывают нескольких типов:
- Текстовые бэнды — текстовый блок, заголовок файла, завершение файла, верхний колонтитул и нижний колонтитул.
У каждого бэнда может быть задано наименование, используемое при проектировании структуры документа и в сообщениях об ошибках. Кроме того, в зависимости от типа у бэнда может задаваться ещё ряд характеристик (набор столбцов для табличных бэндов, текст содержимого для текстовых и тому подобное). Набор бэндов документа, их свойства и порядок следования проектируются визуально с помощью специального дизайнера, находящегося в диалоге свойств выходного документа.
Параметры страницы
Параметры страницы имеют смысл для некоторых форматов файлов и включают в себя размер бумаги, её ориентацию, поля печати и способ нумерации страниц. Они задаются в диалоге параметров страницы выходного документа.
Экспортёр документа
Универсальность отчётной системы iSZN позволяет формировать большинство документов в более чем один формат. Достигается это использованием набора специальных модулей — экспортёров документа, каждый из которых формирует файл своего формата. Поскольку форматы файлов данных сильно отличаются по возможностям оформления (форматирования) информации (например, бессмысленно говорить о шрифтах в простом текстовом файле), то становится очевидно, что набор учитываемых характеристик выходного документа также зависит от выбранного для формирования документа экспортёра. Подробно данные ограничения перечислены в описании каждого конкретного экспортёра.
Критерии документа
В зависимости от заданных параметров первичная выборка документа может требовать задания критериев, которое производится с помощью соответствующего выборке редактора критериев. Критерии позволяют ограничить набор выбираемых записей путём определения условий, которым эти записи должны соответствовать.
Параметры документа
Более тонкая настройка поведения компонентов отчётной системы при формировании документа может быть выполнена путём задания значений параметров документа; с их помощью можно указать, например, на необходимость запрашивания способа сортировки документа непосредственно перед его формированием, переопределить имя или расширение выходного файла, ограничить список форматов, в которые допустимо формировать документ или задать значения по умолчанию для вводимых при формировании параметров.