AEM Formsas a Cloud Service通信API frequently-asked-questions

主页图像

版本
文章链接
AEM 6.5
单击此处
AEM as a Cloud Service
本文

通信功能可帮助您创建品牌批准的、个性化的和标准化的文档,例如商业信函、对帐单、理赔处理函、收益通知函、月度帐单或欢迎套件。

该功能提供 API 来生成和操作文档。您可以按需生成或操作文档,也可以创建批处理作业来按定义的时间间隔生成多个文档。通信 API 提供:

  • 按需简化和批量文档生成功能。

  • 按需组合、重新排列和验证 PDF 文档的能力。

  • 用于更轻松地与外部系统集成的 HTTP API。包括用于按需(低延迟)和批处理操作(高吞吐量操作)的单独 API。

  • 对数据的安全访问。通信 API 仅连接到客户指定的数据存储库并从中访问数据,从而使通信变得高度安全。

文档生成

通信文档生成 API 有助于将模板(XFA 或 PDF)与客户数据(XML)相结合,生成 PDF 和打印格式(如 PS、PCL、DPL、IPL 和 ZPL 格式)的文档。这些 API 将 PDF 和 XFA 模板与 XML 数据结合使用,按需生成单个文档或使用批处理作业生成多个文档。

通常,您使用 Designer 创建模板,并使用通信 API 将数据与模板合并。您的应用程序可以将输出文档发送到网络打印机、本地打印机或存储系统以进行存档。典型的现成和自定义工作流如下所示:

通信文档生成工作流

根据用例,您还可以将这些文档设为通过您的网站或存储服务器下载。

文档生成 API 的一些示例包括:

创建 PDF 文档 create-pdf-documents

您可以使用文档生成 API 创建基于表单设计和 XML 表单数据的 PDF 文档。输出是非交互式 PDF 文档。也就是说,用户无法输入或修改表单数据。基本工作流是将 XML 表单数据与表单设计合并来创建 PDF 文档。下图说明如何合并表单设计和 XML 表单数据以生成 PDF 文档。

创建 PDF 文档
图:典型的 PDF 文档创建工作流

创建 PostScript (PS)、打印机指令语言 (PCL)、Zebra 打印语言 (ZPL) 文档 create-PS-PCL-ZPL-documents

您可以使用文档生成API创建基于XDP表单设计或PDF文档的PostScript (PS)、打印机命令语言(PCL)和斑马打印语言(ZPL)文档。 这些 API 有助于将表单设计与表单数据合并以生成文档。您可以将文档保存到文件,并开发一个自定义流程来将它发送到打印机。

处理批量数据可创建多个文档 processing-batch-data-to-create-multiple-documents

您可以使用文档生成 API 为 XML 批处理数据源中的每条记录创建单独的文档。您可以批量和在异步架构下生成文档。您可以配置各种用于转换的参数,然后开始批处理。

创建 PDF 文档

文档操作

通信文档操作(文档转换)API有助于组合、重新排列PDF文档。 通常,您创建一个 DDX 并将它提交给文档操作 API 来汇编或重新排列文档。DDX 文档提供了有关如何使用源文档生成一组所需文档的说明。DDX 引用文档提供了有关所有受支持操作的详细信息。文档操作的一些示例包括:

汇编 PDF 文档

您可以使用文档操作 API 将两个或更多 PDF 或 XDP 文档汇编成一个 PDF 文档或 PDF 文档组合。以下是组合PDF文档的一些方法:

  • 汇编一个简单的 PDF 文档
  • 创建 PDF 文档组合
  • 汇编加密的文档
  • 使用 Bates 编号汇编文档
  • 合并和汇编文档

将多个 PDF 文档汇编成一个简单 PDF 文档
图:将多个 PDF 文档汇编成一个简单 PDF 文档

拆分 PDF 文档

您可以使用文档操作 API 来拆分 PDF 文档。API 可以从源文档中提取页面或根据书签拆分源文档。通常,如果 PDF 文档最初是从多个单独文档(例如对帐单集合)创建的,则此任务很有用。

  • 从源文档中提取页面
  • 根据书签拆分源文档

根据书签将一个源文档拆分成多个文档
图:根据书签将一个源文档拆分成多个文档

NOTE
AEM Forms提供了多种内置字体,可与PDF文件无缝集成。 要查看支持的字体列表,单击此处

