将DocuSign与自适应表单结合使用 integrate-aem-forms-with-DocuSign

克隆AEM Formsas a Cloud Service项目或基于AEM Archetype 27或更高版本将Experience Manager Forms创建为Cloud Service项目。 要基于AEM原型将Experience Manager Forms创建为Cloud Service项目，请执行以下操作：

打开命令提示符并运行以下命令以创建Experience Manager Formsas a Cloud Service项目：

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文件进行编辑，并进行以下更改：

1. 在<properties>标记的末尾添加以下文本：

   code language-shell
   <repository.location>maven_repository</repository.location>

2. 在<repositories>标记的末尾添加以下文本：

   code language-shell
   <repository> <id>project-repository</id> <url>file://${project.basedir}/${repository.location}</url> </repository>

   如果没有<repositories>标记，请在<properties>标记下创建标记。

3. 在<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>

在Cloud Service项目文件夹中可用的all/pom.xml文件中执行以下步骤：

1. 在<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>

2. 在<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中克隆）并运行以下命令：

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电子签名提交。

编译代码并将其部署到您的 AEM Forms as a Cloud Service环境。

导航到​ Tools > Cloud Service > DocuSign，然后选择要承载配置的文件夹。

在配置页面上，选择​ 创建 ​以在AEM Forms中创建DocuSign配置。

在​ 创建DocuSign配置 ​页面的​ 常规 ​选项卡中，为该配置指定一个​ 名称，然后选择​ 下一步。 您可以选择指定​ 标题。

将当前浏览器窗口中的 URL 复制到记事本。在下一个步骤中使用 AEM Forms 配置 DocuSign 应用程序时需要此 URL。

配置 DocuSign 应用程序的 OAuth 设置：

1. 打开浏览器窗口并登录到您的DocuSign 开发人员帐户。
2. 打开为AEM Forms配置的应用。
3. 在​ 重定向URI ​框中，添加上一步中复制的URL，然后单击​ 保存。
4. 记下集成和密钥。

有关为 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。

导航到​ Adobe Experience Manager > Forms > Forms和文档。

选择​ 创建 ​并选择​ 自适应表单。 此时将显示模板列表。 选择模板并选择​ 下一步。

在​ 基本 ​选项卡中：

1. 为自适应表单指定​ 名称 ​和​ 标题。

2. 选择在集成 DocuSign 与 AEM Forms时创建的配置容器。

配置容器包含为您的环境配置的DocuSignCloud Service。 这些服务可在自适应表单编辑器中选择。

在​ 表单模型 ​选项卡中，选择以下选项之一：

• 如果您有自定义表单模板，并且需要基于表单模板的记录文档，请选择​ 关联表单模板作为记录文档模板 ​选项，然后选择记录文档模板。 使用选项时，发送以供签名的文档仅显示基于关联表单模板的字段。 它不会显示自适应表单的所有字段。

• 如果没有自定义表单模板，请选择​ 生成记录文档 ​选项。 使用选项时，发送以供签名的文档显示自适应表单的所有字段。

选择​ 创建。 ​已创建启用签名的自适应表单。 您可以将DocuSign字段添加到表单并发送以供签名。

在编辑模式下打开自适应表单。 在​ 内容 ​选项卡中，选择​ 表单容器，然后选择 。

在​ 提交 ​部分中，从​ 提交操作 ​下拉列表中选择​ 使用DocuSign电子签名提交。

在​ 操作配置 ​部分中，选择​ 添加 ​以添加收件人并指定收件人的电子邮件地址。 再次选择​ 添加 ​以添加更多收件人。

在​ 电子邮件主题 ​字段中指定电子邮件的主题。 选择​ 包含附件 ​以在电子邮件中包含附件。

选择 以保存属性。

导航到​ Adobe Experience Manager > Forms > Forms和文档。

选择自适应表单并选择​ 属性。

在​ 基本 ​选项卡中，选择将DocuSign与AEM Forms集成时创建的配置容器。

在​ 表单模型 ​选项卡中，选择以下选项之一：

• 如果您有自定义表单模板，并且需要基于表单模板的记录文档，请选择​ 关联表单模板作为记录文档模板 ​选项，然后选择记录文档模板。 使用选项时，发送以供签名的文档仅显示基于关联表单模板的字段。 它不会显示自适应表单的所有字段。

• 如果没有自定义表单模板，请选择​ 生成记录文档 ​选项。 使用选项时，发送以供签名的文档显示自适应表单的所有字段。

选择​ 保存并关闭。 已为DocuSign启用自适应表单。 现在，您可以将DocuSign字段添加到表单并发送以供签名。

在编辑模式下打开自适应表单。 在​ 内容 ​选项卡中，选择​ 表单容器，然后选择 。

在​ 提交 ​部分中，从​ 提交操作 ​下拉列表中选择​ 使用DocuSign电子签名提交。

在​ 操作配置 ​部分中，选择​ 添加 ​以添加收件人并指定收件人的电子邮件地址。 再次选择​ 添加 ​以添加更多收件人。

在​ 电子邮件主题 ​字段中指定电子邮件的主题。 选择​ 包含附件 ​以在电子邮件中包含附件。

选择 以保存属性。