Berichts- und Berichtsdatenabschnitte ('Report' und 'ReportData') sind vordefiniert. Das heißt,
dass EGL Felder innerhalb der Abschnitte für Sie definiert. Sie deklarieren Variablen einfach auf
der Basis dieser Abschnitte. Sie müssen diese Variablen vor der Verwendung initialisieren, indem
Sie sie entweder mit dem Operator
new erstellen oder einen
Wertefestlegungsblock in der Deklaration verwenden. Die zweite Methode ist effizienter.
Weitere Informationen finden Sie in den Abschnitten zum Operator "new" und zu Wertefestlegungsblöcken ("Set-values"). Das folgende
Beispiel zeigt Report- und ReportData-Deklarationen:
myReport Report{};
myReportData ReportData{};
Eine Variable, die auf einem Report-Abschnitt basiert, enthält automatisch die folgenden Felder:
- reportDesignFile
- Der vollständige Pfad zur Berichtsdesigndatei, bei der es sich um eine kompilierte XML-Datei
mit der Erweiterung '.jasper' handelt.
- Typ: STRING
- Beispiel: myRpt.reportDesignFile
= "C:\\EGL\\reports\\customerDesignFile.jasper";
- Standardwert: Kein
- reportDestinationFile
- Der vollständige Pfad zur temporären .jrprint-Datei.
- Typ: STRING
- Beispiel: myRpt.reportDestinationFile
= "C:\\EGL\\reports\\customerPrintFile.jrprint";;
- Standardwert: Kein
- reportExportFile
- Der vollständige Pfad zur endgültigen Datei mit der Erweiterung .xml, .pdf, .html, .txt. oder .csv.
- Typ: STRING
- Beispiel: myRpt.reportExportFile =
"C:\\EGL\\reports\\customerReport.pdf";
- Standardwert: Kein
- reportData
- Der Verweis auf die tatsächlichen Daten für den Bericht.
- Typ: ReportData
- Beispiel: myRpt.reportData = myReportData;
- Standardwert: Kein
Sie können Anfangswerte für diese Felder in einem Wertefestlegungsblock festlegen, wie dies auch
für Eigenschaften funktioniert. Allerdings können Sie auf diese Werte während der Ausführung
zugreifen, was bei Eigenschaften nicht möglich ist. Siehe den Abschnitt über Wertefestlegungsblöcke ("Set-values-Blöcke").
Wenn Sie einen Pfad angeben, müssen Sie dem Verzeichnistrennzeichen ein Escapezeichen (\)
wie im folgenden Beispiel voranstellen:
myRpt.reportDesignFile = "C:\\EGL\\reports\\customerDesignFile.jasper";
Die Berichtsvariable ('Report') enthält Informationen, die für einen Bericht spezifisch sind.
Die Variable enthält die folgenden Felder:
| Feld |
Beschreibung |
Datentyp |
| reportDesignFile |
Der vollständige Pfad zur Berichtsdesigndatei, bei der es sich um eine kompilierte XML-Datei
mit der Erweiterung '.jasper' handelt. |
STRING |
| reportDestinationFile |
Der vollständige Pfad zur temporären .jrprint-Datei. |
STRING |
| reportExportFile |
Der vollständige Pfad zur endgültigen Datei mit der Erweiterung .xml, .pdf, .html, .txt. oder .csv. |
STRING |
| reportData |
Der Verweis auf die tatsächlichen Daten für den Bericht. |
ReportData |
Die Berichtsdatenvariable ('ReportData') beschreibt die Daten, die in einem Bericht verwendet werden sollen.
Die Variable enthält die folgenden Felder:
| Feld |
Erläuterung |
Datentyp |
| connectionName |
Der Aliasname für eine Datenbankverbindung, die Daten für den Bericht bereitstellt
(DataSource.databaseConnection). |
STRING |
| sqlStatement |
Die SQL-Anweisung, die die Daten für den Bericht bereitstellt (DataSource.sqlStatement). |
STRING |
| Data |
Der Verweis auf eine dynamische Feldgruppe von Datensätzen (DataSource.reportData). |
ANY |