JasperReports für Oracle Reports Entwickler

Transkript

1 Ihr Partner für IT JasperReports für Oracle Reports Entwickler 1 Januar 2017

2 Agenda 1. Einführung JasperReports 2. Aufbau eines Reports 3. Datenquellen 4. Berichtselemente 5. Deployment 6. Parameter, Felder und Variablen 7. Eigenschaften von Berichtselementen 8. Diagramme 9. Subdatasets 10. Parameter und Steuerelemente 11. Subreports 12. Kreuztabellen 13. Ausdrücke 14. Variablen und Berechnungen 15. Scriptlets 16. Stilelemente und Schriften 17. Templates 18. Internationalisierung 2

3 3 Einführung JasperReports

4 Komponenten von JasperReports JasperReports ist ein Report-Generator Ausgabe als: PDF, HTML, Word, Excel, Powerpoint, TXT, RTF, ODT, CSV und XML Jaspersoft wurde von TIBCO im März 2014 gekauft JasperReports-Komponenten gibt es als freie und kommerzielle Versionen Komponenten um JasperReports Jaspersoft Studio JasperReports Library JasperReports Server 4

5 Jaspersoft Studio Visuelle Entwicklungsoberfläche Gegenstück zum Reports Designer Aufbauend auf Eclipse Komplette Entwicklungsumgebung Direktes Testen der Reports Deploy auf JasperReports Server 5

6 JasperReports Library Direkte Einbindung in eigene Java Programme Eigenverantwortlich für Datenanbindung Resourcen (Bilder, Klassen etc.) Einfach zu verwenden 6

7 JasperReports Server Umgebung um Reports zu verwalten und auszuführen Aufruf eines Reports über URL Interaktive Nutzung möglich Parametereingabe über Formulare Auswahl von Reports in der Oberfläche Auswahl des Ausgabeformates Ist.war-File Deploy auf vorhandenen Application Server Standalone Version 7

8 Referenzen Informationen Dokumentation (Community) Support (Open Source) 8

9 9 Jaspersoft Studio

10 Jaspersoft Studio Repository Explorer: Datenquellen, Jasper- Server Werkzeugleiste Project Explorer Palette: Mögliche Reports- Elemente Report-Ansicht: Design, XML, Vorschau Outline: Berichtsstruktur 10 Report State: Compile-Status, Fehler Properties: Eigenschaften des aktuellen Objektes

11 Übungen Vorbereiten Importieren der Übungsbeispiele 11

12 Übungen Vorbereiten Importieren der Übungsbeispiele 12

13 Übungen Vorbereiten Importieren der Übungsbeispiele 13

14 JasperReports Studio Views Teilfenster wie Project Explorer, Repository, Outline etc. Öffnen über das Menü: 14

15 JasperReports Studio Perspektiven Sammlung und Anordnung von Views. Standard: Reports-Design 15

16 Datenquellen Reports haben KEINE feste Verbindung zur Datenbank Verschiedene Datenquellen CSV-Files, JSON-Files, Excel-Files, XML-Files, Java-Klassen, etc. und natürlich DB-Verbindungen Datenquellen als Data Adapter zur Verfügung stellen 16

17 Datenquellen Datenquelle zur Oracle-DB erstellen 17

18 Datenquellen Datenquelle zur Oracle-DB erstellen hr Den Treiber ojdbc6.jar können Sie in Windows einfach innerhalb einer DB-Installation (z.b. XE) suchen (lassen). 18

19 JasperReports Studio Project Explorer / Projekte Übersicht durch einzelne Projekte Projekte enthalten Reports Bilder Source-Code Libraries Strukturiert durch Verzeichnisse 19

20 20 Aufbau eines Reports

21 Erstellen eines Reports Erstellen eines Projektes 21

22 Erstellen eines Reports Erstellen eines Projektes 22

23 Erstellen eines Reports Hinzufügen des Reports 23

24 Erstellen eines Reports Hinzufügen des Reports Template auswählen 24

25 Erstellen eines Reports Hinzufügen des Reports Report benennen 25

26 26 Erstellen eines Reports

27 Format eines Reports frei einstellbares Format Property des Reports 27

28 Band Konzept Struktur eines Reports Title Deckblatt / Start des Reports Page Header Kopfzeile auf jeder Seite Column Header Spaltenkopf über jeder Spalte. Typischerweise für die Überschriften der Tabellenspalten. Detail Einzelner Datensatz. Wiederholt sich, solange Daten vorhanden sind 28

29 Band Konzept Struktur eines Reports Column Footer Fußzeile einer Spalte Page Footer Fußzeile einer Seite Last Page Footer Abweichende Fußzeile der letzen Seite Summary Zusammenfassung (letzte Seite) 29

30 Band Konzept Struktur eines Reports No Data Falls keine Daten vorhanden sind Backgroud Hintergrund aller Seiten, z.b. für Wasserzeichen Group Header Kopfzeile bei Gruppierungen Group Footer Fußzeile bei Gruppierungen 30

