Servizio di output output-service
Panoramica overview
Il servizio di output è un servizio OSGi che fa parte di AEM Document Services. Il servizio di output supporta vari formati di output e funzioni di progettazione dell’output di AEM Forms Designer. Il servizio di output può convertire modelli XFA e dati XML per generare documenti di stampa in vari formati.
Il servizio di output consente di creare applicazioni che permettono di:
- Generare i documenti compilando i file modello con dati XML.
- Genera moduli di output in vari formati, inclusi flussi di stampa non interattivi PDF, PostScript, PCL e ZPL.
- Generare PDF di stampa da PDF modulo XFA.
- Generare in blocco documenti PDF, PostScript, PCL e ZPL unendo più set di dati con i modelli forniti.
Creazione di documenti modulo non interattivi creating-non-interactive-form-documents
In genere, si creano modelli utilizzando AEM Forms Designer. Le API generatePDFOutput e generatePrintedOutput del servizio di output consentono di convertire direttamente questi modelli in vari formati, tra cui 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 contenente il modello. Quando si specifica il nome del file modello, specificare anche la directory principale del contenuto come percorso della cartella che contiene il modello. È possibile specificare la directory principale del contenuto utilizzando il parametro PDFOutputOptions o PrintedOutputOptions. Consulta JavaScript per informazioni dettagliate su altre opzioni che puoi specificare utilizzando questi parametri.
Il secondo parametro accetta un documento XML che viene unito al modello durante la generazione del documento di output.
L'operazione generatePDFOutput può anche accettare un modulo PDF basato su XFA come input e restituire una versione non interattiva del modulo PDF come output.
Generazione di documenti modulo non interattivi generating-non-interactive-form-documents
Si consideri uno scenario in cui sono presenti uno o più modelli e più record di dati XML per ciascun modello.
Utilizzare le operazioni generatePDFOutputBatch e generatePrintedOutputBatch del servizio di output per generare un documento di stampa per ogni record.
È inoltre possibile combinare i record in un unico 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 è un mapping diverso il cui valore è un oggetto Document contenente dati XML. La chiave è la stessa di quella specificata per il primo parametro.
Il terzo parametro per generatePDFOutputBatch o generatePrintedOutputBatch è rispettivamente di tipo PDFOutputOptions o PrintedOutputOptions.
I tipi di parametri sono gli stessi dei tipi dei parametri per le operazioni generatePDFOutput e generatePrintedOutput e hanno lo stesso effetto.
Il quarto parametro è di tipo BatchOptions, utilizzato per specificare se è possibile generare un file separato per ogni 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.