Zuletzt bearbeitet vor 2 Jahren
von Margit Link-Rodrigue

Referenz:BlueSpiceSocialProfile und Setup:Installationsanleitung/Webservices/PDF-Export: Unterschied zwischen den Seiten

(Unterschied zwischen Seiten)
K (Textersetzung - „Box Note“ durch „Hinweisbox“)
 
Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
 
Zeile 1: Zeile 1:
{{BSExtensionInfo
{{DISPLAYTITLE:Webservice: PDF-Export}}
|status=stable
__TOC__
|developer=Patric Wirth
|type=BlueSpice
|edition=BlueSpice pro, BlueSpice Farm, BlueSpice Cloud
|active=Ja
|compatible=BlueSpice
|category=Kommunikation
|license=GPL v3 only
|features=
'''BlueSpiceSocialProfile''' stellt den SocialEntity-Typ ''profile'' zur Verfügung. Außerdem wird die Benutzerseite in ein vollständiges Benutzerprofil umgewandelt.


* Die Benutzerseite wird in der Ansicht komplett durch das SocialEntity profile ausgetauscht.
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.
* Der Inhalt der originalen Benutzerseite wir unterhalb der Profildaten ebenfalls - als eine Art Beschreibungsfeld - dargestellt.
 
* Ermöglicht die Spezialseite ''Spezial:SocialProfiles''
==Verschieben der BShtml2PDF Anwendung==
* Das Tag <code><nowiki><bs:socialentityprofile username="Testuser" rendertype="Short" /></nowiki></code> erlaubt es, ein einzelnes Benutzerprofil im Seiteninhalt anzuzeigen.
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:
* Die originale Benutzerseite ist über die Schaltfläche ''Klassische Profilseite'' erreichbar
 
* Benutzer können ihre Profildaten bearbeiten und ein Benutzerbild hochladen
*C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps '''(Apache Tomcat unter Windows)'''
{{Hinweisbox|boxtype=warning|Note text=Seiten in den Namensräumen ''SocialEntity'' and ''Benutzer'' wurden bis Version 3.1.13 von öffentlichen Suchmaschinen indexiert. Wenn Sie ein öffentliches Wiki mit einer früheren Version betreiben, sollten Sie diese [https://www.mediawiki.org/wiki/Help:Controlling_search_engine_indexing Namensträume von der öffentlichen Suche ausschließen] - außer Sie wünschen, dass diese Seiten indexiert werden.}}
*/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))''
{{Hinweisbox
|Note 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.}}
 
{{Hinweisbox
|Note 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]]

Version vom 19. Januar 2022, 09:13 Uhr

Dieses Dokument beschreibt die Installation des PDF-Export von BlueSpice. Bitte beachten Sie, dass als Applikationsserver Apache Tomcat (Windows) bzw. Jetty fertig installiert und konfiguriert auf dem BlueSpice-Server laufen muss.

Verschieben der BShtml2PDF Anwendung[Bearbeiten | Quelltext bearbeiten]

Verschieben Sie die Datei "BShtml2PDF.war" aus dem Verzeichnis extensions/BlueSpiceUEModulePDF/webservices 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[Bearbeiten | Quelltext bearbeiten]

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

Unter Windows[Bearbeiten | Quelltext bearbeiten]

Öffnen Sie im Internet Explorer die URL http://localhost:8080/BShtml2PDF. Bei korrekter Funktionalität sollten Sie folgende Webseite sehen:

Tomcat Check 03

Aktivieren von PDF-Export in BlueSpice[Bearbeiten | Quelltext bearbeiten]

Wechseln Sie in das Verzeichnis <installpath-bluespice>/settings.d. Öffnen Sie die Datei
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 <installpath-bluespice>. Führen Sie dort folgenden Befehl aus:

php maintenance/update.php (Linux)
php maintenance\update.php (Windows))
Hinweis:Achten Sie unter Windows darauf, dass die Umgebungsvariablen korrekt gesetzt sind, um auf den Befehl "php" zugreifen zu können.


Hinweis:Beachten Sie unter Linux, dass Sie nach dem Ausführen der update.php die Dateisystemrechte neu anpassen müssen.


Sobald das Script mit der Meldung "Done" abgeschlossen ist ist der Webservice erfolgreich installiert.

Setup:Setup bluespice maintenance update.jpg

Troubleshooting[Bearbeiten | Quelltext bearbeiten]

Sollte es beim PDF-Export in BlueSpice Probleme geben überprüfen Sie zu allererst die Dateisystemrechte.

Download Webservices[Bearbeiten | Quelltext bearbeiten]

Sollten die erforderliche war-Datei nicht in Ihrem Installationspaket vorhanden sein, können Sie sie hier herunterladen: Webservices

Keine Kategorien vergebenBearbeiten

Diskussionen