31 Gruppen Struktur eines Reports Werden direkt am Report erstellt Neue Gruppierung, wenn sich der Wert / Ausdruck der Gruppe ändert Auf Sortierung achten Gruppen ohne Band als Trigger für Berechnungen 31

32 Struktur eines Reports Eigenschaften von Gruppen Gruppen können zusammengehalten werden Starten auf einer neuen Seite oder neuen Spalte 32

33 Sortierung Struktur eines Reports Sortiert nach Ausdruck oder Spalte Achtung: Gruppierungen reagieren auf Wechsel eines Wertes. Sortierung beeinflusst somit die Gruppierung 33

34 Struktur eines Reports Weitere Elemente eines Reports Styles Parameters / Fields / Variables Scriptlets Datasets Gruppen Sortier-Felder Subreports 34

35 Struktur eines Reports Das visuelle Design 35

36 Struktur eines Reports wird in einer XML-Datei (Report 1.jrxml) gespeichert 36

37 39 Datenquellen

38 Datenquellen Verschiedene Datenquellen Datenbanken, Java-Beans, Textdateien, Excel-Files 40

39 Datenquellen Datenquellen liefern immer eine Reihe von Datensätzen 41

40 Datenquellen Gruppierungen führt der Report aus, nicht die Datenquelle! 42

41 Datenquellen Die Spalten der Datenquelle sind Fields (Felder) Felder können in die Bands platziert werden Je nach Band wiederholen sich die Bands 43

42 Datenquellen Ein Bericht kann nur eine Datenquelle besitzen! Die Datenquelle kann aber für beliebig viele Unterabfragen verwendet werden: für Diagramme oder Tabellen, aber auch Subreports In Subreports oder Datasets kann unter Umständen eine andere Datenquelle verwendet werden. 44

43 Datenquellen Query-Designer, um Datenquelle abzufragen 45

44 Wird zu Datenquellen 46

45 Datenquellen Datenquelle zur Oracle-DB erstellen 47

46 Datenquellen Datenquelle zur Oracle-DB erstellen hr Den Treiber ojdbc6.jar können Sie in Windows einfach innerhalb einer DB-Installation (z.b. XE) suchen (lassen). 48

47 Datenmodell Datenquellen 49

48 51 Berichtselemente

49 Berichtselemente Einfache Elemente Text-Felder, statische Texte und grafische Elemente wie Bilder, Rechtecke, Kreise, Linien und Frames Komplexe Berichtselemente Subreports, Barcodes, Listen, Diagramme, Tabellen oder Karten Composite Elements Zusammenstellung von Elementen (Kann einfach erweitert werden) 52

50 Berichtselemente Drag & Drop aus der Palette auf den Report 53

51 Berichtselemente Textfelder werden automatisch erstellt, wenn Parameter, Felder oder Variablen in den Report gezogen werden 54

52 Berichtselemente Textfelder werden automatisch erstellt, wenn Parameter, Felder oder Variablen in den Report gezogen werden 55

53 Berichtselemente Anpassen der Eigenschaften Werkzeugleiste grafisch mit Maus Kontext-Menü Properties Fenster 56

54 Berichtselemente Komplexe Elemente werden über Wizards erstellt 57

55 Ein Beispiel: Arbeiten mit Berichtselementen Überschriften unter dem Gruppenheader Rahmen Hintergrund 58

56 60 Deployment

57 Deployment Vorschau des Reports im Jaspersoft Studio Verschiedene Formate für die Erzeugung des Reports Öffnen der Vorschau Bei der Erzeugung aufgetretene Fehler und Statistiken 61

58 Deployment JasperServer im Jaspersoft Studio einbinden 62

59 Deployment Deploy über das Studio In der Design-Ansicht 63

60 Deployment Deploy über das Studio Über Wizard 64

61 Deployment Deployment über die Web-Oberfläche 65

62 Deployment Ein Report benötigt außer der JRXML- Datei ggf. noch weitere Ressourcen: Bilder, Stylevorlagen, jar-libraries etc. 66

63 Deployment Ordner, Datenquellen, Parameter für Reports, Steuerelemente und weitere Objekte können vom Studio aus auf dem Server erstellt werden Reports auf dem Server können auch aus dem Studio aufgerufen werden 67

64 Deployment Reports können aus eigenen Anwendungen auf dem JasperServer hochgeladen und (nach Zeitplan) ausgeführt werden über Java Server API WebServices (SOAP, REST) Reports können über die JasperReports-Library direkt in eigene Anwendungen integriert werden 68

65 70 Parameter, Felder und Variablen

66 Parameter, Felder und Variablen Parameter, Felder und Variablen beinhalten Daten innerhalb des Reports Sind selbst keine grafischen Elemente Verwendung in Ausdrücken, z.b. bei Berichtselementen wie Text-Felder $P{parameter_name} $F{feld_name} $V{variablen_name} 71

