Zusätzliche JasperReport-Handler-Funktionen

Wenn Sie den JasperReport-Stereotyp einem Handlerabschnitt hinzufügen, machen Sie dadurch automatisch eine Reihe impliziter EGL-Funktionen verfügbar. Die JasperReports-Designdatei kann zusätzlich die interne Java™-Methode getDataSource() aufrufen.

JasperReports unterscheidet zwischen drei Typen von Entitäten, die von der Berichtsengine während der Ausführung ausgewertet werden:

Sie können jede der impliziten Funktionen in den folgenden Abschnitten aus dem JasperReport-Handler heraus aufrufen. Rufen Sie getDataSource(), die interne EGL-Java-Methode, in der XML-Designdateiquelle auf.

Funktion zum Abrufen von Berichtsparametern

Funktion Beschreibung
getReportParameter (parameter STRING in) Gibt den Wert des angegebenen Parameters aus dem Bericht zurück, der mit Daten gefüllt wird. Der zurückgegebene Wert hat den Typ ANY.

Funktionen zum Festlegen und Abrufen von Berichtsvariablen

Sie können die folgenden Funktionen während der Ausführung verwenden, um auf Variablen zuzugreifen, die im Bericht verwendet werden.

Funktion Beschreibung
getReportVariableValue (variable STRING in) Gibt den Wert der angegebenen Variablen aus dem Bericht zurück, der mit Daten gefüllt wird. Der zurückgegebene Wert hat den Typ ANY.
setReportVariableValue (variable STRING in, value Any in) Ordnet den Wert der angegebenen Variablen zu.

Funktion zum Abrufen von Feldwerten

Sie können die folgende Funktion verwenden, um auf aktuelle Felder im Bericht zuzugreifen.

Funktion Beschreibung
getFieldValue (fieldName STRING in) Gibt den Wert des angegebenen Feldes für die Zeile zurück, die gerade verarbeitet wird. Der zurückgegebene Wert hat den Typ ANY.

Funktionen zum Speichern oder Abrufen von Daten für Unterberichte

Ein Unterbericht ist ein Bericht, den Sie aus einem anderen Bericht heraus aufrufen. Zur Übergabe von Daten an einen Unterbericht speichert der JasperReport-Handler die Informationen zunächst mit der Funktion addReportData(). Die JasperReports-Engine kann diese Daten mithilfe der Methode getDataSource() abrufen. Siehe "Verfügbare Java-Methoden für die Berichtsdesigndatei" in diesem Abschnitt. Zum Abrufen zuvor im JasperReport-Handler gespeicherter Daten verwenden Sie die funktional entsprechende Funktion getReportData().

Funktion Zweck
addReportData (rd ReportData in, dataID String in) Ordnet Daten (wie sie in einer Variablen 'ReportData' gespeichert sind) mit dem Namen dataID zu.
getReportData (dataID String in) Ruft Daten ab, die zuvor mithilfe von 'addReportData()' unter dataID gespeichert wurden. Die Funktion 'getReportData()' gibt einen Wert vom Typ 'ReportData' zurück.

Verfügbare Java-Methoden für die Berichtsdesigndatei

Für den Zugriff auf Daten, die Sie an einen Unterbericht übergeben, rufen Sie die Funktion getDataSource() in Ihrer XML-Berichtsdesigndatei auf.

Funktion Zweck
getDataSource (dataID STRING in)

Ruft innerhalb einer Berichtsdesigndatei Daten ab, die zuvor unter dataID gespeichert wurden, als die Funktion addReportData() im JasperReport-Handler aufgerufen wurde.

Die Funktion getDataSource() gibt die Daten in einem internen Format zurück. Sie müssen den Rückgabewert in den Typ 'JRDataSource' umsetzen, damit diese Daten im Unterbericht verwendet werden können.

Beispiele, die die Verwendung der in diesem Abschnitt beschriebenen Funktionen zeigen, finden Sie im EGL-Programmiererhandbuch.


Feedback