将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的默认同步间隔现已更改。