将AEM Formsas a Cloud Service与Adobe Acrobat Sign连接 integrate-adobe-sign-with-aem-forms

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

Adobe Acrobat Sign为自适应Forms和AEM工作流启用电子签名工作流。 电子签名改进了法律、销售、工资单、人力资源管理和其他许多方面的文档的处理工作流。

在典型的 Adobe Acrobat Sign 和自适应表单方案中,用户需填写自适应表单来申请服务。例如,信用卡申请表和公民权益表。在用户填写、签署和提交申请表后,该表将发送给服务提供商以执行后续操作。服务提供商将审核申请,并使用 Adobe Acrobat Sign 将申请标记为已批准。AEM Forms支持Adobe Acrobat Sign和Adobe Acrobat Sign Solutions政府版。 根据您的许可证和要求,您可以将AEM Forms与以下任一解决方案集成或连接:

将AEM Forms与Adobe Acrobat Sign连接 adobe-sign

要将​ AEM Forms ​与​ Adobe Acrobat Sign ​连接,请设置先决条件部分中列出的软件和帐户,并在Formsas a Cloud Service创作实例和Publish实例中配置Adobe Sign Cloud Service:

将AEM Forms连接到Adobe Acrobat Sign的先决条件 prerequisites-for-adobe-sign

您需要以下安装程序才能将Adobe Acrobat Sign与AEM Forms集成:

  1. 有效的Adobe Acrobat Sign开发人员帐户
  2. Adobe Acrobat Sign API应用程序
  3. Adobe Acrobat Sign API 应用程序的凭据(客户端 ID 和客户端密码)。
  4. (仅适用于基于Government ID的身份验证)为政府ID身份验证启用身份验证方法

将AEM Forms创作和发布实例连接到Adobe Acrobat Sign configure-adobe-sign-with-aem-forms