文档提取

文档提取功能属于早期采用者计划。 您可以使用官方电子邮件 ID 写信给 aem-forms-ea@adobe.com,加入早期采用者计划并申请使用该功能。

文档提取服务允许您获取PDF文档的属性,如使用权限、PDF属性和元数据。 文档提取功能包括:

  • 获取PDF文档的属性,例如,如果PDF具有附件、注释、其Acrobat版本等。
  • 提取在PDF文档中启用的使用权限,用户将启用或禁用的使用权限检索到PDF文档,以实现Adobe Acrobat Reader的可扩展性。
  • 获取PDF文档中存在的元数据信息,元数据是有关文档的信息(与文档内容不同,例如文本和图形)。 Adobe可扩展元数据平台(XMP)是处理文档元数据的标准。 XMP Utilities服务可以从PDF文档中检索XMP元数据,并将XMP元数据导出到PDF文档中。

API参考文档提供了有关API提供的所有参数、身份验证方法和服务的详细信息。 API参考文档也以.yaml格式提供。 您可以下载.yaml并将其上传到Postman以检查API的功能。

文档转换

转换为符合 PDF/A 标准的文档并进行验证

通信文档转换API有助于将PDF文档转换为PDF/A。您可以使用这些API将PDF文档转换为符合PDF/A标准的文档,还可以确定PDF文档是否符合PDF/A标准。 PDF/A是一种用于长期保存文档内容的存档格式。 字体将嵌入到文档中,并且文件是未压缩的。因此,PDF/A 文档通常比标准 PDF 文档大。此外,PDF/文档不包含音频和视频内容。 支持的PDF/A合规性标准包括PDF/A-1a、1b、2a、2b、3a和3b。

将PDF转换为XDP convert-pdf-to-xdp

ConvertPDF到XDP的功能在早期采用者计划下。 您可以使用官方电子邮件 ID 写信给 aem-forms-ea@adobe.com,加入早期采用者计划并申请使用该功能。

将PDF文档转换为XDP文件。 若要将PDF文档成功转换为XDP文件,PDF文档必须在词典中包含XFA流。

记录Assurance doc-assurance

DocAssurance服务包括签名和加密API:

签名API

利用 Signature API,您的组织可以保护其分发和接收的 Adobe PDF 文档的安全和隐私。安全功能应用于文档本身,在文档的整个生命周期内保持安全和受控制。 在防火墙之外,当文档离线下载以及提交回组织时,文档将保持安全。 您可以使用签名API完成以下任务:

  • 向PDF文档添加可见签名字段。
  • 向PDF文档添加不可见的签名字段。
  • 在PDF文档中签署指定的签名字段。
  • 认证PDF文档
  • 从PDF文档中的指定签名字段中移除签名
  • 从PDF文档中删除指定的签名字段

从早期采用程序下可用的PDF文档中移除指定签名字段的签名并删除指定签名字段。 您可以使用官方电子邮件 ID 写信给 aem-forms-ea@adobe.com,加入早期采用者计划并申请使用该功能。

加密API

加密API允许您加密和解密文档。 文档加密后,其内容将变得不可读。 授权用户可以解密文档以获得对内容的访问权限。 如果使用密码对PDF文档进行加密,则必须先指定打开密码,然后才能在Adobe Reader或Adobe Acrobat中查看文档。

您可以使用加密API完成以下任务:

  • 使用密码加密PDF文档。
  • 从PDF文档中删除基于密码的加密。
  • 检索应用于PDF文档的安全类型。
  • 返回应用于PDF文档的安全类型。

签名API和加密API都是同步API

文档实用工具 doc-utility

带同步API的文档实用程序可帮助您在PDF和XDP文件格式之间转换文档。 将使用权限应用到文档,并从文档中提取启用的使用权限。 查询有关PDF单据的信息。 使用权限API的详细信息如下:

使用权限API(Reader扩展)

使用权限(Reader扩展)功能属于早期采用者计划。 您可以使用官方电子邮件 ID 写信给 aem-forms-ea@adobe.com,加入早期采用者计划并申请使用该功能。

使用权限功能通过扩展具有其他使用权限的Adobe Reader的功能,使您的组织可以轻松共享交互式PDF文档。 该服务可与Adobe Reader 7.0或更高版本配合使用,并向PDF文档添加了使用权限。 此操作激活在使用Adobe Reader打开PDF文档时通常不可用的功能,例如向文档添加注释、填写表单和保存文档。

