Formularvorlagen bearbeiten
Dateien .jrxml und .jasper
Nach der Einrichtung sehen Sie für jeden Dateinamen zwei Endungen.
.jrxml-Dateien sind die Dateien, die Sie bearbeiten.
.jasper-Dateien sind die Dateien, die der HELIUM 5 Server zum Anzeigen benötigt.
Durch Kompilieren erzeugen Sie eine .jasper-Datei aus einer .jrxml-Datei.
Parameter, Fields, Variables
Grundsätzlich können Sie sich einen Report wie eine Tabelle vorstellen. Wenn Ihr Report zum Beispiel ein Auftrag ist, dann können Sie sich eine Tabelle über die Auftragspositionen vorstellen. Die Variablen eines Reports werden in drei Gruppen aufgeteilt.
Parameter
Unter Parameter finden Sie die Variablen, die für die gesamte Tabelle gelten.
Zugriff auf einen Parameter mit dem Namen P_KOPFTEXT ist über $P{P_KOPFTEXT} möglich.
Beispiel: Ihr Report ist ein Auftrag. Parameter des Auftrags sind zum Beispiel der Empfänger des Auftrags, die Auftragsnummer und der Gesamtwert des Auftrags.
Parameter werden von uns vorgegeben. Bei jedem HELIUM 5 Update können neue Parameter hinzukommen. Diese Parameter werden nicht in Ihre Anwenderreports übertragen. Kopieren Sie sie bei Bedarf einfach aus dem Originalreport.
Fields / Felder
Unter Fields finden Sie die Variablen, die pro Tabellenzeile wiederholt werden.
Zugriff auf ein Feld mit dem Namen Gesamtpreis ist über $F{Gesamtpreis} möglich.
Beispiel: Ihr Report ist ein Auftrag. Die Tabelle beinhaltet alle Auftragspositionen. Fields des Auftrags sind zum Beispiel die Artikelnummer der Position oder der Positionspreis.
Variables / Variablen
Als dritte Gruppe finden Sie Variables. Variablen sind von Ihnen definierte Variablen, die nicht für das Füllen des Dokuments von HELIUM 5 mitgegeben werden. Variablen werden immer neu berechnet.
Spalten anlegen
Mit Jaspersoft Studio können mehrspaltige Reports definiert werden, so wie sie z.B. für Laseretiketten für Laserdrucker (Zweckform, Herma, ...) benötigt werden. Definieren Sie dazu die Eigenschaften des Reports unter Bearbeiten, Reporteigenschaften und klicken Sie auf den Reiter Spalten. Geben Sie hier die gewünschte Anzahl der Spalten ein und definieren Sie auch den benötigten Zwischenraum.
Im Report finden Sie nun die angegebenen Spalten angezeigt. Definieren Sie nur die Inhalte der linken Spalte.
Funktionen HelperReport
Alle Funktionen sind in der Klasse com.lp.util.HelperReport gesammelt. Der Aufruf aus Jaspersoft Studio entspricht immer dem Muster com.lp.util.HelperReport.FUNKTION, wobei Sie FUNKTION durch den Namen und die Übergabeparameter der Funktion ersetzen.
Beschreibung | Funktionsaufruf mit Parametern | Rückgabewert |
|---|---|---|
Prüfung: Sind in dem String nur Code39 druckbare Zeichen enthalten? | pruefeObCode39Konform(String sString) | boolean |
Ersetzt Umlaute mit deren Entsprechung ohne Umlaut | wandleUmNachCode39(String input) | String |
Wandelt einen Zeitstempel in eine Dezimale | time2Double(java.sql.Time time) | Double |
Wandelt Ö auf Oe usw. | ersetzeUmlaute(String input) | String |
Ersetzt Umlaute mit deren Entsprechung ohne Umlaut | wandleUmNachCode128(String input) | String |
Ersetzt Umlaute mit deren Entsprechung ohne Umlaut. Schneidet nach einer übergebenen Anzahl von Stellen ab. | ersetzeUmlauteUndSchneideAb(String input,int maxStellen) | String |
Liefert den Wochentagsnamen in der jeweiligen Sprache | getWochentag(java.util.Locale locale, java.sql.Timestamp tDatum) | String |
ganzzahligerBetragInWorten(Integer betrag) | String | |
getCalendarOfTimestamp(java.sql.Timestamp tTimestamp, Locale locale) | Integer | |
Liefert den Monatsnamen eines Jahres und einer Kalenderwoche | getMonatVonJahrUndWoche(Integer iJahr, Integer iWoche, Locale locale) | String |
getCalendarWeekOfDate(Date date) | Integer | |
getCalendarWeekOfDate(String sDate, Locale locale) | Integer | |
pruefeEndsumme(BigDecimal bdReportNettoValue, BigDecimal bdHvValue, Double dAbweichung, String listeMwstsaetze, Locale reportLocale) | Boolean | |
Ermittelt die Länderart des Kunden in Bezug auf die Basis (= Mandant) | laenderartZweierLaender(String lkzKunde, String lkzBasis, String uidNummer, java.sql.Timestamp tsEUMitglied) | String |
'nummer' darf nur Ziffern zwischen 0 und 9 enthalten | berechneModulo10(String nummer) | int |
berechneModulo10Str(String nummer) | String | |
double2Time(Number zahl) | Time | |
Konvertierung eines Strings zu BigDecimal in Locale "deAT"
| toBigDecimal(String bigDecimal) | BigDecimal |
Wandelt nach BigDecimal in angegebener Locale
| toBigDecimal(String bigDecimal, Locale locale) | BigDecimal |
Wandelt nach BigInteger mit Radix 10 (Dezimalzahlen)
| toBigInteger(String bigInteger) | BigInteger |
Wandelt nach BigInteger mit angegebenen Radix (oktal, hex, ....)
| toBigInteger(String bigInteger, int radix) | BigInteger |
Wandelt nach Integer
| toInteger(String integer) | Integer |
Keine Fehlerprüfung, bei Fehler wird null zurückgegeben.