将DocuSign与自适应表单结合使用 integrate-aem-forms-with-DocuSign
DocuSign是一个著名的电子签名解决方案。 您可以用它来电子签署协议。 您可以将DocuSign与自适应表单集成。 它有助于您将电子签名的自适应表单发送给多个收件人。 使用电子签名可帮助您:
- 使用完全自动化的计划书、报价和合同流程从任何设备完成交易。
- 更快地完成人力资源流程,并为员工提供数字体验。
- 缩短合同周期,更快地吸引供应商。
AEM Formsas a Cloud Service提供 适用于DocuSign的自定义提交操作. 提交操作可帮助您使用DocuSign API发送电子签名自适应表单。
前提条件 prerequisites
要将DocuSign与AEM Forms集成,需要以下项:
- 文档签名 开发人员帐户
- DocuSign应用程序
- DocuSign API应用程序的凭据(客户端ID和客户端密码)。
- 自定义提交操作和适用于DocuSign的云服务
- (仅适用于本地开发环境) 设置记录文档.
配置自定义提交操作和DocuSign云服务 deploy-custom-submit-action
AEM Formsas a Cloud Service提供DocuSign的自定义提交操作。 提交操作可帮助您使用DocuSign API发送电子签名自适应表单。 自定义提交操作的代码在以下位置提供: AEM Forms示例公共git存储库. 您可以在您的AEM Forms环境中按原样部署代码,也可以根据贵组织的要求自定义代码。
执行以下步骤以配置现成的自定义提交操作和DocuSignCloud Service:
-
克隆AEM Formsas a Cloud Service项目 或创建 Experience Manager Forms as a Cloud Service 项目基于 AEM原型27 或更高版本。 创建 Experience Manager Forms as a Cloud Service 基于AEM原型的项目:
打开命令提示符并运行以下命令以创建 Experience Manager Forms as a Cloud Service项目:code language-shell mvn -B archetype:generate -DarchetypeGroupId=com.adobe.aem -DarchetypeArtifactId=aem-project-archetype -DarchetypeVersion=27 -DaemVersion="cloud" -DappTitle="My Site" -DappId="mysite" -DgroupId="com.mysite" -DincludeForms="y"
另外,更改
appTitle
,appId
、和groupId
,以反映您的环境。 -
克隆 aem-forms-samples 存储库。 此存储库包含用于DocuSign的自定义提交操作以及连接到DocuSign服务器的配置详细信息。
-
打开在步骤1中创建的AEM Formsas a Cloud Service项目,以便在您选择的IDE中进行编辑。
-
打开
[AEM Forms as a Cloud Service project]\pom.xml
文件进行编辑并进行以下更改:-
将以下文本添加至
<properties>
标记:code language-shell <repository.location>maven_repository</repository.location>
-
将以下文本添加至
<repositories>
标记:code language-shell <repository> <id>project-repository</id> <url>file://${project.basedir}/${repository.location}</url> </repository>
如果没有
<repositories>
标记下,创建标记<properties>
标记之前。 -
将以下文本添加至
<dependencyManagement>
标记:code language-shell <dependency> <groupId>com.adobe.aemforms.samples</groupId> <artifactId>forms.integration.docusign.all</artifactId> <type>zip</type> <version>1.0.0</version> </dependency>
-
-
在
all/pom.xml
Cloud Service项目文件夹中可用的文件:-
将以下文本添加至
<embeddeds>
标记:code language-shell <embedded> <groupId>com.adobe.aemforms.samples</groupId> <artifactId>forms.integration.docusign.all</artifactId> <type>zip</type> <target>/apps/moonlightprodprogram-vendor-packages/application/install</target> </embedded>
-
将以下文本添加至
<dependencies>
标记:code language-shell <dependency> <groupId>com.adobe.aemforms.samples</groupId> <artifactId>forms.integration.docusign.all</artifactId> <type>zip</type> </dependency>
-
-
打开命令提示符并导航至
aem-forms-samples\forms-integration-docusign
(在步骤3中克隆)并运行以下命令:code language-shell mvn clean install -Dinstall.dir="<AEM Forms as a Cloud Service project path>/maven_repository"
<AEM Forms as a Cloud Service project path>
是指在此过程的步骤1中创建的文件夹的名称。 -
将项目部署到您的本地开发环境。 您可以使用以下命令部署到本地开发环境
mvn -PautoInstallPackage clean install
执行这些步骤后,您可以查看新的自定义提交操作 使用DocuSign电子签名提交 在自适应表单和的提交选项列表中可用 DocuSign云服务配置 (在您的本地开发环境中)。
集成 DocuSign 替换为 AEM Forms configure-docusign-with-aem-forms
满足前提条件后,执行以下步骤以集成 DocuSign 替换为 AEM Forms 在“创作”实例上。
-
导航到 工具 > Cloud Service > DocuSign 并选择一个文件夹来托管配置。
-
在配置页面上,选择 创建 创建 DocuSign AEM Forms配置。
-
在 常规 选项卡 创建DocuSign配置 页面,指定 名称 对于配置,并选择 下一个. 您可以选择指定 标题.
-
将当前浏览器窗口中的 URL 复制到记事本。在下一个步骤中使用 AEM Forms 配置 DocuSign 应用程序时需要此 URL。
-
配置 DocuSign 应用程序的 OAuth 设置:
- 打开浏览器窗口并登录到 DocuSign 开发人员帐户.
- 打开为配置的应用程序 AEM Forms.
- 在 重定向URI 框中,添加上一步中复制的URL并单击 保存.
- 记下集成和密钥。
有关为 DocuSign 应用程序配置 OAuth 设置并获取密钥的分步信息,请参阅为应用程序配置 OAuth 设置开发人员文档。
-
返回 创建DocuSign配置 页面。 在 设置 选项卡, OAuth URL 字段提及以下默认URL:
https://account-d.docusign.com/oauth/auth
-
指定 客户端ID (DocuSign集成密钥)和 客户端密码 (DocuSign密钥)
-
选择 连接到DocuSign. 在系统提示输入凭据时,提供在创建 DocuSign 应用程序时所用帐户的用户名和密码。当要求确认访问时
your developer account
,单击 允许访问. 如果凭据正确,将显示一条成功消息。 -
选择 创建 创建 DocuSign 配置。
-
选择配置并单击 Publish,选择配置,然后单击 Publish. 这会将配置复制到相应的发布环境。
-
在开发人员实例、暂存实例和生产实例(以剩下的实例为准)上重复上述所有步骤以使用 AEM Forms 为环境配置 DocuSign。
现在,您的AEM Forms环境配置为使用DocuSign。 确保将用于 Cloud Service 的配置容器添加到为 DocuSign 启用的所有自适应表单。您可以从自适应表单的属性中指定配置容器。
使用 DocuSign 在自适应表单中 enabledocusign
您可以启用 DocuSign 创建自适应表单或创建 DocuSign 已启用自适应表单。 选择下列选项之一:
创建DocuSign自适应表单 create-an-adaptive-form-for-docusign
要创建启用签名的自适应表单,请执行以下操作:
-
导航到 Adobe Experience Manager > Forms > Forms和文档.
-
选择 创建 并选择 自适应表单. 此时将显示模板列表。 选择模板并选择 下一个.
-
在 基本 选项卡:
-
指定 名称 和 标题 用于自适应表单。
-
选择 配置容器 创建时间 集成 DocuSign 替换为 AEM Forms.
配置容器包含 DocuSign 为您的环境配置的Cloud Service。 这些服务可在自适应表单编辑器中选择。
-
-
在 表单模型 选项卡,选择以下选项之一:
-
如果您有自定义表单模板,并且需要基于表单模板的记录文档,请选择 将表单模板关联为记录文档模板 选项并选择记录文档模板。 使用选项时,发送以供签名的文档仅显示基于关联表单模板的字段。 它不会显示自适应表单的所有字段。
-
如果您没有自定义表单模板,请选择 生成记录文档 选项。 使用选项时,发送以供签名的文档显示自适应表单的所有字段。
-
-
选择 创建。 将创建一个支持签名的自适应表单。 您可以添加 DocuSign 将字段发送到表单以供签名。
-
在编辑模式下打开自适应表单。 在 内容 选项卡,选择 表单容器 并选择 .
-
在 提交 部分,选择 使用DocuSign电子签名提交 从 提交操作 下拉列表。
-
在 操作配置 部分,选择 添加 以添加收件人并指定收件人的电子邮件地址。 选择 添加 以添加更多收件人。
-
在中指定电子邮件的主题 电子邮件主题 字段。 选择 包括附件 以在电子邮件中包含附件。
-
选择 以保存属性。
启用 DocuSign 自适应表单 editafsign
使用 DocuSign 在现有的自适应表单中:
-
导航到 Adobe Experience Manager > Forms > Forms和文档.
-
选择自适应表单,然后选择 属性.
-
在 基本 选项卡,选择 配置容器 集成时创建 DocuSign 替换为 AEM Forms.
-
在 表单模型 选项卡,选择以下选项之一:
-
如果您有自定义表单模板,并且需要基于表单模板的记录文档,请选择 将表单模板关联为记录文档模板 选项并选择记录文档模板。 使用选项时,发送以供签名的文档仅显示基于关联表单模板的字段。 它不会显示自适应表单的所有字段。
-
如果您没有自定义表单模板,请选择 生成记录文档 选项。 使用选项时,发送以供签名的文档显示自适应表单的所有字段。
-
-
选择 保存并关闭. 自适应表单已启用 DocuSign. 现在,您可以添加 DocuSign 将字段发送到表单以供签名。
-
在编辑模式下打开自适应表单。 在 内容 选项卡,选择 表单容器 并选择 .
-
在 提交 部分,选择 使用DocuSign电子签名提交 从 提交操作 下拉列表。
-
在 操作配置 部分,选择 添加 以添加收件人并指定收件人的电子邮件地址。 选择 添加 以添加更多收件人。
-
在中指定电子邮件的主题 电子邮件主题 字段。 选择 包括附件 以在电子邮件中包含附件。
-
选择 以保存属性。