Einbinden von BIRT in ClassiX®

BIRT ist ein Reporting Tool, das auf Eclipse aufsetzt. Es ist (wie die gesamte Eclipse-Infrastruktur) in Java geschrieben, daher setzt es eine Java-Umgebung voraus (http://java.sun.com). In ClassiX® wird Eclipse auch als Editor und Debugging-Werkzeug eingesetzt.

BIRT wird auf zwei Arten verwendet:

Für beide Modi muss eine unterschiedliche Installation durchgeführt werden.

Sollte die Zusammenarbeit von ClassiX® und Birt nicht funktionieren finden Sie im Abschnitt "Fehlersuche" Möglichkeiten, dass zu beheben.

Installation BIRT-Runtime (zum Ausführen von Reports)

  1. Download von BIRT-Runtime 2.5.1: http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/R-R1-2_5_1-200909220630/birt-runtime-2_5_1.zip
  2. Entpacken nach z.B. c:\programme\ (dort entsteht ein Ordner birt-runtime-2_5_1)
Name Beschreibung Beispiel Definition
BIRT_HOME In diesem Verzeichnis werden die BIRT Programme gesucht BIRT_HOME=c:\programme\birt-runtime-2_5_1 System
BIRT_RESOURCE_FOLDER In dieses Verzeichnis werden Report-Elemente für das ClassiX® Projekt abgelegt SET BIRT_RESOURCE_FOLDER=%CX_ROOTDIR%\BIRT ClassiX (Evaluate_START.bat)
CLASSPATH Mit dieser Variablen sucht Java die BIRT- und ClassiX-Bibliotheken SET CLASSPATH=%CX_BIN%\birt-interface.jar;%BIRT_HOME%\ReportEngine\lib\*;%CLASSPATH% ClassiX (Evaluate_START.bat)
CX_REPORTS In diesen Verzeichnissen sucht ClassiX nach den Reports SET CX_REPORTS=%CX_ROOTDIR%\BIRT\%CX_PROJECT_NAME%;%CX_ROOTDIR%\BIRT ClassiX (Evaluate_START.bat)

Installation von BIRT an einer ClassiX® Workstation (zum Entwerfen von Reports)

Der BIRT-Designer ist ein Plugin für Eclipse. Zur Installation siehe bitte hier. Anschließend sind gewisse Einstellungen in Eclipse vorzunehmen:

  1. Window/Preferences
  2. "Report Design" aufklappen
  3. Layout: Default Unit nach Belieben setzen (z.B. cm oder mm)
  4. Resource: Auswahl des Resource-Folders (zentraler Folder, kann leider nicht projektabhängig sein): y:\classix\Evaluate\BIRT

In den ClassiX-Projekten werden folgende Umgebungsvariablen verwendet und sollten in den Batch-Files oder der Systemumgebung gesetzt werden:

Name Beschreibung Beispiel Definition
CX_REPORTS_OUT In dieses Verzeichnis werden neue Reports abgelegt, die in ClassiX automatisch erstellt werden SET CX_REPORTS_OUT=%CX_ROOTDIR%\BIRT\%CX_PROJECT_NAME% ClassiX (Evaluate_START.bat)

BIRT-Report-Dokumente haben die Endungen .rptdesign und .rptlibrary. Diese sollten als Dateiendungen mit "eclipsecall.bat" verknüpft werden, damit sie aus ClassiX oder dem Explorer aus geöffnet werden können.

Fehlersuche

Es gibt verschiedene Gründe, warum ein Birt-Report aus ClassiX nicht aufgerufen werden kann:

Im Idealfall erzeugt oder öffnet ClassiX einen Birt-Report ohne weitere Benutzereingriffe. Je nach Fehlerfall bekommt ClassiX aber zu wenig Informationen, um eine eindeutige Fehlermeldung anzuzeigen. In diesem Fall muss die Kommunikation zwischen ClassiX und Birt geprüft, sowie die Fehlermeldung von Birt bzw. dem aufrufenden Programm analysiert werden. Dafür gibt es zwei Hilfsmittel: