Quelltext der Seite Setup:Installationsanleitung/Webservices/PDF-Export

{{DISPLAYTITLE:Webservice: PDF-Export}}
__TOC__

Dieses Dokument beschreibt die Installation des PDF-Export von BlueSpice. Bitte beachten Sie, dass als Applikationsserver [[Setup:Installationsanleitung/Systemvorbereitung/Windows/Apache_Tomcat|Apache Tomcat]] (Windows) bzw. [[Setup:Installationsanleitung/Systemvorbereitung/Linux/Jetty|Jetty]] fertig installiert und konfiguriert auf dem BlueSpice-Server laufen muss.

==Verschieben der BShtml2PDF Anwendung==
Verschieben Sie die Datei "BShtml2PDF.war" aus dem Verzeichnis <code>extensions/BlueSpiceUEModulePDF/webservices</code> der BlueSpice-Quellen nach in das webapps-Verzeichnis Ihres Applikationsservers. In der Regel lauten die Standardpfade wie folgt:

*C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps '''(Apache Tomcat unter Windows)'''
*/var/lib/jetty9/webapps '''(Jetty unter Debian)'''

Die Anwendung wird im Regelfall on-the-fly gestartet, ohne dass ein Neustart des Applikationsservers nötig ist.

==Überprüfen der Funktionalität==
Die korrekte Funktionalität des BShtml2PDF Service können Sie wie folgt überprüfen:

===Unter Windows===
Öffnen Sie im Internet Explorer die URL <nowiki>http://localhost:8080/BShtml2PDF</nowiki>. Bei korrekter Funktionalität sollten Sie folgende Webseite sehen:
[[File:Setup:Tomcat_Check_03.png|center|400px|Tomcat Check 03]]

==Aktivieren von PDF-Export in BlueSpice==
Wechseln Sie in das Verzeichnis <code>&lt;installpath-bluespice&gt;/settings.d</code>. 
Öffnen Sie die Datei <br>'''020-BlueSpiceUEModulePDF.php''' in einem Texteditor.

In der zweiten Zeile finden Sie einen Code, der bei dies Erweiterungen deaktiviert:
 return; // Disabled. Needs Tomcat

Fügen Sie wahlweise ein Kommentarzeichen  ('''#''') an den Anfang dieser Zeile ein oder löschen Sie diese Zeile komplett, speichern die Datei und verlassen Sie diese wieder.

Öffnen Sie nun eine Kommandozeile und wechseln in den Ordner <code>&lt;installpath-bluespice&gt;</code>. Führen Sie dort folgenden Befehl aus:

 php maintenance/update.php ''(Linux)''
 php maintenance\update.php ''(Windows))''
{{Hint
|text=Achten Sie unter Windows darauf, dass die [[Setup:Installationsanleitung/Systemkonfigurationen/Umgebungsvariablen|Umgebungsvariablen]] korrekt gesetzt sind, um auf den Befehl "php" zugreifen zu können.}}

{{Hint
|text=Beachten Sie unter Linux, dass Sie nach dem Ausführen der update.php die [[Setup:Installationsanleitung/Sicherheitseinstellungen/Dateisystemrechte#Verrechtung_unter_Linux|Dateisystemrechte]] neu anpassen müssen.}}

Sobald das Script mit der Meldung "Done" abgeschlossen ist ist der Webservice erfolgreich installiert.<br /><br />

[[Datei:Setup:Setup_bluespice_maintenance_update.jpg|center|400x556px]]

==Troubleshooting==
Sollte es beim PDF-Export in BlueSpice Probleme geben überprüfen Sie zu allererst die [[Setup:Installationsanleitung/Sicherheitseinstellungen/Dateisystemrechte|Dateisystemrechte]].

==Download Webservices==
Sollten die erforderliche war-Datei nicht in Ihrem Installationspaket vorhanden sein, können Sie sie hier herunterladen: [https://buildservice.bluespice.com/webservices3.tar.gz Webservices]

[[de:{{FULLPAGENAME}}]]
[[en:Setup:Installation_Manual/Webservices/PDF-Export]]