JasperReports je open-source nástroj pro reportování pro Javu, který generuje aplikační reporty. Tento nástroj pro reportování podporuje export bohatého obsahu reportů na obrazovky, tiskárny nebo různé formáty souborů, jako jsou HTML, PDF, XLS, RTF, CSV, XML, ODT a TXT.
JasperReports lze také použít pro aplikace s podporou Javy, jako je Java EE nebo webové aplikace pro generování dynamického obsahu.
Nainstalovat JasperReports
Nainstalujte Jasper Reports Community Edition zde.
https://community.jaspersoft.com/community-download
Struktura Jasperova reportu
Šablona zprávy .jrxml se skládá z následujících částí, jak je znázorněno na diagramu níže.
1. Název obsahuje "titulek" zprávy. Objeví se pouze jednou na začátku zprávy. Například zpráva se jmenuje "Studentská zpráva".
2. Název stránky může obsahovat informace o datu a čase nebo název instituce. Je zobrazen v horní části každé stránky. Například: název stránky může být "Studentské záznamy."
3. Hlavičky sloupců uvádějí názvy konkrétních polí, která se ve zprávě zobrazí, například "Student ID", "Student Name", "Student Address" atd.
4. Sekce podrobných informací zobrazuje záznamy pro konkrétní pole. Například: Student ID=101, Jméno studenta="Den Peek", Studentská adresa="Pune".
5. Sloupové paty mohou zobrazovat součet libovolného pole. Například "Celkový čas studia: 6 hodin denně."
6. Pata může obsahovat informace o čísle stránky. Zobrazuje se na konci každé stránky, například: "Čísla stran 1, 2, 3 a všechna čísla stránek."
7. Abstrakt: Shrnutí zprávy, napsané alespoň jednou v abstraktu.
JasperReports — Životní cyklus
Navrhněte report — V tomto kroku vytvoříme soubor JRXML, což je XML dokument obsahující definici rozložení reportu.
Kompilační zpráva – V tomto kroku je JRXML zkompilován do binárního objektu jménem Jasper (*.jasper).
Vyplňování dat do reportů – v tomto kroku jsou data z aplikace vložena do sestavené zprávy. Třída net.sf.jasperreports.engine.JasperFillManager poskytuje potřebné funkce k vyplnění dat zpráv. Systém vytvoří tiskový soubor Jasper (*.jrprint), který lze použít k tisku nebo exportu reportů.
Export Report – V tomto kroku můžeme použít JasperExportManager k exportu tiskového souboru Jasper vytvořeného v předchozím kroku do libovolného formátu.
API třída
Existuje mnoho tříd pro sestavování návrhů JRXML zpráv, vyplňování reportů, tisk zpráv, jejich export do PDF, HTML a XML souborů.
Jaký obsah obsahuje balíček (net.sf.jasperreports.engine)?
· JasperCompileManager — Používá se k kompilaci šablon JRXML reportů.
· JasperFillManager — Používá se k vyplňování reportů pomocí dat ze zdrojů dat.
· JasperPrintManager — Používá se k tisku dokumentů generovaných knihovnou JasperReports.
· JasperExportManager — Používá se k získávání PDF, HTML nebo XML obsahu dokumentů generovaných během vyplňování zpráv.
Zdroj dat
Datový zdroj je strukturovaný datový kontejner. Při generování reportů engine JasperReports získává data ze zdroje. Data lze získat z databází, XML souborů, objektových polí a objektových kolekcí.
Tabulka níže shrnuje zdroje dat a jejich implementační třídy—
Datové prvky Jasper Reports
Parametry: $P
$P{parameter_name)
· Ve zprávě se používá pro jednotlivé hodnoty.
· Data, která nelze předávat přes zdroj dat, mohou být předávána přes parametry. Například názvy zpráv a další data.
· Šablony JasperReports nebo JRXML mohou mít nulový nebo více parametrových prvků.
Pole: $F
$F{field_name}
· Reportová pole jsou prvky, které představují datové mapování mezi datovými zdroji a šablonami reportů.
Používá se ke změně hodnot v každé iteraci, jinými slovy, k reprezentaci řádku dat v tabulce.
Proměnná: $V
$V{variable_name}
· Poskytuje ji Jasper reports.
Používá se také k provádění výpočtů na Jasper reportech, například aritmetických operací.
Kroky k vytvoření jakéhokoli Jasper reportu
1. Navrhněte šablonu zkopírováním souboru jrxml do složky Spring Resources
2. Vytvořte požadované parametry
3. Vytvářet datové zdroje
4. Zkompilujte šablonu .jrmxl uloženou v objektu JasperReport
5. Vyplnit zprávu – předáním kompilovaných .jrxml objektů, parametrů a datových zdrojů.
6. Exportní zprávy — Použijte JasperExportManager
Příklad SpringBootu — JasperReports
Přidejte závislosti Maven.
Řídicí jednotka
Služba
emp24.jrxml
Po spuštění obdržíte vygenerovanou zprávu.http://localhost:8990/empapp/api/v1/reports/jasper/emp24?fileType=doc
JasperReports — Příklad reprezentace podzprávy
Pro podreporty otevřete existující šablonu emp.jrxml a přidejte další šablonu user.jrxml jako subreport.
Chcete-li přidat podřízenou zprávu do hlavní zprávy, otevřete hlavní zprávu, klikněte na podřízenou zprávu v panelu, přetáhněte ji do souhrnné oblasti a zadejte následující údaje.
Vyberte "Vytvořit pouze podřadné reportové prvky" a klikněte na "Další".
Nepoužívejte žádná připojení k databázi, pak přejděte k dalšímu kroku a dokončete to.
Klikněte pravým tlačítkem > zarovnání > přizpůsobení formátu šířky/tabulky
Pro subreporty User.jrxml budeme předat data subreportů z hlavní reporty jako parametr. Abychom toho dosáhli, potřebujeme ......
Vytvořte nový parametr jako subReport a datový typ JasperReport jako v hlavním reportu
Vytvořte nové parametry pro subDatasource a typ data JRBeanCollectionDataSource
Vytvořte nové parametry subParametry a datové typy Map
Nyní otevřete vlastnosti podreportu
Eliminujte $P{REPORT_CONNECTION}
Výraz: $P{subReport}
Výraz pro mapování parametrů: $P{subParameters}
Výraz datového zdroje: $P{subReportDataSource}
Nyní budou všechna data, která předáme jako parametr, vyplněna do podreportu.
Ukázkový kód
empSubreport.jrxml
Otestujte ho:http://localhost:8990/empapp/api/v1/reports/jasper/subreport?fileType=pdf
Odkaz:Přihlášení k hypertextovému odkazu je viditelné.
Původní:Přihlášení k hypertextovému odkazu je viditelné. |
ZveřejněnoPřed 28 sekundami
|
|
|
|
