JasperReports je open-source nástroj na reportovanie pre Javu, ktorý generuje aplikačné reporty. Tento nástroj na reportovanie podporuje export bohatého obsahu reportov na obrazovky, tlačiarne alebo rôzne formáty súborov, ako sú HTML, PDF, XLS, RTF, CSV, XML, ODT a TXT.
JasperReports je možné použiť aj pre aplikácie s podporou Javy, ako je Java EE alebo webové aplikácie na generovanie dynamického obsahu.
Inštalujte JasperReports
Nainštalujte Jasper Reports Community Edition odtiaľto.
https://community.jaspersoft.com/community-download
Štruktúra správy Jasper
Šablóna správy .jrxml pozostáva z nasledujúcich častí, ako je znázornené na diagrame nižšie.
1. Názov obsahuje "nadpis" správy. Objavuje sa len raz na začiatku správy. Napríklad správa nesie názov "Študentská správa".
2. Názov stránky môže obsahovať informácie o dátume a čase alebo názov inštitúcie. Zobrazuje sa na vrchu každej stránky. Napríklad: názov stránky môže byť "Študentské záznamy."
3. Hlavičky stĺpcov uvádzajú názvy konkrétnych polí, ktoré sa majú zobrazovať v správe, ako napríklad "Študentské ID", "Študentské meno", "Študentská adresa" a podobne.
4. Sekcia podrobných informácií zobrazuje záznamy pre konkrétne polia. Napríklad: Študentské ID=101, Študentské meno="Den Peek", Študentská adresa="Pune".
5. Základy stĺpca môžu zobrazovať súčet ľubovoľného poľa. Napríklad: "Celkový čas na štúdium: 6 hodín denne."
6. Päta môže obsahovať informácie o čísle strany. Zobrazuje sa na spodku každej stránky, napríklad: "Čísla strán 1, 2, 3 a všetky čísla strán."
7. Abstrakt: Zhrnutie správy, napísané aspoň raz v abstrakte.
JasperReports — Životný cyklus
Navrhnúť report — V tomto kroku vytvoríme súbor JRXML, čo je XML dokument obsahujúci definíciu rozloženia reportu.
Kompilácia správy – V tomto kroku sa JRXML kompiluje do binárneho objektu s názvom Jasper (*.jasper).
Vypĺňanie dát do reportov – v tomto kroku sa údaje z aplikácie vkladajú do kompilovanej správy. Trieda net.sf.jasperreports.engine.JasperFillManager poskytuje potrebné funkcie na vyplnenie dát reportov. Systém vytvorí tlačový súbor Jasper (*.jrprint), ktorý sa dá použiť na tlač alebo export správ.
Export Report – V tomto kroku môžeme použiť JasperExportManager na export tlačového súboru Jasper vytvoreného v predchádzajúcom kroku do akéhokoľvek formátu.
API trieda
Existuje mnoho tried na zostavovanie návrhov správ v JRXML, vypĺňanie správ, tlač správ, ich export do PDF, HTML a XML súborov.
Aký obsah obsahuje balík (net.sf.jasperreports.engine)?
· JasperCompileManager — Používa sa na kompiláciu šablón JRXML reportov.
· JasperFillManager — Používa sa na vypĺňanie reportov pomocou dát z dátových zdrojov.
· JasperPrintManager — Používa sa na tlač dokumentov generovaných knižnicou JasperReports.
· JasperExportManager — Používa sa na získavanie PDF, HTML alebo XML obsahu dokumentov generovaných počas procesu vypĺňania správ.
Zdroj dát
Zdroj dát je kontajner štruktúrovaných dát. Pri generovaní reportov engine JasperReports získava dáta zo zdroja dát. Dáta je možné získať z databáz, XML súborov, objektových polí a objektových kolekcií.
Tabuľka nižšie zhrňuje zdroje dát a ich implementačné triedy—
Dátové prvky Jasper Reports
Parametre: $P
$P{parameter_name)
· Používa sa pre jednotlivé hodnoty v správe.
· Dáta, ktoré nie je možné preniesť cez zdroj dát, môžu prechádzať cez parametre. Napríklad názvy hlásení a ďalšie údaje.
· Šablóny JasperReports alebo JRXML môžu obsahovať nulový alebo viac prvkov parametrov.
Ihrisko: $F
$F{field_name}
· Polia reportov sú prvky, ktoré reprezentujú mapovanie dát medzi zdrojmi údajov a šablónami reportov.
Používa sa na zmenu hodnôt v každej iterácii, alebo inými slovami, na reprezentáciu riadku údajov v tabuľke.
Premenná: $V
$V{variable_name}
· Poskytuje ho Jasper reports.
Používa sa tiež na výpočty na Jasper reportoch, ako sú aritmetické operácie.
Kroky na vytvorenie akéhokoľvek Jasper reportu
1. Navrhnúť šablónu skopírovaním súboru jrxml do priečinka Spring Resources
2. Vytvoriť požadované parametre
3. Vytváranie dátových zdrojov
4. Skompilovať šablónu .jrmxl uloženú v objekte JasperReport
5. Vyplniť správu – odoslaním kompilovaných .jrxml objektov, parametrov a zdrojov dát.
6. Exportné správy — Použite JasperExportManager
Príklad SpringBootu — JasperReports
Pridajte Maven závislosti.
Kontrolér
Služba
emp24.jrxml
Po spustení dostanete vygenerovanú správu.http://localhost:8990/empapp/api/v1/reports/jasper/emp24?fileType=doc
JasperReports — Príklad reprezentácie podsprávy
Pre podreporty otvorte existujúcu šablónu emp.jrxml a pridajte ďalšiu šablónu user.jrxml ako podreport.
Ak chcete pridať podriadenú správu do hlavnej správy, otvorte hlavnú správu, kliknite na podriadenú správu v paneli, presuňte ju do oblasti súhrnu a zadajte nasledujúce údaje.
Vyberte "Vytvoriť len podriadené reportové prvky" a potom kliknite na "Ďalej".
Nepoužívajte žiadne databázové pripojenia, potom prejdite na ďalší krok a dokončite to.
Kliknite pravým tlačidlom > zarovnajte > prispôsobte formát šírky/tabuľky
Pre podreporty User.jrxml budeme odovzdávať subreport dáta z hlavnej správy ako parameter. Aby sme to dosiahli, potrebujeme ......
Vytvorte nový parameter ako subReport a dátový typ JasperReport ako v hlavnom reporte
Vytvorte nové parametre pre podDatasource a dátový typ JRBeanCollectionDataSource
Vytvorte nové parametre subParameters a dátový typ Map
Teraz otvorte vlastnosti subreportu
Eliminujte $P{REPORT_CONNECTION}
Výraz: $P{subReport}
Výraz mapovania parametrov: $P{subParameters}
Výraz zdroja dát: $P{subReportDataSource}
Teraz sa všetky dáta, ktoré odovzdáme ako parameter, napíšu do podreportu.
Ukážkový kód
empSubreport.jrxml
Otestujte ho:http://localhost:8990/empapp/api/v1/reports/jasper/subreport?fileType=pdf
Referencia:Prihlásenie na hypertextový odkaz je viditeľné.
Originál:Prihlásenie na hypertextový odkaz je viditeľné. |
ZverejnenéPred 28 sekundami
|
|
|
|
