...
Nachdem ein Report als .jrxml-Datei erstellt wurde (s.u.), muss er zuerst physisch auf den Serverder Report physisch an der definierten Stelle im Dateisystem abgelegt werden; es ist im Moment nicht möglich, Reports direkt hochzuladen.
Damit Vorlagen verwendet werden können, müssen diese dem System über die Module/JasperReports Tabelle anschließend bekannt gemacht werden, indem im Interface ein neuer Report angelegt wird. Folgende Parameter müssen definiert sein:
| Parametername | Verwendungszweck | Beispiel |
|---|---|---|
| Name | Intern: Interner Name der Vorlage zur Identifikation im System-Logging. Es sind nur alphanumerische Zeichen zulässige. Keine Leerzeichen. Das Name muss eindeutig sein. | musterReport20 |
| Beschreibung | Beschreibung des Reports | |
| Dateipfad | Absoluter Pfad der .jrxml Datei auf dem Server | /home/jboss/reports/musterTemplate.jrxml |
| XML-Datei | nicht implementiert | muss leer bleiben |
| Report-Klasse | System-Klasse, für die der Report verwendet werden kann. | de.iconcept.nami.entity.abrechnung.Rechnung |
| Subreport-ID | Kontext-spezifische ID eines Report anhand einer übergebenen Kontextvariablen. Beispiel: Bei der Erstellung einer Ausgangsrechnung wird als Kontext-ID die ID der Gruppierung, die die Ausgangsrechnung erstellt hat, übergeben. Existiert nun ein Eintrag mit der Subreport-ID 20, dann wird nicht die Standardvorlage verwendet, sondern die spezifische Vorlage. | 20 |
Die Übersetzung der . Report-Dateien erfolgt im Verzeichnis
...
nicht gelöscht wurden, werden die "alten" Dateien weiterverwendet.
Erstellen von Reports
Software zum Erstellen von Reports
Alle Vorlagen (.jrxml) können mit dem iReport-Designer (ab Version 5.1) der JasperSoft Community (siehe http://community.jaspersoft.com/project/ireport-designer) bearbeitet werden.
...
| Info |
|---|
Hinweis: Für die Sortierung der Parameter der Eingabemaske zum Ausführen des Reports verwendet das System immer alphabetisch bzw. numerisch aufsteiegende Sortierung. Um eine sinnvolle Sortierung der Felder in der Maske zu erreichen, können beim Erstellen des Reports den einzelnen Feldern bzw. deren Labels z.B. Buchstaben oder Zahlen vorangestellt werden. |
Schriften
Bei Änderungen an den Reports sollte unbedingt darauf geachtet werden, dass nicht alle Schriftarten (Fonts), die ggf. im Report Designer angeboten werden, verwendbar sind. Verwendet werden können nur diejenigen Schriftarten, die auf dem Server, auf dem der Report später erzeugt wird, auch installiert sind. Da die Font-Dateien sind nicht Bestandteil der Reportvorlage sind (da die Weitergabe von Fonts ggf. rechtlichen Beschränkungen unterliegen kann), sollte die Reporterzeugung in jedem Fall auf dem Zielsystem geprüft werden.
...
| Tip |
|---|
Sollen andere Schriften als die Standardschriften verwendet werden, dann sollte vorab geprüft werden, ob diese auf dem Server System installiert sind (Kommandozeile: fc-list :lang=DE). |
Standardschriften
Die JasperReport Biliotheken verwenden die iText Bibliotheken, um die Schriften zu rendern. Folgende Schriften funktionieren damit in jedem Fall:
Courier
Courier-Bold
Courier-BoldOblique
Courier-Oblique
Helvetica
Helvetica-Bold
Helvetica-BoldOblique
Helvetica-Oblique
Symbol
Times-Roman
Times-Bold
Times-BoldItalic
Times-Italic
ZapfDingbats
Beispieldatenbank
Eine Beispieldatenbank dient dazu, sich die Ergebnisse von Änderungen an Vorlagen sinnvoll ansehen zu können. Beispieldatenbank auf dem Produktivsystem erzeugen über folgende shell-Kommandos:
...