Lade...
 

Technische Details

Technische Details zur Birt-ClassiX®-Interaktion System

Hinweis
Momentan wird nur die Version 4.6.0 (nur OSGI) und 4.7 aufwärts (nur POJO) unterstützt. Haben Sie eine andere Version installiert, so können Sie diese deinstallieren und anschließend die Version 4.6.0 installieren.

 

Design eines neuen Reports

  1. Durch Klicken des Reportsymbols aus einer ClassiX-Liste heraus gelangt man in ein Auswahlmenü, in dem man verschiedene Einstellungen Treffen kann:
    1. Name des zu erstellenden Reports (darf keine Leerzeichen und Umlaute enthalten)
    2. Anzeigename (so wird der Reportname im ClassiX-Menü zur Auswahl dargestellt)
    3. Kategorie
    4. Kundenableitung
    5. Orientierung des Reports (Hochformat bzw. Querformat)
    6. Außerdem gibt es noch die Reiter: Abfrage-Datenbasis, Spalten-Definitionen. Dort lassen sich neue Spalten in dem ClassiX-Auswahlmenü hinzufügen oder eine Datenbasis definieren, sodass der Report nicht zur aus dem Listen-Fenster selber aufgerufen werden kann. Details siehe hier.
  2. Nachdem die gewünschte Auswahl getroffen ist, muss diese einmal gespeichert werden und dann kann der Report-Designer (-Symbol) aufgerufen werden.
  3. Dabei wird die ClassiX-Liste wird mit einem XSL auf die Spalten-Beschreibungen geschrumpft. Bei der Berichtserstellung werden dadurch zwei XML-Dateien erzeugt. Die eine Datei enthält die Layout-Definition (Spaltengröße und Text-Ausrechtung), während die anderen nur die Daten enthält. Das zweite XML-Datei wird bei jedem Aufruf eines Reports erzeugt, da hier drin die in ClassiX ausgewählten Daten abgelegt werden.
  4. Zum Schluss wird ein JAVA-Program wird aufgerufen, dass die beiden erzeugten XML-Dateien einliest und daraus einen Report mit einer Tabelle erzeugt. Das Programm benutzt außerdem einen weiteren Report mit einer Master-Page, die lediglich festlegt ob der Report im Hochformat oder Querformat erscheinen soll und einen Default-Header für jede Seite des Reports festlegt.
     

Druck eines Reports

Der Reportdruck erfolgt mithilfe der Report-Engine (in der BIRT-Runtime enthalten), welche über das BIRT-Interface benutzt wird. Das BIRT-Interface stellt dabei nach Möglichkeit einen laufenden BIRT-Server bereit, der Anfragen zur Erstellung von Berichten entgegen nimmt.

Ablauf

  1. ClassiX ruft das Programm ExecuteReport.java auf und übergibt mindestens drei Parameter
    • den Dateinamen des Daten-XMLs (*.xml)
    • den Dateinamen des Report-Files (*.rptdesign)
    • den Dateinamen des Output-Files (typischerweise *.pdf)
  2. sowie optional,
    • ob der Bericht gedruckt werden soll und
    • welches Format der Bericht haben soll.
  3. Nach der Reporterstellung wird mit ShellExecute der Bericht geöffnet.

BIRT-Server

Der BIRT-Server ist ein eigenständiger Prozess, der Anfragen zur Erstellung eines Berichtes entgegen nehmen und ausführen kann. Er hält die Report-Engine im Speicher und verkürzt damit massiv die Zeit zur Erzeugung eines Berichts.

Standardmäßig wird ein BIRT-Server beim Start von ClassiX gestartet und an den Port 1789 gebunden. Da nur ein Prozess pro Computer an einen bestimmten Port gebunden werden kann, wird bei einer weiteren ClassiX-Instanz kein BIRT-Server gestartet. Der BIRT-Server wird jedoch mit der ursprünglichen ClassiX-Instanz geschlossen.

Möchte man das automatische Starten des BIRT-Servers verhindern, kann man die Umgebungsvariable CX_PREVENT_BIRT_SERVER setzen. Der BIRT-Server kann auch mithilfe der Batch-Datei Start_BIRT_Server.bat im Bin-Verzeichnis gestartet werden.

Spalten des Daten-XMLs

Das Daten-XMLs besteht aus 2 Bereichen: den Variablen und den Daten.

In den Variablen werden immer mindestens 4 Variablen:

  1. Datum
  2. Uhrzeit
  3. Bearbeiter
  4. Mandant

übergeben, die im Header des Reports erscheinen. Zusätzlich können von ClassiX aus noch weitere Felder übergeben werden. Diese werden fortlaufend nummeriert. Alle ClassiX-Variablen werden in einem Widget gespeichert.

Hinweis
Die Variablen müssen als Strings definiert werden bzw. umgewandelt werden. Variablen von einem anderen Typ werden ignoriert, sodass sich die Nummerierung der Variablen ändert. Alle Variablen sollten also mindestens als Leerstring "" (erscheint als ) definiert werden.

Im Daten-Bereich enthält das Daten-XML alle Spalten der Liste in ClassiX und gegebenenfalls noch Spalten, die über das Auswahlmenü (Reiter Spalten-Definitionen) hinzugefügt wurden. Bei den Spaltennamen werden alle Leerzeichen und Sonderzeichen durch Unterstriche ersetzt, dadurch wird der Umgang in BIRT erleichtert. Die Spalten-Namen im XML enthalten nicht die Typen der Datenfelder, sondern nur die Datenfelder selber. Um zwischen zwei Datenfeldern mit dem selben Namen, aber unterschiedlichem Typ unterscheiden zu können, kann ein Flag eingefügt werden.

Spalten, die eine Zahl mit Währung enthalten, werden speziell behandelt, indem 3 Spalten in das XML eingefügt werden:

  1. der komplette Ausdruck mit Zahl und Währung
  2. nur die Zahl um das Rechnen in BIRT zu vereinfachen
  3. nur die Währung, um am Ende der Rechnung in BIRT die richtige Währung einfügen zu können.

 

 

Hinweis
Momentan wird nur die Version 4.6.0 (nur OSGI) und 4.7 aufwärts (nur POJO) unterstützt. Haben Sie eine andere Version installiert, so können Sie diese deinstallieren und anschließend die Version 4.6.0 installieren.