Servizio di output

Panoramica

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:

• Generare documenti modulo finali compilando i file modello con dati XML.
• Generazione di moduli di output in vari formati, inclusi flussi di stampa PDF non interattivi, PostScript, PCL e ZPL.
• Generazione di PDF per la stampa dai PDF dei moduli XFA.
• Generate documenti PDF, PostScript, PCL e ZPL in blocco unendo più set di dati ai modelli forniti.

Creazione di documenti modulo non interattivi

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.

Generazione di documenti modulo non interattivi

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.