67 Parameter, Felder und Variablen Parameter Übergabe beim Aufruf an den Report Können z.b. für Einschränkungen am Select verwendet werden Subreports, Datasets und Tabellen können eigene Parameter verwenden Mehr dazu im Kapitel Parameter und Steuerelemente 72

68 Felder Parameter, Felder und Variablen Werden mit den Datensatz-Werten aus der Datenquelle gefüllt Der aktuelle Inhalt hängt von der Verwendung des Feldes ab: Text-Feld im Detail-Band = aktueller Datensatz Text-Feld im Page-Footer = letzter Datensatz, der in einem Detail-Feld auf der Seite angezeigt wurde Die Felder und damit die Feldnamen werden in der Datenquelle definiert 73

69 Variablen Parameter, Felder und Variablen Können Ergebnisse speichern und in komplexen Berechnungen verwendet werden Jasper-interne Variablen sind für Berechnungen verfügbar Mehr dazu im Kapitel Variablen und Berechnungen 74

70 Parameter, Felder und Variablen Beispiel: Das Text-Feld Stadt kann folgen Wert haben: $F{POSTAL_CODE} + + $F{CITY} 75

71 76 Parameter, Felder und Variablen

72 77 Eigenschaften von Berichtselementen

73 Eigenschaften des Reports When No Data Type Eigenschaften von Berichtselementen Was passiert, wenn die Datenquelle nichts liefert: Nichts anzeigen, nur den Detail weglassen oder das No-Data-Band anzeigen Title On A New Page Titel als Deckblatt Summary On A New Page Summary als separate letzte Seite 78

74 Eigenschaften von Berichtselementen Eigenschaften des Reports Summary With Page Header And Footer Auf der Summary Seite Header und Footer anzeigen Ignore Pagination Alles auf eine Seite packen, egal wie lang sie wird Float Column Footer Spalten-Footer direkt an das letzte Band der Spalte hängen, oder ans Ende der Spalte 79

75 Eigenschaften des Reports Advanced Print Order Eigenschaften von Berichtselementen Spalten untereinander oder nebeneinander füllen Properties Beispielsweise wohin der Report deployed wird 80

76 Band Eigenschaften Layout Eigenschaften von Berichtselementen Free, Horizontal, Vertikal und Grid Split Type Wenn ein Band über eine Seite hinausgeht, kann sie geteilt oder zusammen gehalten werden. Stretch Kein Umbruch, außer bei Stretching Prevent Umbruch vermeiden. Band ggf. auf neuer Seite/Spalte Immediate Sofort, auch mitten im Band umbrechen 81

77 Group Header Band Eigenschaften Footer Position Eigenschaften von Berichtselementen Print Ready Reports Nach dem Detail oder inneren Footer Collate at Bottom Am Ende der Seite, wenn die äußeren Footer auch so eingestellt sind Force at Bottom Verschiebt die äußeren Footer ggf. auf die nächste Seite Stack at Bottom Drückt äußere Footer ggf. ans Ende der Seite 82

78 Eigenschaften von Berichtselementen Group Header Band Eigenschaften Start New Column Start New Page Reprint Header On Each Page Reset Page Number Keep Together Druckt den Header ggf. auf neue Seite, um mit Detail zusammen anzufangen 83

79 Allgemeine Elementeinstellungen Appearance Allgemeine Einstellung zu Ansicht Borders Rahmen um ein Element inkl. des Abstands zum Rahmen Inheritance Eigenschaften von Berichtselementen Zeigt Differenzen zu den Standard-Vorgaben 84

80 Location Eigenschaften von Berichtselementen Abhängig vom Layout des Bands verschiedene Optionen Size Größe und das Verhalten, wenn sich die Größe des Bands verändert 85

81 Eigenschaften von Berichtselementen Style Verknüpfung mit einem Style Kapitel Stilelemente und Schriften Print Repeated Values Wiederholende Werte anzeigen 86

82 Eigenschaften von Berichtselementen Textfield Blank When NULL Sonst wird NULL angezeigt Stretch With Overflow Das Element wächst in die nächste Zeile wenn der Inhalt zu groß wird. Dadurch wächst auch das Band. Stretch-Verhalten der anderen Elemente 87

83 Eigenschaften von Berichtselementen Remove Line When Blank 89

84 Eigenschaften von Berichtselementen Print In First Whole Band Nur anzeigen, wenn das Band komplett auf einer Seite das erste Mal angezeigt wird 90

85 Detail Overflows Eigenschaften von Berichtselementen Wenn der Detail durch ein anderes Element auf eine neue Seite geteilt wird (Split), wird dieses Element nochmals auf der neuen Seite angezeigt. Group Changes Wenn ein Gruppenwechsel stattfindet, wird dieses Element gedruckt. Wird bei mehreren Gruppen verwendet. 91