满足前提条件后,执行以下步骤以在创作实例上使用 AEM Forms 配置 Adobe Acrobat Sign。

  1. 在AEM Forms创作实例上,导航到​ 工具 锤子 > 常规 > 配置浏览器

  2. 在​ 配置浏览器 ​页面上,选择​ 创建

  3. 在​ 创建配置 ​对话框中,为配置指定一个​ 标题,启用​ 云配置,然后选择​ 创建。 系统创建一个配置容器来存储 Cloud Services。确保文件夹名称不包含任何空格。

  4. 导航到​ 工具 锤子 > Cloud Service > Adobe Acrobat Sign,然后打开您在上一步中创建的配置容器。

    note note
    NOTE
    在创建自适应表单时,请在​ 配置容器 ​字段中指定容器名称。
  5. 在配置页面上,选择​ 创建 ​以在AEM Forms中创建Adobe Acrobat Sign配置。

  6. 在​ 创建Adobe Acrobat Sign配置 ​页面的​ 常规 ​选项卡中,为配置指定一个​ 名称,然后选择​ 下一步。 您可以选择指定​ 标题 ​并浏览以选择配置的​ 缩略图

  7. 现在您可以​ 选择解决方案 ​以选择Adobe Acrobat Sign。

    Adobe Acrobat Sign Solutions

  8. 将当前浏览器窗口中存在的URL复制到笔记本,并从URL中删除部分/ui#/aem。 在后续步骤中,需要修改的URL才能使用AEM Forms配置Adobe Acrobat Sign应用程序。 选择​ 下一步

  9. 在​ 设置 ​选项卡中,

    • OAuth URL ​字段包含包含Adobe Sign数据库分片的默认URL。 URL 的格式为:

      https://<shard>/public/oauth/v2

      例如:
      https://secure.na1.echosign.com/public/oauth/v2

    • Access令牌URL ​字段包含包含Adobe Sign数据库分片的默认URL。 URL 的格式为:

      https://<shard>/oauth/v2/token

      例如:
      https://api.na1.echosign.com/oauth/v2/token

    其中:

    na1 指默认数据库分片。您可以修改数据库分片的值。确保 ​ Adobe Acrobat Sign 云配置指向正确分片

    note note
    NOTE
    • 保持​ 创建Adobe Acrobat Sign配置 ​页面打开。 不要关闭它。 在为Adobe Acrobat Sign应用程序配置OAuth设置后,您可以检索​ 客户端ID ​和​ 客户端密钥,如即将执行的步骤中所述。
    • 登录Adobe Sign帐户后,导航到​ Acrobat Sign API > API信息 > REST API方法文档 > OAuth访问令牌,以访问与Adobe Sign OAuth URL和访问令牌URL相关的信息。
  10. 配置 Adobe Acrobat Sign 应用程序的 OAuth 设置:

    1. 打开浏览器窗口,并登录到您的 Adobe Acrobat Sign 开发人员帐户。

    2. 选择为AEM Forms配置的应用程序,然后选择​ 为应用程序 ​配置OAuth。

    3. 在​ 重定向URL ​框中,添加上一步中复制的URL(步骤8),然后单击​ 保存

    4. 为Adobe Acrobat Sign应用程序启用以下作用域,然后单击​ 保存

    • aggrement_read
    • aggrement_write
    • aggrement_send
    • widget_read
    • widget_write
    • workflow_read

    有关为 Adobe Acrobat Sign 应用程序配置 OAuth 设置并获取密钥的分步信息,请参阅为应用程序配置 OAuth 设置开发人员文档。

    OAuth 配置

  11. 返回​ 创建Adobe Acrobat Sign配置 ​页面。 在​ 设置 ​选项卡中,指定[客户端ID (也称为应用程序ID)和​ 客户端密钥]。 使用您在上一步中创建的Adobe Acrobat Sign应用程序🔗的客户端ID和客户端密钥。

  12. 选择​ 为附件启用Adobe Acrobat Sign ​选项以将附加到自适应表单的文件附加到已发送以供签名的相应Adobe Acrobat Sign文档。

  13. 选择​ 连接到Adobe Acrobat Sign。 在系统提示输入凭据时,提供创建Adobe Acrobat Sign应用程序时使用的帐户的​ 用户名 ​和​ 密码。 当要求您确认your developer account的访问时,请单击​ 允许访问。 如果凭据正确,并且您允许 AEM Forms 访问您的 Adobe Acrobat Sign 开发人员帐户,系统会显示一条与以下内容类似的成功消息。

    Adobe Acrobat Sign云配置成功

  14. 选择​ 创建 ​以创建Adobe Acrobat Sign配置。

  15. 选择配置并单击​ Publish,选择配置,然后单击​ Publish。 这会将配置复制到相应的发布环境。

  16. 在开发人员实例、暂存实例和生产实例(以剩下的实例为准)上重复上述所有步骤以使用 AEM Forms 为环境配置 Adobe Acrobat Sign。

现在,您可以将Adobe Acrobat Sign字段添加到自适应表单。 确保将用于 Cloud Service 的配置容器添加到为 Adobe Acrobat Sign 启用的所有自适应表单。您可以在自适应表单的属性中指定配置容器。

NOTE
要配置Adobe Sign沙盒,您可以按照Adobe Sign中所述的相同配置步骤操作。

疑难解答 resolve-config-error

当您将Adobe Acrobat Sign与AEM Forms连接并查找错误Unable to authorize access because the client configuration is invalid: invalid_request时,如下图所示。 可执行以下步骤来解决此问题:

配置错误

  1. 将当前浏览器窗口中存在的URL复制到笔记本,并从URL中删除部分/ui#/aem
  2. 打开浏览器窗口,并登录到您的 Adobe Acrobat Sign 开发人员帐户。
  3. 选择为AEM Forms配置的应用程序,然后选择​ 为应用程序 ​配置OAuth。
  4. 在​ 重定向URL ​框中,添加上一步中复制的URL,然后单击​ 保存

