...
- 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 müssen identisch sein
- Im besten Fall tragen beide den selben Namen, denn über diesen wird die Zuweisung im Report erledigt. Ist aber nicht zwingen notwendig.
- 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 müssen identisch sein
- Im besten Fall tragen beide den selben Namen, denn über diesen wird die Zuweisung im Report erledigt. Ist aber nicht zwingen notwendig.
- Parameter 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.
...
Optionen:
Mapping Wizard
...
- JRXML File - 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.
- Resource - Geben Sie bei Resource die Datenmenge oder Collection an welche die Daten für die Fields enthält. Dies kann über mehrere Weg passieren:
- 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
Laden Sie selbst eine Ergebnismenge vor dem Aufruf des QueryWizards z.B. über
Code Block language java theme Eclipse firstline 1 linenumbers true List<Customer> allCustomers = new CustomerDAO().findAll();
oder
Code Block language java theme Eclipse firstline 1 linenumbers true Order find = new OrderDAO().find(10248); Set<Orderdetail> orderdetails = find.getOrderdetails();
oder
Code Block language java theme Eclipse firstline 1 linenumbers true List<BeanItem<Customer>> selectedItems = table.getSelectedItems();
und weisen Sie dann den Variablennamen in diesem Beispiel "allCustomers", "orderdetails" oder "selectedItems" diesem Feld zu.
- Parameters - 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.
- Mapping - 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.
- Export Typ
...
- -
...
- 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
- Export Target
...
- - Folgende Export Targets stehen zur Verfügung:
- Resource
- Wird verwendet wenn Sie den erstellen Report sofort im Browser anzeigen wollen. Zum Beispiel in Verwendung mit dem XdevBrowserFrame
- byte[]
- Wird verwendet wenn Sie den erstellten Report zum Beispiel in die Datenbank schreiben oder Ihn per Stream an eine andere Stelle weitergeben wollen.
- Resource
Wie sie einen Report anbinden
...