Page Comparison

Mit der JasperReports Integration kann eine mit JasperSoftStudio dem JasperSoft Studio erstellte Vorlagen oder Template ausgelesen, mit Daten befüllt und anschließende anschließend angezeigt oder gespeichert werden. Ein Report besteht meist aus drei Teilen:

1. 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:
   1. Der Datentyp des Attributes und der des Zielfeldes muss müssen identisch sein
   2. Im besten Fall tragen beide den selben Namen, denn über diesen wird die Zuweisung im Report erledigt. Ist aber nicht zwingen notwendig.
   3. Fields können auch Binärdaten wie Blobs, Clobs oder Byte[] beinhalten. 
      
      
2. 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 Folgendes muss bei den Parametern beachtet werden:
   1. Der Datentyp der Variable in Java und der des Zielparameters muss identisch müssen identisch sein
   2. Im besten Fall tragen beide den selben Namen, denn über diesen wird die Zuweisung im Report erledigt. Ist aber nicht zwingen notwendig.
   3. Paramter Parameter können auch Binärdaten wie Blobs, Clobs oder Byte[] beinhalten.
      
      
3. Static Fields
   Static Fields sind statische Beschriftungen in einem Report welche einfach nur der Beschreibung dienen.

...

1. 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 bei Template erstellen.
2. Kopieren Sie die beiden Dateien des Templates (.jrxml und .jasper) in einen neu erstellen Ordner z.B. "Reports" innerhalb der Resources.
3. Wählen Sie ein geeignetes Event für die Ausführung Ihres Reports aus z.B. XdevButton und platzieren Sie dort Ihren Cursor.
4. Klicken Sie auf den Eintrag Report in der Palette. Es öffnet sich folgender Dialog.
   
5. Füllen Sie die einzelnen Felder und Inhalte siehe Beschreibung zum Wizard oben.
6. Schließen Sie den Dialog mit einem Klick auf OK ab.

Verwenden des Ergebnisses nach dem Wizard

1. Nach dem Wizard wird folgender Code generiert:

   Code Block
   language java theme Eclipse firstline 1 linenumbers true
   Report.New().jrxml("WebContent/WEB-INF/resources/reports/Report 2 - Group.jrxml") .dataSource(com.xdev.dal.DAOs.get(com.company.jasperreportsdemo.dal.ProductDAO.class) .getProductsOrderedByCategory()) .parameter("creator", "CK").parameter("created", new Date()).exportToResource(ExportType.PDF);

   
   

2. Weisen Sie einer Variable dieses das erzeugt Statement zu
   a) Positionieren Sie nun den Cursor an das Ende des gesamten Statements also nach "exportToResource(ExportType.PDF);"
   b) Drücken Sie Strg + 1 → Wählen Sie "Assing statement to new local variable (Strg+2, L)"
   c) Bestätigen Sie die Auswahl mit Enter.
   Es wird jetzt automatisch eine Variable vor dem Statement erzeugt welche die Resource entgegen nimmt.
   

   Code Block
   language java theme Eclipse firstline 1 linenumbers true
   Resource exportToResource = Report.New().jrxml("WebContent/WEB-INF/resources/reports/Report 2 - Group.jrxml") .dataSource(com.xdev.dal.DAOs.get(com.company.jasperreportsdemo.dal.ProductDAO.class) .getProductsOrderedByCategory()) .parameter("creator", "CK").parameter("created", new Date()).exportToResource(ExportType.PDF);

   
   

3. Jetzt können die Resource zum Beispiel einem XdevBrowserFrame zuweisen

   Code Block
   language java theme Eclipse firstline 1 linenumbers true
   browserFrame.setSource(exportToResource);