86 Eigenschaften von Berichtselementen Borders Padding Abstand des Inhalts zum Rahmen Borders Linien um Feld zeichnen Beispielsweise für Tabellen Frames sind manchmal einfacher bei mehreren Elementen 92

87 Eigenschaften von Berichtselementen Pattern Formatmaske z.b. für Datum oder Währungen Markup Sprache, über den Formatangaben im Text interpretiert werden sollen: styled JasperReports internes Format html HTML rtf Rich Text Format none keine Formatierungen im Text 93

88 Hyperlink Eigenschaften von Berichtselementen Link Target, Type, Reference Verweis auf eine URL (Reference), Detail-Report auf dem Reports Server, oder Bereiche innerhalb des Reports 94

89 Eigenschaften von Berichtselementen Anchor and Bookmark Erstellen eines Inhaltsverzeichnisses Anchor Name Expression Name des Verzeichniseintrags Bookmark Level Ebene im Inhaltsverzeichnis 95

90 97 Diagramme

91 Diagramme High-Level Berichtselemente Erzielen einen schnellen Überblick Aha -Effekt, nicht nur fürs Management Ermöglichen Trendanalysen 98

92 Diagramme Diagramme unterscheiden sich in den benötigten Daten: 1, 2 oder mehr Dimensionen 1-dimensional: Tabelle mit 2 Spalten (Label, Wert) 2-dimensional: Tabelle mit 3 Spalten (Label, Gruppe, Wert) 99

93 Diagramme Unterschiedliche Diagrammtypen unterschiedliche Datenstrukturen: Tortendiagramm (Pie) (Label,) Wert X,Y (Label,) X-Wert, Y-Wert Zeitpunkte (Time Series) Label, Datum, Wert Min Max (High Low) oberer und unterer Schwellwert, Einzelwert Gantt Task, Untertask, Start- und Enddatum, %-Fertigstellung, Projekt Beispiele in JasperReportsSamples 100

94 Diagramme Die Konfiguration ist abhängig vom Diagrammtyp 101

95 Diagramme Position des Diagramms im Report Üblich im Titel- oder im Summary-Band des Reports. Es können aber auch in jedem Datensatz Informationen grafisch dargestellt werden Daten können aus Report-Datenquelle bezogen werden oder aus eigenen Anfragen Diagramm in eigenem Bericht und als Subreport einbinden Erstellung eines (Sub)Datasets 102

96 Diagramme Beispiel Tortendiagramm 103

97 Diagramme Werte der Tortenstücke Minimaler Wert eines Tortenstücks Label der Tortenstücke Name der Tortenstücke in der Legende Einschränkung auf die Auswahl der Datensätze Datenquelle des Diagramms Infos zu zusammengefassten Tortenstücken Maximale Anzahl der Tortenstücke 104

98 Diagramme Detailnavigation ( Drill-through ) durch Hyperlinks Für HTML-Darstellung gedacht (JasperServer) Tooltips können für die Anzeige genauer Werte verwendet werden 105

99 Diagramme Detailwerte über Tooltip anzeigen 106

100 Diagramme Unterschiedliche Arten von Hyperlinks Am Element in den Charts 107

101 Diagramme Unterschiedliche Arten von Hyperlinks Am Chart selber 108

102 Diagramme Konfiguration von Diagrammen Gemeinsame Eigenschaften Titel, Untertitel Legende, Achsen Farben, Hintergrundfarben Schriftarten, -größen Positionierung, Ausrichtung etc. 109

103 Diagramme Eigenschaften auf den verschiedenen Ebenen Eigenschaften zum Chart selbst Eigenschaften zur Datenquelle Eigenschaften zu den einzelnen Werten 110

104 Diagramme Spezielle Eigenschaften für unterschiedliche Diagrammtypen 111

105 Chart-Themes Diagramme Design eines einheitlichen Aussehens von Charts Corporate Design Wiederverwendung 114

106 Chart-Themes Diagramme Erstellen des Designs 115

107 Chart-Themes Export als JAR Diagramme 116

108 Chart-Themes Diagramme Einbinden in Report 117

109 119 Subdatasets

110 Subdatasets Beispiel: Lieferscheindruck Im oberen Bereich soll die Anschrift des Kunden und die Bestellnummer angezeigt werden. Darunter die Liste mit den gelieferten Artikeln. Falls der jeweilige Artikel Allergene beinhaltet, sollen diese aufgelistet werden. Viele Tabellen und Untertabellen Eine Abfrage schwierig Geschickter über Subqueries die Informationen abfragen 120

111 Subdatasets In Diagrammen, (Kreuz-)Tabellen und Listen kann ein eigenes (Sub-)Dataset verwendet werden. Ein Subdataset basiert auf einer eigenen (SQL-) Abfrage und kann dieselbe Datenquelle wie der Report oder eine andere verwenden. Subdatasets haben eigene Parameter, Felder, Variablen, Scriptlets und Gruppen 121

