История страницы

Для построения отчётов в программе Отчёты с помощью JasperReports Library достаточно указать в своём модуле наборе шаблонов в файле reports.conf значение параметра definition.class в extensions.reports.GenericJasperReportDefinition. Это имя программного компонента (Java-класса) базовой реализации шаблона отчёта, который позволяет формировать отчёт средствами JasperReports Library по шаблону в форме *.jasper-файла.

...

1. Анализирует *.jasper-файл шаблона отчёта и получает из него список параметров, которые должны быть заданы при формировании отчёта:
   1. в список параметров попадают те, для которых в Jasper-шаблоне задан флаг Is For Prompting;
   2. описание параметра (поле Description в Jasper-шаблоне) используется для текста надписи в форме ввода параметров;
   3. тип данных параметра определяется свойством Class в Jasper-шаблоне.
2. Для каждого параметра выбирает оптимальное поле ввода в соответствии с заданными для параметра свойствами (см. Привязка полей ввода).
3. Генерирует форму ввода параметров из соответствующих полей ввода.
4. Обрабатывает введённые пользователем значения параметров и передаёт их JasperReports Library для генерации отчёта по шаблону.

...

JasperReports

В директории шаблона в модуле наборе должен быть размещён хотя бы один *.jasper-файл. Имя файла должно быть указано в файле report.conf в параметре definition.jasper.design.

Для всех Jasper-параметров в шаблоне, которые должен ввести пользователь, должен быть задан флаг Is For Prompting равный true. Для таких параметров также должно быть задано свойство с именем класса поля ввода (см. Привязка полей ввода).

В Jasper-шаблоне необходимо определить системный параметр DEFINITION_DIR типа java.lang.String, для которого установить флаг Is For Prompting равный false. В данный параметр базовая реализация передаст абсолютный путь к директории с файлами шаблона (директории, в которой находятся *.jasper-файлы и другие файлы шаблона). Это значение необходимо, например, при использовании подотчётов — чтобы указать корректный путь к *.jasper-файлу подотчёта.

Все Java-классы, кроме классов API и классов стандартной библиотеки, которые используются в Jasper-шаблоне (например, для форматирования вывода данных), должны быть помещены в форме *.jar-библиотек в директорию libs модуля набора шаблонов.

Возможности

В данном разделе описаны возможности, которые предоставляет базовая реализация для создания шаблонов.

...