当PDF文档添加了相应的使用权限后,收件人可以在Adobe Reader中执行以下操作:

  • 在线或离线完成PDF文档和表单,使收件人能够在本地保存副本以保存其记录,同时仍保持添加的信息完好无损。
  • 将PDF文档保存到本地硬盘,以保留原始文档以及任何其他注释、数据或附件。
  • 将文件和媒体剪辑附加到PDF文档。
  • 通过使用行业标准公钥基础设施(PKI)技术应用数字签名对PDF文档进行签名、认证和身份验证。
  • 以电子方式提交已完成或添加注释的PDF文档。
  • 使用PDF文档和表单作为内部数据库和Web服务的直观开发前端。
  • 与其他人共享PDF文档,以便审阅人可以使用直观的标记工具添加注释。 这些工具包括电子便笺、印章、高亮和文本删除线。 Acrobat中提供了相同的函数。
  • 支持条码Forms解码。

在Adobe Reader中打开启用了权限的PDF文档时,会自动激活这些特殊使用权限功能。 当用户使用完启用了权限的文档时,这些功能在Adobe Reader中再次被禁用。 它们保持禁用状态,直到用户收到另一个启用了权限的PDF文档。

启用或禁用使用权限

用于扩展PDFReader服务的各种使用权限功能包括:

  • 条形码解码:解码PDF文档中的条形码。

  • 备注:脱机评论PDF文档。

  • 联机评论:联机评论PDF文档。

  • 数字签名:向PDF文档添加数字签名。

  • 动态表单字段:向PDF文档添加表单字段。

  • 动态表单页:将表单页添加到PDF文档。

  • 嵌入的文件:在PDF文档中嵌入文件。

  • 表单数据导入:将表单数据导入到PDF文档。

  • 表单数据导出:将表单数据导入到PDF文档。

  • 表单填写:在PDF文档中填写表单字段。

  • 联机Forms:从PDF文档访问Web服务或数据库。

  • 独立提交:从PDF文档离线提交表单数据。

其他功能

  • 消息:在打开应用了一个或多个使用权限的PDF文档时,Adobe Acrobat Reader中显示的消息。
  • 解锁密码:打开加密的PDF文档所需的密码。 通常,这是文档打开密码,但如果PDF文档受权限密码的额外保护,则可以使用任一密码来打开文档。

API参考文档提供了有关API提供的所有参数、身份验证方法和各种服务的详细信息。 API参考文档也以.yaml格式提供。 您可以下载.yaml并将其上传到Postman以检查API的功能。

通信 API 的类型 types

通信功能提供用于按需和批量文档生成的 HTTP API:

  • 同步 API ​适用于按需、低延迟、单一记录文档生成场景。这些 API 更适用于基于用户操作的用例。例如,在用户填写完表单后生成文档。

  • 批处理 API(异步 API) ​适用于计划的、高吞吐量和多文档生成场景。这些 API 会批量生成文档。例如,每月生成电话帐单、信用卡对帐单和福利对帐单。

入门培训

通信功能作为面向 Forms as a Cloud Service 用户的独立和附加模块提供。您可以联系Adobe销售团队或您的Adobe代表以请求获取访问权限。 Adobe 可为您的组织开启访问渠道,并为您指定为组织中管理员的人员提供所需的权限。管理员可以向贵组织的Formsas a Cloud Service开发人员(用户)授予权限以使用这些API。

新用户引导后,要为Formsas a Cloud Service环境启用通信功能,请执行以下操作:

  1. 登录 Cloud Manager,并打开您的 AEM Forms as a Cloud Service 实例。

  2. 打开“编辑程序”选项,转到“解决方案和加载项”选项卡,然后选择​ Forms - 通信 ​选项。

    通信

    如果您已启用 Forms - 数字登记 ​选项,则选择 Forms - 通信加载项 ​选项。

    加载项

  3. 单击​ 更新

  4. 运行构建管道。成功运行构建管道后,将为您的环境启用通信 API。

NOTE
要启用和配置文档操作API,请将以下规则添加到Dispatcher配置
# Allow Forms Doc Generation requests
/0062 { /type "allow" /method "POST" /url "/adobe/forms/assembler/*" }

另请参阅 see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab