将AEM Formsas a Cloud Service与Adobe Acrobat Sign连接 integrate-adobe-sign-with-aem-forms
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集成：
- 有效的Adobe Acrobat Sign开发人员帐户。
- Adobe Acrobat Sign API应用程序。
- Adobe Acrobat Sign API 应用程序的凭据（客户端 ID 和客户端密码）。
- （仅适用于基于Government ID的身份验证）为政府ID身份验证启用身份验证方法。
将AEM Forms创作和发布实例连接到Adobe Acrobat Sign configure-adobe-sign-with-aem-forms
满足前提条件后，执行以下步骤以在创作实例上使用 AEM Forms 配置 Adobe Acrobat Sign。
-
在AEM Forms创作实例上，导航到 工具
-
在 配置浏览器 页面上，选择 创建。
-
在 创建配置 对话框中，为配置指定一个 标题，启用 云配置，然后选择 创建。 系统创建一个配置容器来存储 Cloud Services。确保文件夹名称不包含任何空格。
-
导航到 工具
note note NOTE 在创建自适应表单时，请在 配置容器 字段中指定容器名称。 -
在配置页面上，选择 创建 以在AEM Forms中创建Adobe Acrobat Sign配置。
-
在 创建Adobe Acrobat Sign配置 页面的 常规 选项卡中，为配置指定一个 名称，然后选择 下一步。 您可以选择指定 标题 并浏览以选择配置的 缩略图。
-
现在您可以 选择解决方案 以选择Adobe Acrobat Sign。
-
将当前浏览器窗口中存在的URL复制到笔记本，并从URL中删除部分
/ui#/aem。 在后续步骤中，需要修改的URL才能使用AEM Forms配置Adobe Acrobat Sign应用程序。 选择 下一步。 -
在 设置 选项卡中，
-
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相关的信息。
-
-
配置 Adobe Acrobat Sign 应用程序的 OAuth 设置：
-
打开浏览器窗口，并登录到您的 Adobe Acrobat Sign 开发人员帐户。
-
选择为AEM Forms配置的应用程序，然后选择 为应用程序 配置OAuth。
-
在 重定向URL 框中，添加上一步中复制的URL（步骤8），然后单击 保存。
-
为Adobe Acrobat Sign应用程序启用以下作用域，然后单击 保存。
- aggrement_read
- aggrement_write
- aggrement_send
- widget_read
- widget_write
- workflow_read
note note NOTE 您可以直接从AEM UI中将作用域修饰符从 self更改为account，如步骤12中所述。有关为 Adobe Acrobat Sign 应用程序配置 OAuth 设置并获取密钥的分步信息，请参阅为应用程序配置 OAuth 设置开发人员文档。
-
-
返回 创建Adobe Acrobat Sign配置 页面。 在 设置 选项卡中，指定[客户端ID （也称为应用程序ID）和 客户端密钥]。 使用您在上一步中创建的Adobe Acrobat Sign应用程序🔗的客户端ID和客户端密钥。
-
在授权范围部分中，您可以根据需要通过将前缀“self”或“account”添加到范围中，将范围修改为“account”或“self”。
-
选择 为附件启用Adobe Acrobat Sign 选项以将附加到自适应表单的文件附加到已发送以供签名的相应Adobe Acrobat Sign文档。
-
选择 连接到Adobe Acrobat Sign。 在系统提示输入凭据时，提供创建Adobe Acrobat Sign应用程序时使用的帐户的 用户名 和 密码。 当要求您确认
your developer account的访问时，请单击 允许访问。 如果凭据正确，并且您允许 AEM Forms 访问您的 Adobe Acrobat Sign 开发人员帐户，系统会显示一条与以下内容类似的成功消息。
-
选择 创建 以创建Adobe Acrobat Sign配置。
-
选择配置并单击 Publish，选择配置，然后单击 Publish。 这会将配置复制到相应的发布环境。
-
在开发人员实例、暂存实例和生产实例（以剩下的实例为准）上重复上述所有步骤以使用 AEM Forms 为环境配置 Adobe Acrobat Sign。
现在，您可以将Adobe Acrobat Sign字段添加到自适应表单。 确保将用于 Cloud Service 的配置容器添加到为 Adobe Acrobat Sign 启用的所有自适应表单。您可以在自适应表单的属性中指定配置容器。
疑难解答 resolve-config-error
当您将Adobe Acrobat Sign与AEM Forms连接并查找错误Unable to authorize access because the client configuration is invalid: invalid_request时，如下图所示。 可执行以下步骤来解决此问题：
- 将当前浏览器窗口中存在的URL复制到笔记本，并从URL中删除部分
/ui#/aem。 - 打开浏览器窗口，并登录到您的 Adobe Acrobat Sign 开发人员帐户。
- 选择为AEM Forms配置的应用程序，然后选择 为应用程序 配置OAuth。
- 在 重定向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连接
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
- 在Formsas a Cloud Service创作实例上，导航到 工具
- 在 配置浏览器 页面上，选择 创建。
- 在 创建配置 对话框中，为配置指定一个 标题，启用 云配置，然后选择 创建。 它将创建一个配置容器来存储Cloud Service。 确保文件夹名称不包含任何空格。
- 导航到 工具
- 在配置页面上，选择 创建 以在AEM Forms中创建Adobe Acrobat Sign配置。
- 将当前浏览器窗口的URL复制到记事本，并从URL中删除
/ui#/aem。 此URL称为re-direct URL。
在下一部分中，您与Adobe Sign团队共享re-direct URL和Scopes，并请求凭据（客户端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连接
-
在浏览器中打开
re-direct URL。 您在在AEM实例部分中创建重定向URL的最后一步中创建并记下了re-direct URL。 -
在 创建Adobe Sign配置 页面的 常规 选项卡中，为配置指定一个 名称，然后选择 下一步。 您可以选择指定 标题 并浏览以选择配置的 缩略图。 单击 下一步。
-
在 创建Adobe Sign配置 页面的 设置 选项卡中，对于 选择解决方案 选项，选择Adobe Acrobat Sign Solutions for Government。
政府用
-
在 电子邮件 字段中，为政府帐户指定与您的Adobe Acrobat Sign Solutions关联的电子邮件地址。
-
在 设置 选项卡中，
-
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相关的信息。
-
-
将Adobe Acrobat Sign在上一节中为政府解决方案代表([Adobe Professional Services团队成员])共享的凭据用作[客户端ID 和 客户端密钥]。
-
选择 为附件启用Adobe Acrobat Sign 选项以将附加到自适应表单的文件附加到已发送以供签名的相应Adobe Acrobat Sign文档。
-
选择 连接到Adobe Sign。 在系统提示输入凭据时，提供在创建 Adobe Acrobat Sign 应用程序时所用帐户的用户名和密码。当要求您确认
your developer account的访问时，请单击 允许访问。 如果凭据正确，并且您允许 AEM Forms 访问您的 Adobe Acrobat Sign 开发人员帐户，系统会显示一条与以下内容类似的成功消息。
-
选择 创建 以创建配置。
-
选择配置并单击 Publish，选择配置，然后单击 Publish。 这会将配置复制到相应的发布环境。
-
在开发人员实例、暂存实例和生产实例（以剩下的实例为准）上重复上述所有步骤以使用 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 实例部署配置。
常见问题解答
- 问：我能否在iframe中渲染Adobe Sign GovCloud签名页面？
- A： 是，您可以在iframe中渲染Adobe Sign GovCloud签名页面。