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