Mit der JasperReports Integration kann eine mit JasperSoftStudio erstellte Vorlagen oder Template ausgelesen, mit Daten befüllt und anschließende angezeigt oder gespeichert werden. Ein Report besteht meist aus drei Teilen:
- Fields
Fields sind gleichzusetzen mit den Attributen der Entities in RapidClipse. Sie sind wie Platzhalter für die eigentlichen Reportdaten und werden zur Laufzeit mit den jeweiligen Daten befüllt. Die Daten für die Fields werden immer in Form einer Liste an
den Report übergeben. Dies kann eine "List / ArrayList" oder ein "Set / HashSet" typisiert auf das jeweilige Entity sein. Folgendes muss bei den Fields beachtet werden:- Der Datentyp des Attributes und der des Zielfeldes muss identisch sein
- Im besten Fall tragen beide den selben Namen, denn über diesen wird die Zuweisung im Report erledigt.
- Fields können auch Binärdaten wie Blobs, Clobs oder Byte[] beinhalten.
- Parameter
Parameter können statische an den Report übergebene Werte wie zum Beispiel der Ersteller oder das Erstelldatum sein. Parameter können aber auch Steuerungsdaten sein welche zum Beispiel Grenzwerte definieren die dann
entscheiden, ob andere Werte speziell markiert werden. Parameter werden als einzel Variablen gesammelt in einer HashMap an den Report übergeben. Folgendes muss bei den Parametern beachtet werden:- Der Datentyp der Variable in Java und der des Zielparameters muss identisch sein
- Im besten Fall tragen beide den selben Namen, denn über diesen wird die Zuweisung im Report erledigt.
- Paramter können auch Binärdaten wie Blobs, Clobs oder Byte[] beinhalten.
- Static Fields
Static Fields sind statische Beschriftungen in einem Report welche einfach nur der Beschreibung dienen.
Wie sie einen Report anbinden
- Erstellen Sie einen Reporttemplate mit Hilfe des JasperSoftStudios. Geben Sie dazu im Quick Access rechts oben "Report Design" ein und wählen die Report Design Perspective. In dieser perspective haben Sie die Möglichkeit ein Template ähnlich eines Serienbriefes zu erstellen. Eine detailierte Beschreibung zum erstellen eines Templates finden Sie in der Dokumentation JasperSoft Studio Doku sowie ein kleines Beispiel in unserer Dokumentation hier.