Import
Einen JasperReports-Bericht importieren
Was brevier import aus einer JasperReports-6-.jrxml liest, welche Elemente er umwandelt oder nennt, und wie die Optionen des PDF-Exports aussehen.
Auf dieser Seite
brevier import kontoauszug.jrxml -o templates/kontoauszugDer Import schreibt vier Dateien: kontoauszug.html, kontoauszug.css,
kontoauszug.schema.json und sample.json. Einen durchgehenden Lauf mit jeder
Datei zeigt die Seite Beispiel.
- Jeder Parameter
$P{bankName}wird zu{{bankName}}. - Das Detail-Band wird zu
{{#each rows}}, mit einer Zelle für jedes Feld$F{...}. kontoauszug.cssenthält das Layout von Seitenkopf, Tabelle und Fußzeile.kontoauszug.schema.jsonhat eine Eigenschaft für jeden Parameter undrowsmit einer Eigenschaft für jedes Feld.sample.jsonenthält erzeugte Werte, die Sie durch Ihre Daten ersetzen.- Eine Spalte mit Zahlentyp ist rechtsbündig. Die erste Spalte mit Dezimaltyp trägt ihre Summe auf die nächste Seite: siehe Tabellen.
Welche Dateien der Import liest
| Datei | Ergebnis |
|---|---|
.jrxml im Format von JasperReports 6 |
Wird importiert. |
.jrxml im Format von JasperReports 7 (<element kind="...">) |
Wird mit einem Fehler und der Zeile ihres ersten Elements abgelehnt. |
.jasper (die kompilierte Form) |
Wird abgelehnt. Importieren Sie die .jrxml, die Ihr Build kompiliert. |
Was der Import umwandelt und was er nennt
Jedes Element hat eines von zwei Ergebnissen:
- Umgewandelt: Es wird zu Vorlagentext, CSS oder einem Formatierer.
- Genannt: Der Import gibt es mit seiner Zeile aus und lässt es weg. Der
Befehl schreibt für jedes eine Zeile, zum Beispiel
Not converted: line 41: crosstab. Die letzte Spalte der Tabelle sagt, was Sie von Hand tun.
| Im Bericht | Ergebnis | In Brevier, oder was Sie tun |
|---|---|---|
textField mit $P{x} oder $F{x} |
umgewandelt | {{x}} |
pattern dd.MM.yyyy |
umgewandelt | {{x | date}} |
pattern für eine Zahl mit 2 Dezimalstellen und Euro-Zeichen |
umgewandelt | {{x | money}} |
.toUpperCase() |
umgewandelt | {{x | uppercase}} |
isBlankWhenNull, printWhenExpression und a ? b : c mit einem Feld, null oder einem Vergleich |
umgewandelt | {{#if}} ... {{else}} ... {{/if}} |
$V{PAGE_NUMBER}, und mit evaluationTime="Report" für die Seitenzahl |
umgewandelt | counter(page), counter(pages) |
$V{...} mit der Berechnung Nothing |
umgewandelt | Der Ausdruck der Variablen |
$V{...} mit der Berechnung Count, Sum, Average, Lowest oder Highest, wenn die Summe wie in JasperReports zurückgesetzt wird |
umgewandelt | {{rows | count}}, {{rows.x | sum}} |
group auf ein Feld, mit Kopf und Fuß |
umgewandelt | {{#group rows.x}} ... {{/group}} |
image mit einem Pfad, $P{x} oder $F{x} |
umgewandelt | <img src="..."> |
line, rectangle, frame, Rahmen und Abstände |
umgewandelt | <hr>, <div> und CSS-Rahmen |
Schrift, Größe, Fett, Kursiv, Farbe, Ausrichtung und style |
umgewandelt | CSS-Regeln |
title, pageHeader, columnHeader, detail, columnFooter, pageFooter und summary |
umgewandelt | Blöcke in der Reihenfolge der Seite |
subreport, crosstab, subDataset |
genannt | Verschachtelte Liste |
group auf einen Ausdruck, oder eine group-Option außer isStartNewPage, etwa keepTogether |
genannt | Gruppe von Hand |
| In Kopf oder Fuß einer Gruppe: ein Element, das kein Text ist, oder ein anderes Feld als das Gruppenfeld | genannt | Gruppe von Hand |
barChart, pieChart und jedes andere Diagramm, componentElement wie ein Barcode, genericElement, image ohne imageExpression oder mit einem onErrorType außer Error |
genannt | Bild aus der Anwendung |
$V{...} mit einer anderen Berechnung, eine Summe mit anderem Zurücksetzen, oder eine eingebaute Variable wie REPORT_COUNT oder PAGE_COUNT |
genannt | Wert aus der Anwendung |
pattern, das kein Formatierer schreibt, etwa ein Datum mit Uhrzeit |
genannt | Wert aus der Anwendung |
Eine andere Methode als .toUpperCase(), Rechnen, ein Minuszeichen und ! |
genannt | Wert aus der Anwendung |
a ? b : c mit && oder ||, ein Vergleich zweier Felder, oder in einer imageExpression |
genannt | Wert aus der Anwendung |
printWhenExpression mit && oder ||, ein Vergleich zweier Felder, oder im columnHeader |
genannt | Wert aus der Anwendung |
$R{...} |
genannt | Wert aus der Anwendung |
line oder rectangle im Detail-Band |
genannt | Weitere Auswege |
ellipse, break, elementGroup, noData, lastPageFooter, background |
genannt | Weitere Auswege |
Summen
Eine Summe wird nur umgewandelt, wo sie dieselben Zeilen umfasst wie in
JasperReports: resetType="Report" in der Zusammenfassung, resetType="Group"
im Fuß ihrer Gruppe und eine evaluationTime von Report oder Group am Ende.
Zwei Unterschiede bleiben. {{rows | count}} zählt jede Zeile, und JasperReports
überspringt eine Zeile, deren Wert null ist. Ein Betrag null stoppt sum mit
dem Feld und der Zeile der Vorlage, und JasperReports überspringt ihn.
Optionen des PDF-Exports
Die Optionen des PDF-Exports von JasperReports entsprechen Folgendem. Jedes Brevier-PDF ist PDF/A-3b, darum haben die Optionen für Verschlüsselung, PDF-Version, JavaScript, Tags und Farbprofil keine Einstellung.
| JasperReports-Option | In Brevier |
|---|---|
MetadataTitle |
<title> in der Vorlage. |
MetadataAuthor, MetadataSubject, MetadataKeywords, MetadataCreator |
<meta name="author">, "description", "keywords", "generator". |
BookmarksEnabled |
Das PDF hat ein Lesezeichen für jede Überschrift h1 bis h6. Um eines wegzulassen, setzen Sie bookmark-level: none in seiner CSS-Regel. |
SizePageToContent, die Seitenversätze |
Keine. Setzen Sie Seitengröße und Ränder im CSS mit @page. |
Encrypted, UserPassword, Permissions, PdfVersion, PdfJavaScript, Tagged |
Keine. |
Weiter: Auswege für die genannten Elemente und Den Aufruf ersetzen.