View source for Setup:Installation Guide/Webservices/PDF-Export

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

Make sure that the [[Setup:Installation_Manual/System_Configuration/Apache_Tomcat|Apache Tomcat server]] is completely installed and configured on the BlueSpice server before setting up PDF-Export.

==Moving the BShtml2PDF Application==
Download the file "BShtml2PDF.war" from https://sourceforge.net/projects/bluespice/files/webservices/BShtml2PDF.war/download and copy it to <code>&lt;tomcat-webapps&gt;</code>

The default paths are as follows:

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

The application usually starts automatically without the need for rebooting the application server.

==Checking the functionality==
The correct functionality of the BShtml2PDF service can be checked as follows:

On Windows, open Internet Explorer using the URL <nowiki>http://localhost:8080/BShtml2PDF</nowiki>. With correct functionality, you should see the following website:
[[File:Setup:Tomcat_Check_03.png|center|400px|Tomcat Check 03]]

==Enable PDF Export in BlueSpice==
Go to the directory <code>&lt;installpath-bluespice&gt;/settings.d</code>. Open the file '''020-BlueSpiceUEModulePDF.php''' in a text editor.

In the second line is the code to activate the extension:

 return; // Disabled. Needs Tomcat

You can either add a comment character (#) to the beginning of this line or delete the line completely, save the file and exit it.

Open a command line and change into the folder <code>&lt;installpath-bluespice></code>. Execute the following command:

 php maintenance/update.php ''(Linux)''
 php maintenance\update.php ''(Windows))''
{{Hint
|text=In Windows, make sure that the environment variables are set correctly to access the "php" command.}}
{{Hint
|text=Note that you must update the [[Setup:Installation Guide/Security Settings/File System Permissions#Assignment_of_Permissions_with_Linux|file system permissions]] after running update.php.}}

When the script is finished with the "Done" message, you have successfully isntalled the web service .

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

==Troubleshooting==
If there is a problem with the PDF export in BlueSpice, first check the [[Setup:Installation Guide/Security Settings/File System Permissions|file system permissions]].
==Download Web services==
If the required war-file is missing in your installation package, you can download it here: [https://buildservice.bluespice.com/webservices3.tar.gz Webservices].


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