Report erstellen

Mit der JasperReports Integration kann eine mit dem JasperSoft Studio erstellte Vorlagen oder Template ausgelesen, mit Daten befüllt und 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 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 muss bei den Parametern beachtet werden:
   1. Der Datentyp der Variable in Java und der des Zielparameters 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. 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.

Beschreibung Mapping Wizard

1. Wählen Sie hier das .jrxml File aus, welches durch das JasperSoft Studio erstellt wurde. Geben Sie hier nicht das .jasper, also die fertige Compilierte Datei an. Diese Datei sollte sich immer im Projekt eigenen Resources - reports Ordner befinden. 
2. Geben Sie bei Resource die Datenmenge oder Collection an welche die Daten für die Fields enthält. Dies kann über mehrere Weg passieren:
   1. Auswahl einer DAO Methode - Klicken Sie auf die drei Punkte links neben dem Feld, wählen Sie eine DAO-Klasse und eine QueryMethode in dieser Klasse

   2. Laden Sie selbst eine Ergebnismenge vor dem Aufruf des QueryWizards z.B. über

      List<Customer> allCustomers = new CustomerDAO().findAll();

      oder 

      Order find = new OrderDAO().find(10248);
      Set<Orderdetail> orderdetails = find.getOrderdetails();

      oder

      List<BeanItem<Customer>> selectedItems = table.getSelectedItems();

      und weisen Sie dann den Variablennamen in diesem Beispiel "allCustomers", "orderdetails" oder "selectedItems" diesem Feld zu.

3. Das Parameter-Mapping. Hier werden die im Report zur Verfügung stehenden Parameter auf zu Verfügung stehende Variablen gemapped. Haben Sie die .jrxml angegeben so werden die zu befüllenden Parameter ausgelesen und automatisch angezeigt.
4. Das Field-Mapping. Hier werden die im Report zur Verfügung stehenden Fields auf die in der Resource enthaltenen Attribute gemapped. Haben Sie die .jrxml und die Resource ordnungsgemäß befüllt sollten sich einige Inhalte bereits selbst eintragen. Sie brauchen diese jetzt nur noch zu kontrollieren und ggf. nachbessern oder vervollständigen.
5. Export Typ auswählen -  Wählen Sie hier den Typ des Dokuments welches dann zur Laufzeit generiert werden soll. Folgende Export Types stehen zu Verfügung: PDF, HTML, XML, RTF, CSV, TEXT, XLSX, XLS, DOCX, PPTX, ODT
6. Export Target auswählen - Folgende Export Targets stehen zur Verfügung:
   1. Resource
      1. Wird verwendet wenn Sie den erstellen Report sofort im Browser anzeigen wollen. Zum Beispiel in Verwendung mit dem XdevBrowserFrame
   2. byte[]
      1. Wird verwendet wenn Sie den erstellten Report zum Beispiel in die Datenbank schreiben oder Ihn per Stream an eine andere Stelle weitergeben wollen.

Wie sie einen Report anbinden

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:

   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.
   

   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

   browserFrame.setSource(exportToResource);