将AEM Forms与适用于政府的Adobe Acrobat Sign Solutions连接 adobe-acrobat-sign-for-government

将AEM Forms与面向政府的Adobe Acrobat Sign Solutions连接是一个多步骤过程。 它涉及:

  • 为您的AEM实例创建重定向URL
  • 与面向政府团队的Adobe Sign解决方案共享重定向URL和范围
  • 从Adobe Sign团队接收凭据
  • 使用收到的凭据将AEM Forms与适用于政府的Adobe Acrobat Sign Solutions连接

Adobe Sign政府工作流程

AEM Formsas a Cloud Service提供开发、暂存和生产环境。 您可以将的开发环境与的Adobe Acrobat Sign Solutions政府版连接,以后再连接暂存环境和生产环境。

开始之前 prerequisites-for-adobe-sign-for-acrobat-sign-for-government

在开始将AEM Forms与Adobe Acrobat Sign解决方案连接之前,请确保已配置您的Adobe Acrobat Sign Solutions for Government帐户。

将AEM Formsas a Cloud Service与适用于政府的Adobe Acrobat Sign Solutions连接 connect-adobe-acrobat-sign-for-government

为您的AEM实例创建重定向URL

  1. 在Formsas a Cloud Service创作实例上,导航到​ 工具 锤子 > 常规 > 配置浏览器
  2. 在​ 配置浏览器 ​页面上,选择​ 创建
  3. 在​ 创建配置 ​对话框中,为配置指定一个​ 标题,启用​ 云配置,然后选择​ 创建。 它将创建一个配置容器来存储Cloud Service。 确保文件夹名称不包含任何空格。
  4. 导航到​ 工具 锤子 > Cloud Service > Adobe Acrobat Sign,然后打开您在上一步中创建的配置容器。 在创建自适应表单时,请在​ 配置容器 ​字段中指定容器名称。
  5. 在配置页面上,选择​ 创建 ​以在AEM Forms中创建Adobe Acrobat Sign配置。
  6. 将当前浏览器窗口的URL复制到记事本,并从URL中删除/ui#/aem。 此URL称为re-direct URL
    在下一部分中,您与Adobe Sign团队共享re-direct URLScopes,并请求凭据(客户端ID和客户端密钥)。

与Adobe Sign团队共享重定向URL和作用域并接收凭据

Adobe Acrobat Sign政府解决方案团队要求为您的Adobe Acrobat Sign应用程序(如下所列)启用re-direct URL和某些范围,以生成凭据(客户端ID和客户端密钥),从而允许您将AEM Forms与适用于政府的Adobe Acrobat Sign Solutions连接。

与您的Adobe Acrobat Sign政府解决方案代表(Adobe Professional Services团队成员)共享scopes(如下所列),并共享在上一部分中创建并记下的最后一步的re-direct URL

范围

  • aggrement_read
  • aggrement_write
  • aggrement_send
  • widget_read
  • widget_write
  • workflow_read
  • offline_access

该代表会生成凭据并与您共享。 在下一部分中,您使用凭据(客户端ID和客户端密钥)将AEM Forms与用于政府的Adobe Acrobat Sign Solutions连接。

