Der OSGi-Dienst Output ist eine Komponente der AEM Document Services. Der Ausgabedienst unterstützt verschiedene Ausgabeformate und Ausgabedesignfunktionen von AEM Forms Designer. Mit dem Output-Dienst können Sie XFA-Vorlagen und XML-Daten in verschiedene Druckformate konvertieren.
Dabei können Sie mit dem Output-Service Programme mit folgenden Funktionen erstellen:
Ausgabedienst ist eine 32-Bit-Anwendung. Unter Microsoft Windows darf eine 32-Bit-Anwendung maximal 2 GB Arbeitsspeicher verwenden. Das Limit gilt auch für den Ausgabedienst.
Normalerweise erstellen Sie Vorlagen mit AEM Forms Designer. Mit den APIs generatePDFOutput
und generatePrintedOutput
des Output-Dienstes können Sie diese Vorlagen direkt in verschiedene Formate wie PDF, PostScript, ZPL und PCL konvertieren.
Mit generatePDFOutput
generieren Sie PDF-Dokumente, während generatePrintedOutput
Dokumente in den Formaten PostScript, ZPL und PCL generiert. Der erste Parameter beider Vorgänge akzeptiert entweder den Namen der Vorlagendatei (z. B. ExpenseClaim.xdp
) oder ein Dokumentobjekt, das die Vorlage enthält. Wenn Sie den Namen der Vorlagendatei angeben, vergessen Sie nicht, auch den Inhaltsstamm als Pfad zum Vorlagenordner anzugeben. Sie können den Inhaltsstamm entweder mit dem Parameter PDFOutputOptions
oder dem Parameter PrintedOutputOptions
angeben. In der Javadoc finden Sie Informationen zu weiteren Optionen, die Sie mit diesen Parametern angeben können.
Der zweite Parameter akzeptiert ein XML-Dokument, das bei der Generierung des Ausgabedokuments mit der Vorlage zusammengeführt wird.
Der Vorgang generatePDFOutput
kann als Eingabe auch ein XFA-basiertes PDF-Formular akzeptieren und als Ausgabe eine nicht interaktive Version des PDF-Formulars zurückgeben.
Angenommen, Sie haben eine oder mehrere Vorlagen und für jede Vorlage mehrere Datensätze mit XML-Daten.
In diesem Fall können Sie mit den Vorgängen generatePDFOutputBatch
und generatePrintedOutputBatch
des Output-Dienstes für jeden Datensatz ein Druckdokument erstellen.
Sie können die Datensätze auch zu einem Dokument zusammenfassen. Beide Vorgänge akzeptieren vier Parameter.
Der erste Parameter ist eine Zuordnung mit einer Zufallszeichenfolge als Schlüssel und dem Namen der Vorlagendatei als Wert.
Der zweite Parameter ist ebenfalls eine Zuordnung, deren Wert ein Dokumentobjekt für die XML-Daten ist. Der Schlüssel ist derselbe wie beim ersten Parameter.
Der dritte Parameter für generatePDFOutputBatch
oder generatePrintedOutputBatch
ist vom Typ PDFOutputOptions
bzw. PrintedOutputOptions
.
Die Parametertypen sind die gleichen wie die Typen der Parameter für die Vorgänge generatePDFOutput
und generatePrintedOutput
und haben die gleiche Auswirkung.
Der vierte Parameter ist vom Typ BatchOptions
, mit dem Sie angeben, ob für jeden Datensatz eine eigene Datei erzeugt werden kann. Der Standardwert dieses Parameters ist „false“.
Sowohl generatePrintedOutputBatch
als auch generatePDFOutputBatch
geben einen Wert vom Typ BatchResult
zurück. Der Wert enthält eine Liste der generierten Dokumente. Außerdem enthält er ein Metadatendokument im XML-Format mit Informationen zu jedem generierten Dokument.