112 Subdatasets Felder können nicht direkt im Report verwendet werden Ohne die Verwendung in speziellen Elementen ist ein Subdataset nutzlos 122

113 Subdatasets Im Konfigurationsdialog Chart data, Crosstab data oder anderen passenden Elemente werden Dataset runs definiert. Es können Datenquellen, Verbindungen und Parameter aus dem Hauptbericht im Dataset run verwendet werden 123

114 125 Parameter und Steuerelemente

115 Parameter und Steuerelemente Parameter werden von außen (z. B. JasperServer) an den Report übergeben. Parameter haben einen Java-Typ und können wie Felder in Ausdrücken verwendet werden $P{name} Einige Parameter werden automatisch eingebaut 126

116 Parameter und Steuerelemente Parameter mit Is For Prompting werden bei der Report-Ausführung über Eingabefelder abgefragt 127

117 Parameter und Steuerelemente Verwendung von Parametern in dynamischen SQL-Abfragen (Bind-Parameter) 128

118 Parameter und Steuerelemente Sonderfunktionen Keine Bind-Variable, sondern direkt im Text ersetzen: $P!{name} Achtung: Bei Strings auf achten! Makro für = mit null $X{EQUAL / NOTEQUAL, <num_column>, <num_parameter>} where $X{EQUAL,SALARY,pMaxSalary} where SALARY is null oder where SALARY =

119 Parameter und Steuerelemente Listen in Parametern $X{IN / NOT IN, <column>, <list_parameter>} 130

120 Parameter und Steuerelemente Auf dem JasperReports Server können verschiedene Steuerelemente verwendet werden, um Report-Parameter abzufragen Einfacher Wert (Textfeld) Auswahl (Checkbox) Listen (Dropdown-Menü oder Radiobuttons) Mehrfachauswahl (Liste oder Checkboxen) 131

121 Parameter und Steuerelemente Als Name des Steuerelements muss der Name des Parameters gewählt werden Die Inhalte der Steuerelemente können frei änderbar sein (Textfelder) fest vorgegeben werden als Werteliste mit einer SQL-Abfrage gefüllt werden Einfache Steuerelemente werden automatisch beim Deploy erstellt 132

122 Parameter und Steuerelemente Es können kaskadierende Steuerelemente (Cascading Controls) erstellt werden (nicht im Studio) Beispiel Steuerelement 1:Länder (Mehrfachauswahl) SELECT DISTINCT countries AS mycountries FROM stores Steuerelement 2: Bundesstaaten (Listenauswahl) SELECT DISTINCT states FROM stores WHERE $X{IN, countries, mycountries} 134

123 Parameter und Steuerelemente Parameter können auch an Subqueries und Subreports übergeben werden Parameter in Subquery hinzufügen Parameter beim Aufruf übergeben 135

124 136 Parameter und Steuerelemente

125 138 Subreports

126 Subreports Über ein Subreport-Element kann in einen Report ein anderer Report eingebettet werden Teilberichte können wiederverwendet werden und sind im Einzelnen weniger komplex Durch Parameter und Rückgabewerte wird eine Schnittstelle definiert Subreports können andere Datenquellen und Ressource-Bundles verwenden 139

127 Subreports Beispiel: Grafik neben Liste Könnte prinzipiell auch mit Table gelöst werden 140

128 Subreports Subreport-Eigenschaften 141

129 Subreports ACHTUNG: Pfadangaben auf JasperServer unterschiedlich. Aber das Jaspersoft Studio hilft beim Deploy: 142

130 145 Kreuztabellen

131 Kreuztabellen Kreuztabellen stellen tabellarische Daten dar, bei denen in Spalten Dimensionsdaten vorhanden sind. Pivottabellen Durch die Dimensionsspalte ist zu Designzeit des Reports normalerweise nicht bekannt, wie viel Spalten die Tabelle haben wird. 146

132 Kreuztabellen Element einer Kreuztabelle Spaltengruppe 1, 2 Zeilengruppe 1, 2 Zellen In einer Zeile können auch mehrere Inhalte (Measures) angezeigt werden 147

133 Kreuztabellen Wizard zum Erstellen einer Kreuztabelle Dataset auswählen 148

134 Kreuztabellen Wizard zum Erstellen einer Kreuztabelle Spalten auswählen 149

135 Kreuztabellen Wizard zum Erstellen einer Kreuztabelle Zeilen auswählen 150

136 Kreuztabellen Wizard zum Erstellen einer Kreuztabelle Maße auswählen 151

137 Kreuztabellen Wizard zum Erstellen einer Kreuztabelle Layout festlegen 152

138 Kreuztabellen Wizard zum Erstellen einer Kreuztabelle Ergebnis 153

139 Bearbeiten: Kreuztabellen Gruppen sind Container Gemeinsames Verändern der Größe von Spalten und Zeilen 154

