将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。确保文件夹名称不包含任何空格。
-
导航到 工具 > Cloud Service > Adobe Acrobat Sign,然后打开您在上一步中创建的配置容器。
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
您可以直接从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。 确保文件夹名称不包含任何空格。
- 导航到 工具 > Cloud Service > Adobe Acrobat Sign,然后打开您在上一步中创建的配置容器。 在创建自适应表单时,请在 配置容器 字段中指定容器名称。
- 在配置页面上,选择 创建 以在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签名页面。