使用同步处理

Formsas a Cloud Service — 通信API允许您创建、汇编和提供面向品牌的个性化通信，例如业务往来函、文档、报表、索赔处理信函、福利通知、索赔处理信函、每月账单和欢迎套件。 您可以使用Communications API将模板(XFA或PDF)与客户数据相结合，生成PDF、PS、PCL、DPL、IPL和ZPL格式的文档。

假设您有一个或多个模板，并且每个模板有多个XML数据记录。 您可以使用Communications API为每个记录生成打印文档。 结果生成非交互式PDF文档。 非交互式PDF文档不允许用户在其字段中输入数据。

Formsas a Cloud Service — 通信提供了用于计划文档生成的按需和批处理API（异步API）：

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

• 批处理API（异步API）适用于计划的高吞吐量多文档生成用例。 这些 API 会批量生成文档。例如，每月生成的电话帐单、信用卡对帐单和收益对帐单。

使用同步操作

同步操作是以线性方式生成文档的过程。 这些API分为单租户API和多租户API：

单租户API

• 文档生成API
• 文档操作API

验证单租户API

单租户API操作支持两种类型的身份验证：

• 基本身份验证：基本身份验证是HTTP协议中内置的简单身份验证方案。 客户端使用Authorization标头发送HTTP请求，该标头包含单词Basic，后跟空格和base64编码的字符串username：password。 例如，要授权为管理员/管理员，客户端发送Basic [base64编码字符串用户名]： [base64编码的字符串密码].

• 基于令牌的身份验证： 基于令牌的身份验证使用访问令牌（持有者身份验证令牌）向Experience Manager发出as a Cloud Service请求。 AEM Formsas a Cloud Service提供API以安全检索访问令牌。 要检索并使用令牌对请求进行身份验证，请执行以下操作：

  1. 从开发人员控制台检索Experience Manageras a Cloud Service凭据.
  2. 在环境中安装Experience Manageras a Cloud Service凭据. (应用程序服务器、Web服务器或其他非AEM服务器)配置为向（调用）云服务发送请求。
  3. 生成JWT令牌并与Adobe IMS API交换访问令牌.
  4. 将访问令牌作为持有者身份验证令牌运行Experience ManagerAPI。
  5. 在Experience Manager环境中为技术帐户用户设置适当的权限.
  注意

  Adobe建议在生产环境中使用基于令牌的身份验证。

（仅适用于文档生成API）配置资源和权限

要使用同步API，需要满足以下条件：

• 具有Experience Manager管理员权限的用户
• 将模板和其他资源上传到Experience Manager FormsCloud Service实例

（仅适用于Document Generation API）将模板和其他资源上传到Experience Manager实例

组织通常有多个模板。 例如，信用卡对帐单、福利对帐单和报销申请都使用一个模板。 将所有此类XDP和PDF模板上传到您的Experience Manager实例。 要上传模板，请执行以下操作：

1. 打开您的Experience Manager实例。
2. 转到Forms > Forms和文档
3. 单击“创建”>“文件夹”，然后创建一个文件夹。 打开文件夹。
4. 单击“创建”>“文件上载”并上载模板。

调用API

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

Business.Adobe.com 资源