使用收到的凭据将AEM Forms与适用于政府的Adobe Acrobat Sign Solutions连接

  1. 在浏览器中打开re-direct URL。 您在在AEM实例部分中创建重定向URL的最后一步中创建并记下了re-direct URL

  2. 在​ 创建Adobe Sign配置 ​页面的​ 常规 ​选项卡中,为配置指定一个​ 名称,然后选择​ 下一步。 您可以选择指定​ 标题 ​并浏览以选择配置的​ 缩略图。 单击​ 下一步

  3. 在​ 创建Adobe Sign配置 ​页面的​ 设置 ​选项卡中,对于​ 选择解决方案 ​选项,选择Adobe Acrobat Sign Solutions for Government。

    政府用 Adobe Acrobat Sign Solutions

  4. 在​ 电子邮件 ​字段中,为政府帐户指定与您的Adobe Acrobat Sign Solutions关联的电子邮件地址。

  5. 在​ 设置 ​选项卡中,

    • OAuth URL ​字段包含包含Adobe Sign数据库分片的默认URL。 URL 的格式为:

      https://<shard>/api/gateway/adobesignauthservice/api/v1/authorize

      例如:
      https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/authorize

    • Access令牌URL ​字段包含包含Adobe Sign数据库分片的默认URL。 URL 的格式为:

      https://<shard>/api/gateway/adobesignauthservice/api/v1/token

      例如:
      https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/token

    其中:

    na1 指默认数据库分片。您可以修改数据库分片的值。确保 ​ Adobe Acrobat Sign 云配置指向正确分片

    note note
    NOTE
    • 登录Adobe Sign帐户后,导航到​ Acrobat Sign API > API信息 > REST API方法文档 > OAuth访问令牌,以访问与Adobe Sign oAuth URL和访问令牌URL相关的信息。
  6. 将Adobe Acrobat Sign在上一节中为政府解决方案代表([Adobe Professional Services团队成员])共享的凭据用作[客户端ID ​和​ 客户端密钥]。

  7. 选择​ 为附件启用Adobe Acrobat Sign ​选项以将附加到自适应表单的文件附加到已发送以供签名的相应Adobe Acrobat Sign文档。

  8. 选择​ 连接到Adobe Sign。 在系统提示输入凭据时,提供在创建 Adobe Acrobat Sign 应用程序时所用帐户的用户名和密码。当要求您确认your developer account的访问时,请单击​ 允许访问。 如果凭据正确,并且您允许 AEM Forms 访问您的 Adobe Acrobat Sign 开发人员帐户,系统会显示一条与以下内容类似的成功消息。

    Adobe Acrobat Sign云配置成功

  9. 选择​ 创建 ​以创建配置。

  10. 选择配置并单击​ Publish,选择配置,然后单击​ Publish。 这会将配置复制到相应的发布环境。

  11. 在开发人员实例、暂存实例和生产实例(以剩下的实例为准)上重复上述所有步骤以使用 AEM Forms 为环境配置 Adobe Acrobat Sign Solutions for Government。

现在,您可以在自适应表单AEM Workflow中添加Adobe Acrobat Sign字段。 确保将用于Cloud Service配置的配置容器添加到为Adobe Acrobat Sign启用的所有自适应Forms。 您可以在自适应表单的属性中指定配置容器。

配置Adobe Acrobat Sign计划程序以同步签名状态 configure-adobe-sign-scheduler-to-sync-the-signing-status

AEM Formsas a Cloud Service提供调度程序服务,可按定义的时间间隔检查签名者的状态。 配置计划程序服务的方案:

  • 如果您使用提交表单(在每个收件人完成签字仪式后)来签署文档,则只有在所有签名者都签署表单后才提交表单。
  • 如果您使用AEM Workflow🔗中的签名步骤对文档进行签名,则签名步骤将等待所有签名者签名该文档,然后再继续工作流的下一步。

默认情况下,Adobe Acrobat Sign 调度程序服务每 24 小时检查(轮询)一次签名者响应。您可以为您的环境更改此默认间隔。

要更改默认间隔,请为​ Adobe Acrobat Sign Configuration Service ​配置的​ sign.status.exp ​属性指定cron表达式

例如,要在每天凌晨00:00运行配置服务,请设置​ Adobe Acrobat Sign Configuration Service ​配置的​ sign.status.exp ​属性以指定0 0 0 1/1 * ? *。 以下 JSON 文件显示了每天凌晨 00:00 运行配置服务的示例:

{
  "sign.status.exp":"0 0 0 1/1 * ? *"
}

要设置配置的值,请使用 AEM SDK 生成 OSGi 配置,并向 Cloud Service 实例部署配置

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