jasper-reports учебник
Начало работы с отчетами о яшме

замечания

Версии

Установка или настройка

Библиотека JasperReports

JasperReports - это инструмент для создания отчетов на основе Java с открытым исходным кодом. Библиотека JasperReports может быть загружена из сообщества Jaspersoft для последней версии .

В последних выпусках сторонние банки в папке lib не распространяются, их нужно загружать из общедоступных репозиториев, см. pom.xml распределенного pom.xml для зависимостей. Maven может использоваться для извлечения всех зависимостей, включая переходные, в папку целевых / зависимых.

mvn dependency:copy-dependencies

Jaspersoft Studio (IDE)

Jaspersoft Studio является официальным клиентом дизайна для JasperReports - построена на платформе Eclipse - для замены iReport Designer.

iReport Designer (IDE)

iReport Designer - это предыдущий разработчик отчетов для JasperReports. Версия 5.6.0 (выпущенная в мае 2014 года) была последней официальной версией; поддержка поставщиков закончилась в конце 2015 года.

Ресурсы JasperReport Commuity

Часто задаваемые вопросы о библиотеке JasperReports

• Часто задаваемые вопросы

Исходный код

• Исходный код библиотеки JasperReports

Учебники

• Точки обучения
• Руководство пользователя JasperReports

образцы

• Образец ссылки

Рекомендации

• Официальная документация
• Сообщество

Официальный трекер

• Баг трекер

Рабочий поток

Рабочий поток в отчетах яшмы:

1. Создайте отчет, создайте файл jrxml, определяющий макет отчета. Jrxml можно создать с помощью простого текстового редактора, но обычно IDE (JasperSoft Studio или iReport) используется как для ускорения разработки отчетов, так и для визуального представления макета.

2. Скомпилируйте отчет (jrxml), чтобы получить файл .jasper или объект JasperReport . Этот процесс можно сравнить с файлом .java , скомпилированным в .class .

3. Заполните отчет , передайте параметры и источник данных в отчет для создания объекта печати JasperPrint, который также можно сохранить в файле .jprint

4. Просмотрите, распечатайте и / или экспортируйте JasperPrint. Наиболее распространенный формат экспорта поддерживается как pdf, excel, word, html, cvs и т. Д.

Понимание различных диапазонов отчетов

заглавие

Эта группа показана один раз в начале отчета. Его можно использовать как первую страницу, установив атрибут isTitleNewPage="true"

Заголовок страницы

Это появляется в начале каждой страницы, исключая первую страницу, если используется полоса заголовка, и последняя страница, если используется isSummaryWithPageHeaderAndFooter="false" с настройкой isSummaryWithPageHeaderAndFooter="false"

Заголовок столбца

Это отображается перед диапазоном деталей на каждой странице.

подробность

Этот раздел повторяется для каждой записи в поставляемом источнике данных. Разрешено иметь несколько полос деталей (деталь 1, деталь 2 .. деталь n), они повторяются следующим образом

Row 1
    detail 1
    detail 2
    detail n
Row 2
    detail 1
    detail 2
    detail n

Нижний колонтитул

Это появляется ниже диапазона деталей на каждой странице, где присутствует подробная полоса. Значение по умолчанию - конец страницы (до нижнего колонтитула страницы), но это может быть переключено на последний диапазон данных (последняя запись), установив атрибут isFloatColumnFooter="true"

Нижний колонтитул страницы

Это отображается внизу каждой страницы, за исключением полосы заголовка, сводной полосы (без нижнего колонтитула страницы) и последней не суммируемой полосы, если используется нижний колонтитул последней страницы.

Последняя нижняя колонтитула страницы

Это отображается на последней странице (если не сводная таблица без нижнего колонтитула страницы) вместо обычного нижнего колонтитула страницы

Резюме

Это появляется в конце отчета на новой странице, если isSummaryNewPage="true" задано и с заголовком и нижним колонтитулом страницы, если isSummaryWithPageHeaderAndFooter="true"

Заголовок группы

Этот раздел появляется, если группа определяется каждый раз, когда выражение группы изменяется, перед полосой детали.

Нижний колонтитул группы

Этот раздел появляется, если группа определяется каждый раз до изменения группового выражения после группы деталей.

Фон

Эта полоса отображается на каждой странице в качестве фона для всех других диапазонов.

Нет данных

Это появляется только в том случае, если источник данных не передан или источник данных пуст (0 записей), а whenNoDataType="NoDataSection" .

Форматы файлов отчета Jasper

• .jrxml - это файл дизайна отчета, его формат находится в человеко-читаемом XML, его можно выполнить в объект JasperReport и сохранить как .jasper

• .jasper - это скомпилированная версия .jrxml и может быть загружена непосредственно в объект JasperReport готовый к заполнению данными

• .jrprint - это сериализованный объект JasperPrint , отчет, который уже заполнен данными и может быть загружен для печати, просмотра и / или экспорта в желаемый формат.

• .jrpxml - это XML-представление о объекте JasperPrint которое может быть изменено, а затем немаршалировано для извлечения объекта JasperPrint