BIRT - Voraussetzungen und Installation

Voraussetzungen

• Java: Es wird die Java Runtime vorausgesetzt. Das JRE (Java Runtime Environment) muss installiert werden. Wird beispielsweise das vollständige Report Designer Full Eclipse Install-Paket installiert, benötigt man JRE 64bit.
• BIRT: Der Report Designer ist nicht Teil von WinCC OA. Installieren Sie die aktuelle birt-report-designer-all-in-one Version mit 64 Bit.
  VORSICHT: Versichern Sie sich vor der Installation, dass die gewählte BIRT-Version mit dem installierten JRE kompatibel ist! Ist dem nicht so, wird die Anwendung nicht funktionieren!

Installation

• Installieren Sie die aktuelle birt-report-designer-all-in-one Version mit 64 Bit.
• Installieren Sie Java-Runtime: Laden Sie die Java-Version herunter.

-vm
C:\Program Files\Java\jre1.8.0_65\bin\server\jvm.dll

Report Designer Full Eclipse Install

1. Starten Sie die Exe-Datei über <eclipePfad>eclipse.exe. Klicken Sie auf "Run" und danach auf "Launch" im Installationswizard:

   

2. Wenn BIRT (Eclipse) geöffnet wird, sieht das Fenster wie folgt aus:

   

3. Nach der Installation von BIRT und Java, kann nun ein Report-Projekt erstellt werden. Wie Sie ein Projekt erstellen, wird im Kapitel Neues Reportprojekt erklärt.

   

BIRT Runtime

Die folgende Beschreibung ist keine detaillierte Dokumentation von BIRT. Um nähere Informationen zu erhalten, ist die Verwendung von fachspezifischer Literatur erforderlich.

Mit der WinCC OA-Installation wird eine Reihe fertig konfigurierter Reporting-Templates mitgeliefert, die sofort in BIRT verwendet werden können. Diese befinden sich unter <wincc_oa_path>\data\Reporting\Templates\BIRT. Siehe auch Kapitel Simulationswerte.

Für die Runtime empfehlen wir Apache Tomcat (http://tomcat.apache.org/) zu verwenden. Im Folgenden finden Sie eine Beschreibung der Tomcat-Installation.

1. Java sollte auf dem Rechner bereits installiert sein. Installieren Sie gegebenenfalls Java (siehe auch Voraussetzungen und Installation). Der Java-Pfad wird bei der Installation von Tomcat benötigt.
2. Installieren Sie die Tomcat (In diesem Beispiel wird die Tomcat-Version 8.0.21 installiert). Laden Sie den Installer unter http://tomcat.apache.org/download-80.cgi:herunter.

   

3. Tomcat kann so installiert werden, dass er bei einem Reboot automatisch startet. Gehen Sie wie folgt vor.
   1. Öffnen Sie den Installationsassistenten und klicken Sie auf Next >

      

   2. Akzeptieren Sie die Lizenzbedingungen

      

   3. Selektieren Sie die Installationsoption. Wir empfehlen den Installationstyp "Full" zu selektieren.

      

   4. Geben Sie die Portnummern sowie einen Benutzernamen und ein Passwort ein. Wir empfehlen einen Benutzernamen und ein Passwort zu verwenden. Ohne Benutzer und Passwort kann die Tomcat-Managerapplikation nicht verwendet werden (siehe Kapitel Tomcat-Sicherheit).

      

   5. Selektieren Sie den Java-Installationspfad.

      

   6. Selektieren das Installationsverzeichnis für die Tomcat-Installation. Tomcat wurde installiert.

      

4. Kopieren Sie aus dem BIRT Runtime-Ordner den WebViewerExample-Ordner und fügen Sie den Ordner zu dem Webapps-Ordner der Tomcat-Installation hinzu.

   

   

5. Öffnen Sie die Tomcat-Manager-Anwendung in einem Browser unter der lokalen IP-Adresse, auf welcher der Tomcat Server läuft.

   

6. Klicken Sie auf "Manager App" auf der rechten Seite, um die Web-Seite des Anwendungsmanagers anzuzeigen:

   

7. Öffnen Sie eine BIRT-Index-Seite unter http://<IP Adresse>:<Portnummer>/WebViewerExample über Klick auf den /WebViewerExample -Pfad (siehe Abbildung oberhalb). Sie können mehrere Verzeichnisse auf dem Webserver unter web server/Tomcat_InstallationPath/webapps speichern. d.H. Sie können die Index-Seite oder ein Report aus dem Verzeichnis "WebViewerExample" oder aus einem anderen Verzeichnis öffnen. Achten Sie darauf, dass das Verzeichnis in der "Tomcat Web Application Manager"-Übersicht (siehe Abbildung oberhalb) auf "Running" gesetzt ist. Klicken Sie auf "Start" um das Verzeichnis zu starten.
   VORSICHT:

   Standardmäßig ist die Anzeige von "externen" Reports im BIRT deaktiviert. Das bedeutet, dass nur die Reports, die auf dem Webserver liegen, angezeigt werden.

   Wenn auch "externe" Reports dargestellt werden sollen, setzen Sie den Parameter: WORKING_FOLDER_ACCESS_ONLY in der web.xml-Datei unter birt-runtime[version]/WebViewerExample/WEB-INF/web.xml auf "false" - siehe unterhalb:

   <context-param>
   <param-name>WORKING_FOLDER_ACCESS_ONLY</param-name>
   <param-value>false</param-value>
   </context-param>

   Wir empfehlen die Reports auf dem Server abzulegen.

   

8. Öffnen Sie mit „View Example“ einen Beispielreport (<IP-Adresse>:<Portnummer>/WebViewerExample/frameset?__report=test.rptdesign&sample=my+parameter). Beachten Sie, dass Cookies für die korrekte Funktion des Viewers zugelassen sein sollten.

   

   Anmerkung: Sie können Ihre Reports in einem beliebigen Verzeichnis auf dem Webserver unter Tomcat_InstallationPath/webapps speichern. In der Abbildung unterhalb wurde ein Report im report-Verzeichnis unter Tomcat_InstallationPath/webapps/WebViewerExample/report gespeichert.

   

9. Öffnen Sie den Report:<IP-Adresse>:<Portnummer>WebViewerExample/frameset?__report=report/test.rptdesign&sample=my+parameter, z.B.:

   http://158.226.40.234:777/WebViewerExample/frameset?__report=report/test.rptdesign&sample=my+parameter

   

10. Wir empfehlen Maßnahmen zur Erhöhung der Sicherheit zu treffen. Siehe Kapitel Tomcat-Sicherheit. Eine Übersicht über die verschiedenen Einstellmöglichkeiten in der Web Viewer Web.xml finden Sie unter:
    • http://eclipse.org/birt/documentation/integrating/viewer-usage.php