将Adobe Sign与AEM Forms集成 integrate-adobe-sign-with-aem-forms
Adobe 建议使用现代、可扩展的数据捕获核心组件,以创建新的自适应表单或将自适应表单添加到 AEM Sites 页面。这些组件代表有关创建自适应表单的重大改进,确保实现令人印象深刻的用户体验。本文介绍了使用基础组件创作自适应表单的旧方法。
Adobe Sign为自适应表单启用电子签名工作流。 电子签名改进了法律、销售、工资单、人力资源管理和其他许多方面的文档的处理工作流。
在典型的 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 连接,请设置先决条件部分中列出的软件和帐户,并将Adobe Sign连接到您的所有AEM Forms创作实例和Publish实例:
先决条件 prerequisites
您需要以下项才能将Adobe Sign与AEM Forms集成:
- 有效的Adobe Sign开发人员帐户。
- 已启用SSL AEM Forms服务器。
- Adobe Sign API 应用程序。
- Adobe Sign API 应用程序的凭据(客户端 ID 和客户端密码)。
- 重新配置时,从创作实例和发布实例中删除现有Adobe Sign配置。
- 针对创作实例和发布实例,使用相同的加密密钥。
使用AEM Forms配置Adobe Sign configure-adobe-sign-with-aem-forms
满足前提条件后,执行以下步骤以在创作实例上使用AEM Forms配置Adobe Sign:
-
在AEM Forms创作实例上,导航到 工具 > 常规 > 配置浏览器。
-
在 配置浏览器 页面上,选择 创建。
- 有关详细信息,请参阅配置浏览器文档。
-
在 创建配置 对话框中,为配置指定一个 标题,启用 云配置,然后选择 创建。 它会创建一个配置容器。
-
导航到 工具 > Cloud Service > Adobe Sign,然后选择您在上一步中创建的配置容器。
note note NOTE 您可以执行步骤1-4创建配置容器并在容器中创建Adobe Sign配置,或者使用 Cloud Service > 工具 > Adobe Sign 中的现有 global
文件夹。 如果您在新配置容器中创建配置,请确保在创建自适应表单时在 配置容器 字段中指定容器名称。note note NOTE 确保Cloud Service配置页的URL以 HTTPS 开头。 如果没有,则为AEM Forms服务器启用SSL。 -
在配置页面上,点按 创建 以在AEM Forms中创建Adobe Sign配置。
-
在 创建Adobe 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 Sign 应用程序的 OAuth 设置:
-
打开浏览器窗口并登录到Adobe Sign开发人员帐户。
-
选择为AEM Forms配置的应用程序,然后选择 为应用程序配置OAuth。
-
将 客户端ID 和 客户端密钥 复制到记事本。
-
在 重定向URL 框中,添加上一步中复制的HTTPS URL。
-
为Adobe Sign应用程序启用以下OAuth设置,然后单击 保存。
- agreement_read
- agreement_write
- agreement_send
- widget_write
- workflow_read
有关为 Adobe Sign 应用程序配置 OAuth 设置并获取密钥的分步信息,请参阅为应用程序配置 OAuth 设置开发人员文档。
-
-
返回 创建Adobe Sign配置 页面。 在 设置 选项卡中,指定 客户端ID(也称为应用程序ID)和 客户端密钥。 使用为AEM Forms创建的Adobe Sign应用程序🔗的客户端ID和客户端密码。
-
选择 同时为附件启用Adobe Sign 选项,以将附加到自适应表单的文件附加到已发送以供签名的相应Adobe Sign文档。
-
选择 连接到Adobe Sign。 在系统提示输入凭据时,提供创建Adobe Sign应用程序时使用的帐户的用户名和密码。
-
点按 创建 以创建Adobe Sign配置。
-
打开AEM Web控制台。 URL是
https://'[server]:[port]'/system/console/configMgr
-
打开 Forms Common Configuration Service.
-
在 允许 字段中,选择 所有用户 — 所有用户(匿名或已登录)都可以预览附件、验证和签署表单,然后单击 保存。 创作实例配置为使用Adobe Sign。
-
Publish配置。
-
使用复制在相应的发布实例上创建相同的配置。
现在,Adobe Sign已与AEM Forms集成并准备好在自适应表单中使用。 要在自适应表单中使用Adobe Sign服务,请在自适应表单属性中指定上面创建的配置容器。
将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连接
开始之前 prerequisites-for-adobe-sign-for-acrobat-sign-for-government
在开始将AEM Forms与Adobe Acrobat Sign解决方案连接之前,
- 确保已配置你的Adobe Acrobat Sign Solutions for Government帐户。
- 您的AEM Forms服务器已启用SSL 。
- 您的AEM Forms服务器正在对创作实例和发布实例使用相同的加密密钥。
将AEM Forms连接到适用于政府的Adobe Acrobat Sign Solutions connect-adobe-acrobat-sign-for-government
为您的AEM实例创建重定向URL
-
在您的AEM Forms实例上,导航到 工具 > 常规 > 配置浏览器。
-
在 配置浏览器 页面上,选择 创建。
-
在 创建配置 对话框中,为配置指定一个 标题,启用 云配置,然后选择 创建。 它会创建一个配置容器。 请确保容器/文件夹名称不包含任何空格。
-
导航到 工具 > Cloud Service > Adobe Acrobat Sign,然后打开您在上一步中创建的配置容器。 在创建自适应表单时,请在 配置容器 字段中指定容器名称。
-
在配置页面上,选择 创建 以在AEM Forms中创建Adobe Acrobat Sign配置。
-
将当前浏览器窗口的URL从URL复制到记事本。 此URL称为
re-direct URL
。 在下一部分中,您与Adobe Sign团队共享re-direct URL
和Scopes
,并请求凭据(客户端ID和客户端密钥)。
re-direct URL
应包含顶级域。 例如,https://adobe.com/libs/adobesign/cloudservices/adobesign/createcloudconfigwizard/cloudservices.html/conf/global
- 请勿将本地URL用作
re-direct URL
。 例如:https://localhost:4502/libs/adobesign/cloudservices/adobesign/createcloudconfigwizard/cloudservices.html/conf/global
。
与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
。
范围
- agreement_read
- agreement_write
- agreement_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 应用程序时所用帐户的用户名和密码。在系统要求您确认
Adobe Acrobat Sign for Government Solutions
和的访问时,请单击 允许访问。 如果凭据正确,并且您允许 AEM Forms 访问您的 Adobe Acrobat Sign 开发人员帐户,系统会显示一条与以下内容类似的成功消息。在系统提示输入凭据时,提供在创建 Adobe Acrobat Sign 应用程序时所用帐户的用户名和密码。当要求您确认
your account
的访问权限时,请单击 允许访问。 -
选择 创建 以创建配置。
-
打开AEM Web控制台。 URL是
https://'[server]:[port]'/system/console/configMgr
-
打开 Forms Common Configuration Service.
-
在 允许 字段中,选择 所有用户 — 所有用户(匿名或已登录)都可以预览附件、验证和签署表单,然后单击 保存。 创作实例配置为使用Adobe Sign。
-
Publish配置。
-
使用复制在相应的发布实例上创建相同的配置。
现在,您可以在自适应表单或AEM Workflow中添加Adobe Acrobat Sign字段。 确保将用于Cloud Service配置的配置容器添加到为Adobe Acrobat Sign启用的所有自适应Forms。 您可以从自适应表单的属性中指定配置容器。
配置Adobe Sign计划程序以同步签名状态 configure-adobe-sign-scheduler-to-sync-the-signing-status
仅在所有签名者完成签名过程后提交启用Adobe Sign的自适应表单。 默认情况下,Adobe Sign计划程序服务计划每24小时检查(轮询)一次签名者响应。 您可以更改环境的默认间隔。 执行以下步骤以更改默认间隔:
-
使用管理员凭据登录到AEM Forms服务器,并导航到 工具 > 操作 > Web控制台。
您还可以在浏览器窗口中打开以下URL:
https://[localhost]:'port'/system/console/configMgr
-
找到并打开 Adobe Sign配置服务 选项。 在 状态更新计划程序表达式 字段中指定cron表达式,然后单击 保存。 例如,要在每天凌晨00:00运行配置服务,请在 状态更新计划程序表达式 字段中指定
0 0 0 1/1 * ? *
。
Adobe Sign的默认同步间隔现已更改。