Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

Aktuell wird das Reporting-Modul für die Rechnungserstellung (Rechnungsvorlagen) verwendet.

Table of Contents

Funktionsweise

Das Reporting Module basiert auf den JasperReports Bibliotheken (freier Report-Designer unter http://community.jaspersoft.com/project/ireport-designer). Dabei werden .jrxml Dateien (Report-Vorlagen), die auf der Server-Umgebung zur Verfügung - falls notwendig - zur Laufzeit (bei Report-Erzeugung) übersetzt. Danach wird der Report ausgeführt. Dazu stellt das System die aktuelle Datenbankverbindung und die benötigten Laufzeitparameter (Reporting-Parameter) zur Verfügung. Die Reporting-Parameter sind dabei von System-Seite definiert und nicht von Report-Seite.

...

(Lese- und Schreibberechtigung für den Benutzer unter dem der Applikation Server läuft). Bei der Erzeugung der Reports entstehen im Verzeichnis /tmp ebenfalls temporäre Dateien. Diese sollten bzw. müssen regelmäßig über einen Systemjob (cron-job) aufgeräumt werden.

Verwendung

Das Reporting-Modul wird gegenwärtig für die Abrechnung (Rechnungsvorlagen) verwendet. In der Regel existiert für die Eingangs- und Ausgangsrechnungen ein Standardvorlage. Die Definition für die zu verwendende Standardvorlage wird in der Regel über Systemparameter gesteuert.

SystemparameterVerwendungVoreinstellung
RECHNUNG_REPORT_MITGLIEDER_DEFAULTVorlage Ausgangsrechnung Mitgliederabrechnung2
RECHNUNG_REPORT_VERBAND_DEFAULTVorlage Ausgangsrechnung Verbandsabrechnung4

Aktualisierung von Report Vorlagen

Bei der Aktualisierung von Report-Vorlagen muss der neue Report im Verzeichnis

...

nicht gelöscht wurden werden die "alten" Dateien weiterverwendet.

Sicherheit

Da das Reporting Modul ggf. Zugriff auf sämtliche Daten benötigt, ist eine Rechtekontrolle innerhalb der Daten, die für einen Report verwendet werden, nicht mehr möglich. Das bedeutet, dass Datensicherheit hier nur über den Zugriff der Report-Generierung hergestellt werden kann. Aus diesem Grund ist die Einstellung und Definition von Reports systemseitig beschränkt.

Standardvorlagen bearbeiten

Alle Standardvorlagen (.jrxml) können mit dem iReport- Designer (ab Version 5.1) der JasperSoft Community (siehe http://community.jaspersoft.com/project/ireport-designer) bearbeitet werden.

Info

Eine Datenbank für die Bearbeitung von Reports ist nicht notwendig. Allerdings liefert der Preview dann natürlich keine Ergebnisse.

Schriften

Bei Änderungen an den Reports sollte unbedingt darauf geachtet werden, dass nicht alle Schriftarten (Fonts), die ggf. im Report Designer angeboten werden, verwendbar sind. Verwendet werden können nur diejenigen Schriftarten, die auf dem Server, auf dem der Report später erzeugt wird, auch installiert sind. Da die Font-Dateien sind nicht Bestandteil der Reportvorlage sind (da die Weitergabe von Fonts ggf. rechtlichen Beschränkungen unterliegen kann), sollte die Reporterzeugung in jedem Fall auf dem Zielsystem geprüft werden.

...

Tip

Sollen andere Schriften als die Standardschriften verwendet werden, dann sollte vorab geprüft werden, ob diese auf dem Server System installiert sind (Kommandozeile: fc-list :lang=DE).

Standardschriften

Die JasperReport Biliotheken verwenden die iText Bibliotheken, um die Schriften zu rendern. Folgende Schriften funktionieren damit in jedem Fall:

  • Courier

  • Courier-Bold

  • Courier-BoldOblique

  • Courier-Oblique

  • Helvetica

  • Helvetica-Bold

  • Helvetica-BoldOblique

  • Helvetica-Oblique

  • Symbol

  • Times-Roman

  • Times-Bold

  • Times-BoldItalic

  • Times-Italic

  • ZapfDingbats

Beispieldatenbank

Eine Beispieldatenbank dient dazu, sich die Ergebnisse von Änderungen an Vorlagen sinnvoll ansehen zu können. Beispieldatenbank auf dem Produktivsystem erzeugen über folgende shell-Kommandos:

  • user=LIVE_USER
    db=LIVE_DB
    host=LIVE_HOST

  • mysqldump -u $user -p -h $host $db Rechnung RechnungsItem LinkableEntry \
    ZahlungsKondition BeitragsSatz BeitragsArt BeitragsKonto BeitragsZahlung> ica_report_data.sql

Standardvorlagen

Liste der Standardvorlagen, die in der jeweils aktuellen Version mit dem System installiert werden:

...