...
| Parametername | Verwendungszweck | Beispiel | ||
|---|---|---|---|---|
| Name | Interner Name der Vorlage. Dieser Name wird u.a. verwendet, um aus der auf sem Server hinterlegten .jrxml-Datei die ausführbaren Dateien zu erzeugen.
| 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 | ||
| Recht | Auswahl eines (funktionalen, nicht gruppierungsbeschränkten) Rechts, über das ein Benutzer verfügen muss, um den Report ausführen zu können. | |||
| Standard Ergebnistyp | Standard Mime-Typ des Ergebnisses (PDF, XLS). Ab Version 1.5.1.6, Unterstützung bei der Reportausführung (Gruppierung), ab Version 1.5.1.7 |
Vorlagen verwalten - Dateien ersetzen
...
Bilddateien - wie etwa Logos - die im Report verwendet werden, müssen ins Build-Verzeichnis (z.B. /home/jboss/reports/build) kopiert werden und die Pfade im Report müssen entsprechend gesetzt werden (nicht absolut angeben).
Style Dateien
Für Style-Dateien (.jrtx) gilt das gleiche, wie für Bilddateien. Die Style-Datei muss im "/build" Unterverzeichnis abgelegt sein, da der Report im Build-Verzeichnis erzeugt wird und die referenzierte Style-Datei von hier aus relativ gefunden werden muss.
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:
...
Zum Ausführen von gruppierungsspezifischen Reports siehe Reports (Gruppierung).
| Info |
|---|
Ab Version 1.5.1.5 gibt wird nur noch ein Link angeboten. "Ausführen generisch". Das Formular enthält jetzt die Auswahl für den Ergebnistyp (PDF oder xls). |
Reportparameter
Ab Version 1.5.1.5 unterstützt das System die Verwendung von Reportparametern. Dazu muss der Systemparameter "REPORT_USE_ICA_PARAMTER" gesetzt sein (siehe auch: Systemkonfiguration)
Bei Anlage, bzw. Änderung eines Reports werden die Reportparameter ausgelesen und in der Datenbank abgelegt.
Bedeutung
Für jeden Reportparameter können folgende Werte bestimmt werden:
| Feld | Bedeutung | |
|---|---|---|
| Anzeigename | Abweichender Name für den Parameter bei Ausführung des Reports (nur für die Anzeige). Der vom Benutzer eingegebene Wert wird dem Report nach wie al "Parameter Name" übergeben | |
| Reihenfolge | Reihenfolge, in der der Parameter im Eingabeformular angezeigt werden soll | |
| Parametertyp |
|
Geändertes Verhalten bei Verwendung von Reportparametern
Wenn ein Report ausgeführt wird
Rechte
Für die Verwaltung der Report-Parameter werden die Rechte (ID Menu: 150 und zugehörige ID Rechte) benötigt. Für die automatische Anlage, bzw. Aktualisierung reicht das entsprechende Report Recht.
Jasper Report Versionen
Stand: 09.04.2019
| ICA Version | Jasper Report Engine (Version der jrxml Datei) | Entwicklungsumgebung Reports | Bemerkungen |
|---|---|---|---|
| ica-1.5.x | bis Version 5.5 (jrxml Dateien mit Versionsformat 5.1 bis 5.5) |
|