Gerade wenn Dokumente an Dritte herausgegeben werden sollen, besteht oft die Anforderung diese mit einem Wasserzeichen oder einer besonderen Markierung zu versehen. Wenn der Erzeugungsprozess dieser Dokumente bereits mit jadice server durchgeführt wird, ist es ein Leichtes einen weiteren Verarbeitungsschritt in den Konvertierungsworkflow einzufügen.
Hierzu bietet jadice server zwei grundlegend verschiedene Ansätze, wie dies umgesetzt werden kann:
- Einsatz eines
PageDecorators, wenn ein Dokument mit den Mitteln der jadice document platform als PDF neu gerendert wird.
Dieses Vorgehen bietet empfiehlt sich dann an, wenn ein Dokument in einem Format vorliegt, dass von der der jadice document platform nativ unterstützt wird und mittels desJadiceShaperNodes in PDF konvertiert wird. - Über ein bereits bestehendes PDF-Dokument wird eine "Maske" gelegt, die in einem zweiten PDF vorab generiert wurde.
Dieses Vorgehen bietet sich insbesondere dann an, wenn- das PDF-Dokument bereits vorliegt,
- während eines vorherigen Schrittes im Workflow vorliegt oder
- ein Neu-Rendern mit den Mitteln der jadice document platform vermieden werden soll.
Verwendung eines PageDecorators im JadiceShaperNode
Beim Rendern eines Datenstroms mit dem JadiceShaperNode können Implementierung des Interface PageDecorator verwendet werden, wie sie in der jadice document platform eingesetzt werden. Ein solcher PageDecorator kann mittels Graphics2D-Operationen beliebige eigene Inhalte über oder unter dem eigentlichen Seiteninhalt aufbringen.
Zum schnellen Einstieg bietet jadice server eine einfache Musterimplementierung, mit der Texte auf der Dokumentseite platziert werden können. Die Klasse com.levigo.jadice.server.jadice4x.HeaderFooterPageDecorator finden Sie in der Datei base-nodes-server-4.x.x.x.jar. Zur Verwendung müssen Sie diese JAR-Datei und die Datei shaper-base-4.x.x.x.jar, die sich im Verzeichnis <jadice-server>/server-lib/ befinden, in den Klassenpfad Ihrer Anwendung aufnehmen.
Über einfache setter-Methoden können Sie clientseitig einen Text, die Schriftart sowie Position und Ausrichtung definieren:
// Konfiguration des JadiceShaperNodes
StreamInputNode inputNode = new StreamInputNode();
JadiceShaperNode shaperNode = new JadiceShaperNode();
shaperNode.setTargetMimeType("application/pdf");
// Konfiguration des beiliegenden PageDecorators
PageDecorator simpleDecorator = new HeaderFooterPageDecorator();
simpleDecorator.setTemplate("DUPLIKAT");
simpleDecorator.setFont(new Font("Arial", Font.BOLD, 30));
simpleDecorator.setTextOrientation(-45.0f);
simpleDecorator.setHorizontalAlignment(HorizontalAlignment.CENTER);
simpleDecorator.setVerticalAlignment(VerticalAlignment.CENTER);
shaperNode.getSettings(BaseShaperSettings.class).setPageDecorator(simpleDecorator);
// Einbinden in einen Workflow und Aufruf eines Jobs siehe: jadice server Entwicklerhandbuch
Haben Sie bereits eine eigene Implementierung eines PageDecorators vorliegen, z.B. weil dieser in einer Integration des jadice viewers verwendet wird, kann dieser ebenfalls für die Konvertierung in jadice server eingesetzt werden.
Voraussetzung hierfür ist, dass Ihr PageDecorator und all seine Parameter serialisierbar sind und dementsprechend das Marker-Interface java.io.Serializable implementieren. Diese Klasse muss sowohl im Klassenpfad Ihrer Client-Applikation wie auch im Klassenpfad von jadice server eingebunden werden. Der Aufruf erfolgt in gleicher Weise wie zum oben gezeigten Codebeispiel.
Überlagern mit Inhalten eines zweiten PDF-Dokumente
Im ersten Schritt dieses Szenario wird davon ausgegangen, dass das einzubrennende Wasserzeichen immer gleich bleibt Dieses liegt als (einseitiges) PDF-Dokument vor. Außerdem wird davon ausgegangen, dass das Dokument mit dem Inhalt ebenso bereits als PDF vorliegt.
Mit Hilfe der PDFCompositeNode können nun das PDF mit dem Inhalt und das PDF mit dem Wasserzeichen zusammengefügt werden:
// Konfiguration des Workflows StreamInputNode inputNode = new StreamInputNode(); PDFCompositeNode compositeNode = new PDFCompositeNode(); // Konfiguration des PDFCompositeNode compositeNode.setRepeat(true); // Wiederholen des Wasserzeichens compositeNode.setOrder(Order.BACK_TO_FRONT); // Wasserzeichen über Inhalt // Einbinden in einen Workflow und Aufruf eines Jobs siehe: jadice server Entwicklerhandbuch (...) // Senden der Datenströme an jadice server inputNode.addStream(myDocumentInputStream); inputNode.addStream(myWatermarkPDFInputStream); inputNode.complete();
Für den Anwendungsfall, dass das Dokument mit dem Inhalt noch durch jadice server zu konvertieren ist, muss der Workflow dahingehend angepasst werden, dass dieses Dokument und das Wasserzeichen über unterschiedliche Knoten zum PDFCompositeNode gelangen.
// Konfiguration des Workflows StreamInputNode documentInputNode = new StreamInputNode(); Node myConversionNode = ...// entspr. Node zur Dokumentkonvertierung StreamInputNode watermarkInputNode = new StreamInputNode(); DemultiplexerNode demux = new DemultiplexerNode(); PDFCompositeNode compositeNode = new PDFCompositeNode(); // Konfiguration des PDFCompositeNode compositeNode.setRepeat(true); // Wiederholen des Wasserzeichens compositeNode.setOrder(Order.BACK_TO_FRONT); // Wasserzeichen über Inhalt // Einbinden in einen Workflow und Aufruf eines Jobs siehe: jadice server Entwicklerhandbuch documentInputNode.appendSuccessor(myConversionNode).appendSuccessor(demux); watermarkInputNode.appendSuccessor(demux); demux.appendSuccessor(compositeNode); // Senden der Datenströme an jadice server documentInputNode.addStream(myDocumentInputStream); documentInputNode.complete(); watermarkInputNode.addStream(myWatermarkPDFInputStream); watermarkInputNode.complete();
Besteht darüber hinaus die Anforderung, dass auch das Wasserzeichen dynamisch generiert werden soll, kann dies z.B. mit XSL-FO erzeugt werden. Wie dies funktioniert, erklärt Ihnen der Knowledge Base-Artikel Von der Textdatei zum PDF.