Das Vorlagen-Modul ermöglicht die Anpassung von Reports, die vom System verwendet werden, um Berichte bestimmte Dokumente zu erzeugen. . Außerdem tauchen hier auch alle individuellen Reports auf, die unter Modul Reports erstellt wurden.
| Info |
|---|
Dies umfasst im Standard Vorlagen für die Rechnungserstellung (Rechnungsvorlagen), es können jedoch auch beliebige individuelle Reports erstellt werden. Zum Verwenden von allgemeinen bzw. individuellen Reports siehe Modul Reports. |
...
Das Modul 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 stehen - 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.
...
/home/jboss/reports/build
(Erforderlich sind 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
Rechnungsvorlagen
Das Modul wird gegenwärtig zum einen 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.
| Systemparameter | Verwendung | Voreinstellung |
|---|---|---|
| RECHNUNG_REPORT_MITGLIEDER_DEFAULT | Vorlage Ausgangsrechnung Mitgliederabrechnung | 2 |
| RECHNUNG_REPORT_VERBAND_DEFAULT | Vorlage Ausgangsrechnung Verbandsabrechnung | 4 |
Aktualisierung von Report Vorlagen
Bei der Aktualisierung von Report-Vorlagen muss der neue Report im Verzeichnis
/home/reports abgelegt werden. Damit der Report neu übersetzt wird, muss die vom System erzeugte Report-Datei (.jrxml) und die kompilierte Version entfernt werden (.jasper). Die Namen der Dateien (ohne Suffix) entsprechen dem Namen in der JasperReport-Tabelle. Falls die existierenden Dateien im Unterverzeichnis
./build ...
Individuelle Reports
Im Bereich Modul Reports können beliebige individuelle Reports verwaltet werden, die entweder dort auch ausgeführt werden, oder aber als gruppierungsspezifische Reports in der Gruppierungsverwaltung zur Verfügung stehen.
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.
...
(Standard)Vorlagen bearbeiten
Alle Standardvorlagen (Standard)Vorlagen (.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. |
Aktualisierung von Report Vorlagen
Bei der Aktualisierung von Report-Vorlagen muss der neue Report im Verzeichnis
/home/reports abgelegt werden. Damit der Report neu übersetzt wird, muss die vom System erzeugte Report-Datei (.jrxml) und die kompilierte Version entfernt werden (.jasper). Die Namen der Dateien (ohne Suffix) entsprechen dem Namen in der JasperReport-Tabelle. Falls die existierenden Dateien im Unterverzeichnis
./build nicht gelöscht wurden, werden die "alten" Dateien weiterverwendet.
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.
...
Liste der Standardvorlagen, die mindestens in der jeweils aktuellen Version mit dem System installiert werden:
...