CIB doXiview technischer Leitfaden
Erste Schritte bei der Verwendung von CIB webprint in CIB doXiview
Möchte der Benutzer ein in CIB doXiview angezeigtes Dokument drucken, so wird standardmäßig der Browserdruck angewendet. Es besteht jedoch die Möglichkeit, mit CIB webPrint den Druck auf die eigenen Bedürfnisse anzupassen. So können z.B. kundenspezifische Druckdialoge und Druckmodule einfach integriert werden.
Anbei folgt eine Kurzanleitung mit den wichtigsten Punkten zur Verwendung von CIB webPrint:
1) Konfiguration der Druckmodi in CIB doXiview
Der Druckmodus kann auf zwei verschiedene Wege konfiguriert werden. Serverseitig kann die Property print.mode.default in der Datei doxiview/WEB-INF/classes/environment-config.properties gesetzt werden. Über diese Property wird das Standarddruckverfahren ausgewählt. Außerdem ist es möglich, via Startparameter printMode das Druckverfahren zu konfigurieren. In beiden Fällen können folgende Werte gesetzt werden:
- browser
Der Druck erfolgt über den Browser - external
Der Druckauftrag wird an die integrierende Anwendung übergeben. - webprint
Der Druckauftrag wird an CIB webPrint übergeben.
Um CIB webPrint nutzen zu können, muss die Property print.mode.default oder der Startparameter printMode auf den Wert webprint gesetzt werden.
2) Deployment der Druckdialoge
Die Druckdialoge sind in einem speziellen Applikationsarchiv namens doxiview-printdialogs-<version>.war implementiert. Dieses Applikationsarchiv wird zum Deployment in das Unterverzeichnis webapps der Tomcat Installation kopiert. Zusätzliche Konfigurationen sind nicht nötig.
3) Deployment und Konfiguration von CIB webPrint
CIB webPrint ist in einem speziellen Applikationsarchiv namens webprint_doxiview_war-<version>.war implementiert. Dieses Applikationsarchiv wird zum Deployment in das Unterverzeichnis webapps der Tomcat Installation kopiert.
Die Konfiguration erfolgt über eine Properties-Datei WEB-INF/config.properties. Die beiden Properties drain.url und webstore.url enthalten beide standardmäßig die URL des Webstore.
Wie im Abschnitt Externalisierung der Konfiguration beschrieben, kann die Konfigurations-Datei auch extern, also außerhalb des .war Archivs abgelegt werden. Der Name der externen Konfigurations-Datei ist cib-webprint-doxiview.properties.
4) Deployment und Konfiguration der Druckmodule
Druckmodule kennen alle im Netzwerk zur Verfügung stehenden Drucker und leiten den Druckauftrag an den ausgewählten Drucker weiter. Deployment und Konfiguration hängen sehr stark von der Art des Druckmoduls ab. Deshalb sei hier auf die jeweilige Dokumentation des Druckmoduls verwiesen.
5) Konfiguration von CIB webPrint in CIB doXiview
Im Folgenden werden die serverseitigen Properties zur Konfiguration von CIB webPrint kurz beschrieben.
Property |
Beschreibung |
webprint.url |
Die URL von CIB webPrint |
webprint.dialog.url |
Die URL von den Druckdialogen |
webprint.output.service.url |
Die URL vom Druckmodul |
webprint.drain.url |
Die URL vom Webstore |
Im Folgenden werden die Startparameter zur Konfiguration von CIB webPrint kurz beschrieben.
Startparameter |
Beschreibung |
webprint.outputServiceType |
Der Druckmodul Typ |
webprint.outputServiceUrl |
Die URL vom Druckmodul |
webprint.outputServiceName |
Der Name vom Druckmodul |