从AEM工作流启动文档服务API

汇编程序

AEM Forms提供自定义工作流来调用以下Assembler服务API:

• invoke:调用输入DDX中指定的对提供的输入的操作。
• toPDFA:将输入PDF文档转换为PDF/A文档。

调用DDX工作流

调用DDX​工作流调用Invoke汇编服务API，您可以使用它来汇编或反汇编文档、向PDF添加水印等。

1. 将​调用DDX​工作流步骤拖到Sidekick中的“Forms Workflow”选项卡下。
2. 多次-单击添加的工作流步骤以编辑组件。
3. 在编辑组件对话框中，配置输入文档、环境选项和输出文档，然后单击​确定。

输入文档

调用DDX工作流需要以下输入文档:

• DDX:它是调用DDX工作流步骤的必需输入，可以通过从DDX输入下拉列表中选择以下选项之一来指定它。

  • 相对于有效负荷:DDX输入文件相对于工作流项的有效负荷文件夹。
  • 使用有效负荷:工作流项的有效负荷用作输入DDX文档。
  • 绝对路径:CRX存储库中DDX文档的绝对路径。

• 从PayLoad创建映射:选择此选项后，有效负荷文件夹下的所有文档将添加到Assembler中API的输入 invoke 文档的映射中。每个文档的节点名称用作映射中的键。

• 输入文档的映射:指定输入文档的映射。您可以添加任意数量的条目，其中每个条目在映射中指定文档的键和文档的源。

环境选项

环境选项选项卡允许您为调用API设置各种处理选项。

• 作业日志级别:指定处理日志的日志级别。

• 仅验证:检查输入DDX的有效性。

• 错误时失败:指定在出错时对Assembler服务的调用是否应失败。默认值为False。

输出文档

根据输入DDX，调用API可以生成多个输出文档。 输出文档选项卡允许您选择保存输出文档的位置。

1. 在有效负荷中保存输出:将输出文档保存在有效负荷文件夹下，或覆盖有效负荷（如果有效负荷是文件）。

2. 输出文档地图:允许通过为每个输出文档添加一个条目来显式指定保存每个输出文档的位置。每个条目指定文档以及保存它的位置。 输出文档可覆盖有效负荷或保存在有效负荷文件夹下。 当存在多个输出文档时，此功能很有用。

3. 作业日志:指定保存作业日志文档的位置，这有助于排除故障。

转换为PDF/A工作流

“转换为PDF/A”工作流步骤将调用toPDFA Assembler服务API。 它用于将PDF文档转换为符合PDF/A规范的文档。

1. 将​ConvertToPDFA​工作流步骤拖到Sidekick中的“Forms Workflow”选项卡下。

2. 多次-单击添加的工作流步骤以编辑组件。

3. 在编辑组件对话框中，配置输入文档、转换选项和输出文档，然后单击​确定。

输入文档

通过以下方式之一指定要转换为符合PDF/A规范的文档的源文档。

• 相对于有效负荷:输入文档是相对于工作流项的有效负荷文件夹的。
• 使用有效负荷:工作流项的有效负荷用作输入文档。
• 绝对路径:CRX存储库中输入文档的绝对路径。

转换选项

“转换选项”允许您指定用于改变PDF/A转换过程的选项。

• 合规 :指定输出PDF/A必须符合的PDF/A标准。

• 结果级别:指定用于PDF/A转换日志的日志级别。

• 签名 :指定在转换过程中必须如何处理输入文档中的签名。

• 色彩空间 :指定用于输出PDF/A文档的预定义色彩空间。

• 验 证转换：指定转换后是否应验证转换的PDF/A文档是否符合PDF/A规范。

• 作业日志级别 :指定用于处理日志的日志级别。

• 元数据扩展模式 :指定用于PDF扩展模式元数据中XMP属性的元数据文档的元数据路径。

输出文档

“输出文档”选项卡允许您指定输出文档的目标

• PDFA文档:指定保存转换的PDF/A文档的位置。它可以覆盖有效负荷文档或保存在有效负荷文件夹下。
• 转换日志:指定保存转换日志的位置。它可以覆盖有效负荷文档，也可以保存在有效负荷文件夹下。

表单

渲染PDF表单工作流是围绕renderPDFFormForms服务API的包装器，用于使用XDP模板和数据xml创建PDF表单。

渲染PDF表单工作流

1. 将“渲染PDF表单”工作流步骤拖到Sidekick中的“Forms Workflow”选项卡下。
2. 多次-单击添加的工作流步骤以编辑组件。
3. 在编辑组件对话框中，配置输入文档、输出文档和其他参数，然后单击​确定。

输入文档

• 模板文件:指定XDP模板的位置。这是必填字段。

• 数据文档:指定需要与模板合并的数据xml的位置。

输出文档

• 输出文档:-指定生成的PDF表单的名称。

其他参数

• 内容根:指定存储库中存储输入XDP模板中使用的片段或图像的文件夹路径。
• 提交Url:为生成的PDF表单指定默认提交URL。
• 区域设置:指定生成的PDF表单的默认区域设置。
• Acrobat版:为生成的PDF表单指定目标Acrobat版本。
• 加标签的PDF:指定是否使生成的PDF可访问。
• XCI文档:指定XCI文件的路径。

输出

“生成非交互式PDF工作流”是generatePDFOutput输出服务API的包装器。 它用于从XDP模板和数据xml生成非交互式PDF文档。

生成非交互式PDF输出工作流程  

1. 将“生成非交互式PDF输出”工作流程拖到Sidekick的“Forms Workflow”选项卡下。
2. 多次-单击添加的工作流步骤以编辑组件。
3. 在编辑组件对话框中，配置输入文档、输出文档和其他参数，然后单击​确定。

输入文档

• 模板文件:指定XDP模板的位置。这是必填字段。

• 数据文档:指定需要与模板合并的数据xml的位置。

输出文档

输出文档:指定生成的PDF表单的名称。

其他参数

• 内容根:指定存储库中存储输入XDP模板中使用的片段或图像的文件夹路径。
• 区域设置:指定生成的PDF表单的默认区域设置。
• Acrobat版:为生成的PDF表单指定目标Acrobat版本。
• 线性化的PDF:指定是否为Web查看优化生成的PDF。
• 加标签的PDF:指定是否使生成的PDF可访问。
• XCI文档:指定XCI文件的路径。