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.
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 | 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. |
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. |
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. |
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. |
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.