140 Kreuztabellen Groups und Measures Sortierung und Total-Positionierung in Gruppen 155

141 Kreuztabellen Groups und Measures Es stehen viele Berechnungen für Measures zur Verfügung 156

142 Kreuztabellen Positionierung von Kreuztabellen Ignore Width Bei einigen Ausgaben (HTML, Excel) wird die Breite des Reports überschritten Horizontal Position Ist die Tabelle kleiner als eine Seite, wird die Position angegeben 157

143 159 Ausdrücke

144 Ausdrücke Ausdrücke sind wie Formeln, die ein Ergebnis zurückliefern Sie können in Java, Groovy, bsh oder Javascript erstellt werden Die Sprache wird am Report eingestellt; Standard: Java 160

145 Ausdrücke Komfortabler Editor für Java und Groovy Ansonsten Textfeld Anwendungsfälle Textfelder Bedingungen (z.b. für Gruppenwechsel) viele weitere Eigenschaften überall, wo dieser Button zu sehen ist: 161

146 Ausdrücke Ausdrücke bestehen aus Literalen, FP & V, Operatoren und Funktionsaufrufen Ausdrücke dürfen nur aus einer, beliebig verschachtelten, Anweisung bestehen Umfangreiche Ausdrücke werden mit Scriptlets implementiert 162

147 Ausdrücke Beispiel: Textkonkatenation Beispiel: Berechnung 163

148 Ausdrücke Build-in Functions Häufig einfacher als Java Mit eigenem Editor 164

149 Ausdrücke Ausdrücke haben typisierte Rückgabewerte (Date, Integer, String, Boolean etc.) Felder erwarten Datentypen! Achtung: Die Überprüfung findet erst zur Laufzeit statt! Hinweis: Fehlersuche ist hier sehr mühsam, deshalb nicht zu viele Änderungen gleichzeitig machen. 165

150 167 Variablen und Berechnungen

151 Variablen und Berechnungen Variablen werden zur Laufzeit verändert Der aktuelle Wert einer Variablen wird durch verschiedene Eigenschaften beeinflusst Initialwert Berechnungszeitpunkt Berechnungsfunktion 168

152 Variablen und Berechnungen Initialwert (Initial Value Expression) Statischer Wert (z.b. new Integer(0), String o.ä.) Feld, Parameter oder eine andere Variable Berechnungszeitpunkt Reset type Wann wird der Wert auf den Initialwert (zurück)gesetzt? Increment type Wann wird der Wert neu berechnet? Default: None (bei jedem Datensatz), andere: Report, Column, Group, Page, 169

153 Variablen und Berechnungen Variablenausdruck (Variable Expression) Das Ergebnis des Ausdrucks wird an die Berechnungsfunktion (Calculation) übergeben Der Ausdruck kann Felder, Parameter und Variablen enthalten 170

154 Variablen und Berechnungen Berechnungsfunktionen Vordefinierte in Calculation No Calculation Function: Das Ergebnis des Ausdrucks wird ausgewertet und als neuer Wert übernommen (Distinct) Count: Anzahl (unterschiedlicher) Werte aus dem Ausdruck Mathematisch: Sum, Average, Lowest, Highest, Standard Deviation, Variance First: der erste vom Ausdruck zurückgelieferte Wert System: Keine Berechnung. Wert kommt aus einem Scriptlet oder wird mit einem Return-Wert aus einem Subreport gefüllt Eigene in Incrementer Factory Class 171

155 Variablen und Berechnungen Beispiel Percentage Wie hoch ist Prozentanteil des aktuellen Wertes bezogen auf den Gesamtanteil Zunächst Composite Element auf die Oberfläche ziehen 172

156 Variablen und Berechnungen Beispiel Percentage Aktuelles Feld angeben 173

157 Variablen und Berechnungen Beispiel Percentage Der Wizard erstellt automatisch die notwendige Summenvariable 174

158 Variablen und Berechnungen Darstellung des Variablenwertes in einem Textfeld Wichtig: Evaluation Time Zu welchem Zeitpunkt wird der Ausdruck für das Textfeld ausgewertet (und damit die Variablen ausgelesen) 175

159 Variablen und Berechnungen Beispiel Composite Element Seite X von Y Zwei Felder Beide benutzen dieselbe Variable PAGE_NUMBER Unterschiedliche Evaluation Time 176

160 Variablen und Berechnungen Reihenfolge der Berechnung Die Reihenfolge der Definition gibt die Reihenfolge der Initialisierung und Berechnung vor Wichtig für abhängige Variablen 177

161 179 Scriptlets

162 Scriptlets Scriptlets sind Java-Klassen, die mit JasperReports interagieren Methoden in Scriptlets können in Expressions aufgerufen werden JasperReports ruft Methoden zu bestimmten Zeitpunkten während der Erstellung auf (z. B. Trigger) 180

