Serviço de Saída

Visão geral

O serviço de saída é um serviço OSGi que faz parte AEM Documento Services. O serviço de saída suporta vários formatos de saída e recursos de design de saída do AEM Forms Designer. O serviço de saída pode converter modelos XFA e dados XML para gerar documentos de impressão em vários formatos.

O serviço de saída permite criar aplicativos que permitem:

• Gere documentos de formulário finais preenchendo arquivos de modelo com dados XML.
• Gere formulários de saída em vários formatos, incluindo fluxos de impressão PDF, PostScript, PCL e ZPL não interativos.
• Gere PDFs de impressão a partir de PDFs de formulário XFA.
• Gere documentos PDF, PostScript, PCL e ZPL em massa ao mesclar vários conjuntos de dados com modelos fornecidos.

Criação de documentos de formulário não interativos

Normalmente, você cria modelos usando o AEM Forms Designer. As generatePDFOutput e generatePrintedOutput APIs do serviço de Saída permitem converter esses modelos diretamente em vários formatos, incluindo PDF, PostScript, ZPL e PCL.

A operação generatePDFOutput gera PDFs, enquanto a operação generatePrintedOutput gera formatos PostScript, ZPL e PCL. O primeiro parâmetro de ambas as operações aceita o nome do arquivo de modelo (por exemplo, ExpenseClaim.xdp) ou um objeto de Documento que contém o modelo. Ao especificar o nome do arquivo de modelo, especifique também a raiz do conteúdo como o caminho para a pasta que contém o modelo. Você pode especificar a raiz do conteúdo usando o parâmetro PDFOutputOptions ou PrintedOutputOptions. Consulte Javadoc para obter detalhes sobre outras opções que você pode especificar usando esses parâmetros.

O segundo parâmetro aceita um documento XML que é unido ao modelo ao gerar o documento de saída.

A operação generatePDFOutput também pode aceitar um formulário PDF baseado em XFA como entrada e retornar uma versão não interativa do formulário PDF como saída.

Geração de documentos de formulário não interativos

Considere um cenário em que você tenha um ou mais modelos e vários registros de dados XML para cada modelo.

Use as operações generatePDFOutputBatch e generatePrintedOutputBatch do serviço de Saída para gerar um documento de impressão para cada registro.

Você também pode combinar os registros em um único documento. Ambas as operações utilizam quatro parâmetros.

O primeiro parâmetro é um Mapa que contém uma string arbitrária como a chave e o nome do arquivo de modelo como valor.

O segundo parâmetro é um Mapa diferente cujo valor é um objeto de Documento que contém dados XML. A chave é a mesma especificada para o primeiro parâmetro.

O terceiro parâmetro para generatePDFOutputBatch ou generatePrintedOutputBatch é do tipo PDFOutputOptions ou PrintedOutputOptions, respectivamente.

Os tipos de parâmetro são os mesmos que os tipos de parâmetros para as operações generatePDFOutput e generatePrintedOutput e têm o mesmo efeito.

O quarto parâmetro é do tipo BatchOptions, que você usa para especificar se um arquivo separado pode ser gerado para cada registro. O valor padrão desse parâmetro é falso.

Ambos generatePrintedOutputBatch e generatePDFOutputBatch retornam um valor do tipo BatchResult. O valor contém uma lista de documentos gerados. Ele também contém um documento de metadados no formato XML que contém informações relacionadas a cada documento gerado.