JasperReports е инструмент за отчети с отворен код за Java, който генерира доклади за приложения. Този инструмент за докладване поддържа експортиране на богато съдържание на отчети към екрани, принтери или различни файлови формати като HTML, PDF, XLS, RTF, CSV, XML, ODT и TXT.
JasperReports може да се използва и за приложения с Java като Java EE или уеб приложения за генериране на динамично съдържание.
Инсталирай JasperReports
Инсталирайте Jasper Reports Community Edition оттук.
https://community.jaspersoft.com/community-download
Структура на доклада Jasper
Шаблонът за отчет .jrxml се състои от следните части, както е показано на диаграмата по-долу.
1. Заглавието съдържа "заглавието" на доклада. Появява се само веднъж в началото на доклада. Например, докладът се нарича "Студентски доклад".
2. Заглавието на страницата може да включва информация за дата и час или името на институцията. Той се показва в горната част на всяка страница. Например: заглавието на страницата може да бъде "Студентски записи".
3. Заглавията на колоните показват имената на конкретни полета, които трябва да се показват в доклада, като "Student ID", "Student Name", "Student Address" и др.
4. Подробната информационна секция показва записи за конкретни области. Например: Student ID=101, Student Name="den peek", Student Address="Pune".
5. Колонните основачи могат да показват сумата на всяко поле. Например, "Общо време за учене: 6 часа на ден."
6. Долният лист може да съдържа информация за номера на страницата. Тя се показва в долната част на всяка страница, например: "Страници номера 1, 2, 3 и всички номера на страници."
7. Резюме: Резюме на доклада, написано поне веднъж в резюмето.
JasperReports — Жизнен цикъл
Проектиране на доклада — В тази стъпка ще създадем JRXML файл, който е XML документ, съдържащ дефиницията за оформление на доклада.
Компилационен доклад - В тази стъпка JRXML се компилира в двоичен обект на име Jasper (*.jasper).
Попълване на данни в отчети — в тази стъпка данните от приложението се попълват в компилирания доклад. Класът net.sf.jasperreports.engine.JasperFillManager предоставя необходимите функции за попълване на данните от отчета. Системата създава Jasper файл за печат (*.jrprint), който може да се използва за печат или експортиране на отчети.
Export Report - В тази стъпка можем да използваме JasperExportManager, за да експортираме файла за печат на Jasper, създаден в предишната стъпка, във всеки формат.
API клас
Съществуват много класове за компилиране на JRXML отчетни дизайни, попълване на отчети, отпечатване на отчети и експортиране като PDF, HTML и XML файлове.
Какво съдържание се съдържа в пакета (net.sf.jasperreports.engine)?
· JasperCompileManager — Използва се за компилиране на JRXML шаблони за отчети.
· JasperFillManager — Използва се за попълване на отчети, използвайки данни от източници на данни.
· JasperPrintManager — Използва се за печат на документи, генерирани от библиотеката JasperReports.
· JasperExportManager — Използва се за получаване на PDF, HTML или XML съдържание на документи, генерирани по време на процеса на попълване на доклади.
Източник на данни
Източникът на данни е структуриран контейнер за данни. При генериране на отчети, двигателят JasperReports извлича данни от източника на данни. Данните могат да бъдат получени от бази данни, XML файлове, масиви от обекти и колекции от обекти.
Таблицата по-долу обобщава източниците на данни и техните класове на имплементация—
Елементи от данни на Jasper Reports
Параметри: $P
$P{parameter_name)
· Използва се за индивидуални ценности в доклада.
· Данните, които не могат да бъдат предадени през източника на данни, могат да бъдат предадени чрез параметри. Например, заглавия на доклади и други данни.
· JasperReports шаблоните или JRXML шаблоните могат да съдържат нула или повече параметрични елементи.
Поле: $F
$F{field_name}
· Полетата за отчети са елементи, които представят съпоставянето на данни между източници на данни и шаблони за доклади.
Използва се за промяна на стойности във всяка итерация, или с други думи, за представяне на ред данни в таблица.
Променлива: $V
$V{variable_name}
· Тя се предоставя от Jasper Reports.
Използва се и за извършване на изчисления върху отчети на Джаспър, като аритметични операции.
Стъпки за създаване на какъвто и да е отчет на Jasper
1. Проектирайте шаблона чрез копиране на jrxml файла в папката Spring Resources
2. Създайте необходимите параметри
3. Създаване на източници на данни
4. Компилиране на шаблона .jrmxl, съхранен в обекта JasperReport
5. Попълнете доклада — като предайте компилирани .jrxml обекти, параметри и източници на данни.
6. Експортни отчети — Използвайте JasperExportManager
Пример за SpringBoot — JasperReports
Добавете зависимости от Maven.
Контролер
Служба
emp24.jrxml
След стартиране ще получите генерирания доклад.http://localhost:8990/empapp/api/v1/reports/jasper/emp24?fileType=doc
JasperReports — Пример за представяне на подотчет
За подотчети отворете съществуващия шаблон emp.jrxml и добавете друг шаблон user.jrxml като подотчет.
За да добавите доклад за дете към основния доклад, отворете основния доклад, кликнете върху доклада за детето от панела, плъзнете го в областта за обобщение и въведете следните детайли.
Изберете "Create only child report elements", след това натиснете "Next."
Не използвайте никакви връзки към база данни, след това преминете към следващата стъпка и приключете.
Кликнете с десен бутон > подравнете > адаптирате към формат на ширина/таблица
За подотчетите на User.jrxml ще предаваме подотчетни данни от основния отчет като параметър. За да постигнем това, ни трябват ......
Създайте нов параметър като subReport и типа данни JasperReport, както е в основния отчет
Създаване на нови параметри за subDatasource и тип данни JRBeanCollectionDataSource
Създаване на нови параметри подПараметри и тип данни Map
Сега отворете свойствата на подотчета
Елиминирайте $P{REPORT_CONNECTION}
Израз: $P{subReport}
Израз за картографиране на параметри: $P{subParameters}
Израз на източника на данни: $P{subReportDataSource}
Сега всички данни, които предаваме като параметър, ще бъдат попълнени в подотчета.
Примерен код
empSubreport.jrxml
Тествайте го:http://localhost:8990/empapp/api/v1/reports/jasper/subreport?fileType=pdf
Препратка:Входът към хиперлинк е видим.
Оригинален:Входът към хиперлинк е видим. |
Публикувано вПреди 28 секунди
|
|
|
|
