输出服务 output-service
概述 overview
输出服务是AEM Document Services中的一项OSGi服务。 输出服务支持AEM Forms Designer的各种输出格式和输出设计功能。 输出服务可以转换XFA模板和XML数据,以生成各种格式的打印文档。
Output 服务使您能够创建应用程序,这些应用程序允许您:
- 使用 XML 数据填充模板文件来生成最终表单文档。
- 以各种格式生成输出表单,包括非交互式PDF、 PostScript、PCL和ZPL打印流。
- 从 XFA 表单 PDF 生成打印 PDF。
- 通过将多组数据与提供的模板合并,批量生成PDF、 PostScript、PCL和ZPL文档。
创建非交互式表单文档 creating-non-interactive-form-documents
通常,您使用AEM Forms Designer创建模板。 的 generatePDFOutput
和 generatePrintedOutput
通过输出服务的API,您可以直接将这些模板转换为各种格式,包括PDF、PostScript、ZPL和PCL。
的 generatePDFOutput
操作会生成PDF,而 generatePrintedOutput
操作会生成PostScript、ZPL和PCL格式。 这两个操作的第一个参数接受模板文件的名称(例如 ExpenseClaim.xdp
)或包含模板的文档对象。 指定模板文件的名称时,还应将内容根指定为包含模板的文件夹的路径。 您可以使用 PDFOutputOptions
或 PrintedOutputOptions
参数。 有关使用这些参数可指定的其他选项的详细信息,请参阅Javadoc。
第二个参数接受在生成输出文档时与模板合并的XML文档。
的 generatePDFOutput
操作还可以接受基于XFA的PDF表单作为输入,并返回PDF表单的非交互式版本作为输出。
生成非交互式表单文档 generating-non-interactive-form-documents
假设您有一个或多个模板以及每个模板的多个XML数据记录。
使用 generatePDFOutputBatch
和 generatePrintedOutputBatch
输出服务的操作,以生成每个记录的打印文档。
您还可以将记录合并到单个文档中。 这两个操作都需要四个参数。
第一个参数是映射,其中包含任意字符串作为键,模板文件的名称作为值。
第二个参数是不同的映射,其值是包含XML数据的Document对象。 键与为第一个参数指定的键相同。
的第三个参数 generatePDFOutputBatch
或 generatePrintedOutputBatch
是类型 PDFOutputOptions
或 PrintedOutputOptions
分别进行。
参数类型与 generatePDFOutput
和 generatePrintedOutput
具有相同的效果。
第四个参数的类型 BatchOptions
,用于指定是否可以为每个记录生成单独的文件。 此参数的默认值为false。
两者兼有 generatePrintedOutputBatch
和 generatePDFOutputBatch
返回类型的值 BatchResult
. 值包含生成的文档列表。 它还包含XML格式的元数据文档,其中包含与所生成的每个文档相关的信息。