163 PL/SQL Package Speicherpfad Scriptlets JAVA Class Package begin end; { } if 1=2 then begin end; Variablendeklaration: info_text varchar2(2000); anz_mitarbeiter number(5); String-Konstanten info_text := Hallo ; String Konkatination info_text := Hallo ma_name; if (1==2) { } String infotext; Integer anzmitarbeiter; infotext = Hallo ; infotext = Hallo +maname 181

164 Scriptlets package de.teampb.example; public class MyTestClass { private String testvar; public MyTestClass(String defaultvalue) { settestvar(defaultvalue); } public String gettestvar() { return testvar; } public void settestvar(string testvar) { this.testvar = testvar; } public void beispielmethode() { String testvar2 = gettestvar(); testvar2 = testvar2 + " test"; settestvar(testvar2); System.out.print(getTestVar()); } } Angabe der Package Speicherpfad Benennung der Klasse Definition eine klassenlokalen Variable Konstruktor der Klasse Methode, die zum Erstellen einer neuen Instanz einer Klasse aufgerufen wird. Gibt die Instanz der Klasse zurück Getter Methode, die den Wert einer klassenlokalen Variable zurück gibt Setter Methode, die den Wert einer klassenlokalen Variable setzt Eine Methode der Klasse 182

165 Scriptlets package de.teampb.test; import de.teampb.example.mytestclass; public class TestClass { } public String testmytestclass() { MyTestClass mytestclass = new MyTestClass("hallo"); } if (mytestclass.gettestvar().equals("hallo")) { return "OK"; } else { return "Fehler"; } Verweis auf andere Package Instanziierung einer Klasse String-Vergleich Rückgabewert einer Methode 183

166 Scriptlets package de.teampb.example; import net.sf.jasperreports.engine.jrscriptletexception; public class MyExceptionClass { public String greetme(string name) { String retval; try { retval = "Hallo "+name.touppercase(); } catch(exception e) { retval = e.getmessage(); } return retval; } Exceptionhandling Exception auslösen } public void testexception(boolean exceptnow) throws JRScriptletException { if (exceptnow) { throw new JRScriptletException("Jetzt gibt es einen Fehler"); } } 184

167 Scriptlets package de.teampb.test; import java.util.iterator; import java.util.linkedlist; import java.util.list; public class WileTest { public static void main(string[] args) { Listen While-Schleife List<String> stringlist = new LinkedList<String>(); stringlist.add("eintrag 1"); stringlist.add("eintrag 2"); stringlist.add("eintrag 3"); Iterator iter = stringlist.iterator(); } } while (iter.hasnext()) { System.out.println((String) iter.next()); } 185

168 Scriptlets package de.teampb.test; import java.util.linkedlist; import java.util.list; public class ForEachTest { public static void main(string[] args) { Listen For-Each-Schleife List<String> stringlist = new LinkedList<String>(); stringlist.add("eintrag 1"); stringlist.add("eintrag 2"); stringlist.add("eintrag 3"); } } for (String eintrag:stringlist) { System.out.println(eintrag); } 186

169 Scriptlets Vorbereitung eines Reports auf eigenen Java-Code Erstellung eines Source-Folders 187

170 Scriptlets Erstellung eines Scriptlets net.sf.jasperreports.engine.jrabstractscriptlet 188

171 Scriptlets Scriptlet enthält automatisch Platzhalter für die Trigger Before und After-Trigger (Vor und nach der Initialisierung) Column, Detail, Group, Page, Report 189

172 Scriptlets Scriptlet im Report registrieren 190

173 Scriptlets Zugriff auf eine Datenbank mit JDBC private Connection conn; private Connection getconnection() throws JRScriptletException { if (conn == null) { if (getparametervalue(jrfillparameter.report_connection)!= null) { conn = (Connection) (getparametervalue(jrfillparameter.report_connection)); } else { throw new RuntimeException("Keine Datenbank-Verbindung am Report konfiguriert"); } } } return conn; protected CallableStatement prepareplsqlcall(string sql) throws JRScriptletException, SQLException { return getconnection().preparecall("begin " + sql + "; end;"); } 191

174 Scriptlets Methoden im Scriptlet public String getdeptname(integer deptid) throws JRScriptletException { } try { CallableStatement stmt = prepareplsqlcall( " :result := pk_hr_info.get_dept_name(p_department_id => :p_department_id)"); try { stmt.registeroutparameter("result", Types.VARCHAR); stmt.setint("p_department_id", deptid); stmt.execute(); return stmt.getstring("result"); } finally { stmt.close(); } } catch (SQLException e) { throw new RuntimeException("Fehler beim Aufruf von get_dept_name", e); } 192

175 Scriptlets Methoden in Expression aufrufen 193

