Il servizio di output è un servizio OSGi che fa parte di AEM Document Services. Il servizio Output supporta vari formati di output e le funzionalità di progettazione dell'output di AEM Forms Designer. Il servizio di output può convertire i modelli XFA e i dati XML per generare documenti di stampa in vari formati.
Il servizio di output consente di creare applicazioni che consentono di:
Il servizio di output è un'applicazione a 32 bit. In Microsoft Windows, un'applicazione a 32 bit può utilizzare un massimo di 2 GB di memoria. Il limite si applica anche al servizio di output.
In genere, i modelli vengono creati utilizzando AEM Forms Designer. Le generatePDFOutput
e generatePrintedOutput
API del servizio Output consentono di convertire direttamente questi modelli in vari formati, inclusi PDF, PostScript, ZPL e PCL.
L'operazione generatePDFOutput
genera PDF, mentre l'operazione generatePrintedOutput
genera formati PostScript, ZPL e PCL. Il primo parametro di entrambe le operazioni accetta il nome del file modello (ad esempio ExpenseClaim.xdp
) o un oggetto Document che contiene il modello. Quando specificate il nome del file modello, specificate anche la directory principale del contenuto come percorso della cartella che contiene il modello. È possibile specificare la radice del contenuto utilizzando il parametro PDFOutputOptions
o PrintedOutputOptions
. Per informazioni dettagliate sulle altre opzioni che potete specificare utilizzando questi parametri, consultate Javadoc.
Il secondo parametro accetta un documento XML unito al modello durante la generazione del documento di output.
L'operazione generatePDFOutput
può inoltre accettare come input un modulo PDF basato su XFA e restituire una versione non interattiva del modulo PDF come output.
Considerare uno scenario in cui sono disponibili uno o più modelli e più record di dati XML per ciascun modello.
Utilizzare le operazioni generatePDFOutputBatch
e generatePrintedOutputBatch
del servizio Output per generare un documento di stampa per ciascun record.
È inoltre possibile combinare i record in un singolo documento. Entrambe le operazioni richiedono quattro parametri.
Il primo parametro è una mappa che contiene una stringa arbitraria come chiave e il nome del file modello come valore.
Il secondo parametro è una mappa diversa il cui valore è un oggetto Document che contiene dati XML. La chiave è la stessa specificata per il primo parametro.
Il terzo parametro per generatePDFOutputBatch
o generatePrintedOutputBatch
è di tipo PDFOutputOptions
o PrintedOutputOptions
rispettivamente.
I tipi di parametri sono gli stessi tipi dei parametri per le operazioni generatePDFOutput
e generatePrintedOutput
e hanno lo stesso effetto.
Il quarto parametro è di tipo BatchOptions
, che consente di specificare se è possibile generare un file separato per ciascun record. Il valore predefinito di questo parametro è false.
Sia generatePrintedOutputBatch
che generatePDFOutputBatch
restituiscono un valore di tipo BatchResult
. Il valore contiene un elenco di documenti generati. Contiene inoltre un documento di metadati in formato XML che contiene informazioni relative a ciascun documento generato.