176 Scriptlets Auf Variablen, Felder und Parameter in Scriptlets zugreifen getvariablevalue( <name> ); setvariablevalue( <name>,<value>); getparametervalue( <name> ); getfieldvalue( <name> ); Die Funktionen geben Objekte zurück ggf. casten 194

177 196 Stilelemente und Schriften

178 Stilelemente und Schriften Jedes Textelement kann individuell formatiert werden Text-/Hintergrund-/Rahmen-Farben Position und Ausrichtung Schriftart, -stil und -größe Abstände etc. Besser: über Styles einheitliche Formatierungen definieren 197

179 Stilelemente und Schriften Styles bündeln eine Menge Einstellungen Ein Element übernimmt nur die Einstellungen, die das Element kennt Styles sind vererbbar: Ein Style kann Einstellungen von einem anderen Style übernehmen Styles können ausgelagert und wiederverwendet werden (Corporate Design) 198

180 Stilelemente und Schriften Für die meisten Elemente ist ein Style einstellbar Auch per Drag&Drop 199

181 Stilelemente und Schriften Im Reiter Inheritance sieht man, welche Einstellungen woher kommen Einstellungen am Element können zurückgenommen werden 200

182 Stilelemente und Schriften Verwenden eines Default-Styles im Report 201

183 Stilelemente und Schriften Styles können Bedingungen haben (Conditional Style) Beispiel: Alternierender Hintergrund in Listen 202

184 Stilelemente und Schriften Corporate Design durch externe Styles 203

185 Schriftarten Stilelemente und Schriften System-Fonts, sind in einer anderen Umgebung u. U. nicht vorhanden Manuell installierte Fonts (Window > Preferences > Jaspersoft Studio > Fonts) Am Font kann eingestellt werden, dass dieser in PDFs eingebettet werden soll 204

186 Stilelemente und Schriften Bei einigen Export-Formaten kann die Schriftart nicht eingebettet werden (z. B. HTML) Hier kann ein Mapping auf eine alternative Schriftart angegeben werden 205

187 Stilelemente und Schriften Schriften müssen im Klassenpfad liegen, damit sie zur Entwicklung und bei der Ausführung verfügbar sind Für den JasperServer als JAR exportieren und mit deployen, dann kann der Server auch PDFs mit dem Font erstellen 206

188 208 Templates

189 Templates Ein Template ist ein JRXML-Bericht, der als Vorlage für neue Berichte verwendet wird. Im Template fehlt beispielsweise die Datenquelle Grundsätzlich können auch mehr Elemente im Template vorhanden sein, die im neuen Bericht einfach gelöscht werden 209

190 Templates Ein Template erstellen: Einstellen wo Templates abgelegt werden Preferences > Jaspersoft Studio > Resource Folder Location > Report Templates 210

191 Templates Einen Report erstellen Im Column Header eine Spaltenvorgabe: Static Text Label als Text Im Group Header eine Vorlage für ein Gruppenfeld: Text Field Group Field als Expression Vorab eine Gruppe erstellen Im Detail eine Vorlage für ein Feld: Text Field Field 211

192 Templates Als Template exportieren 212

193 Als Template exportieren Templates 213

194 Als Template exportieren Templates 214

195 Templates Zum Schluss vom Report ein Thumbnail erstellen Den Thumbnail unter dem selben Namen wie das Template speichern (Nach einem Neustart ist der Thumbnail sichtbar) 215

196 217 Internationalisierung

197 Internationalisierung Internationalisierungsmechanismus aus Java (i18n) Statische Texte werden als Schlüssel/Werte Paare in Bundle -Dateien (Sprachdateien) abgelegt Basis-Bundle in MyBundle.properties Weitere Sprachen über Dateinamen: MyBundle_de_DE.properties MyBundle_en_US.properties etc. 218

198 Internationalisierung Die Texte im Report kommen aus dem Ressource-Bundle und werden zur Laufzeit aufgelöst Texte werden in Expressions über die Funktion $R{<key>} aufgelöst 219

199 Internationalisierung Statische Texte müssen zu Text-Feldern umgewandelt werden und der Text muss gegen den Key getauscht werden. 220

200 Internationalisierung Erstellen eines Ressource-Bundles 221

201 Internationalisierung Erstellen eines Ressource-Bundles 222

202 Internationalisierung Erstellen eines Ressource-Bundles 223

203 Bearbeiten des Bundles Internationalisierung 224

204 Internationalisierung Bundle in den Report einbinden Property des Reports: 225

205 Internationalisierung Was passiert, wenn der Key oder Wert fehlt? 226

206 Internationalisierung Testen der verschiedenen Sprachen Einstellung im JasperReports Studio 227

207 Variablen im Text Im Key Platzhalter definieren: Gesamtgehalt = Das Gesamtgehalt der Abteilung beträgt {0} msg-funktion in der Expression verwenden 228

208 Vielen Dank für Ihre Aufmerksamkeit TEAM GmbH Hermann-Löns-Str Paderborn Fon