将DocuSign与自适应表单结合使用

上次更新: 2023-12-05

DocuSign是一个著名的电子签名解决方案。 您可以用它来电子签署协议。 您可以将DocuSign与自适应表单集成。 它有助于您将电子签名的自适应表单发送给多个收件人。 使用电子签名可帮助您:

  • 使用完全自动化的计划书、报价和合同流程从任何设备完成交易。
  • 更快地完成人力资源流程,并为员工提供数字体验。
  • 缩短合同周期,更快地吸引供应商。

AEM Formsas a Cloud Service提供 适用于DocuSign的自定义提交操作. 提交操作可帮助您使用DocuSign API发送电子签名自适应表单。

您还可以使用Adobe的电子签名解决方案Adobe Sign对自适应表单进行电子签名。 AEM Forms与Adobe Sign的集成更深入了,它提供了更精细的控制,如顺序和并行签名、多种身份验证方法、表单内签名体验等。 有关更多信息,请参阅 在自适应表单中使用Adobe Sign.

前提条件

要将DocuSign与AEM Forms集成,需要以下项:

配置自定义提交操作和DocuSign云服务

AEM Formsas a Cloud Service提供DocuSign的自定义提交操作。 提交操作可帮助您使用DocuSign API发送电子签名自适应表单。 自定义提交操作的代码在以下位置提供: AEM Forms示例公共git存储库. 您可以在您的AEM Forms环境中按原样部署代码,也可以根据贵组织的要求自定义代码。

执行以下步骤以配置现成的自定义提交操作和DocuSignCloud Service:

  1. 克隆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项目:

    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"
    

    另外,更改 appTitleappId、和 groupId,以反映您的环境。

  2. 克隆 aem-forms-samples 存储库。 此存储库包含用于DocuSign的自定义提交操作以及连接到DocuSign服务器的配置详细信息。

  3. 打开在步骤1中创建的AEM Formsas a Cloud Service项目,以便在您选择的IDE中进行编辑。

  4. 打开 [AEM Forms as a Cloud Service project]\pom.xml 文件进行编辑并进行以下更改:

    1. 将以下文本添加至 <properties> 标记:

      <repository.location>maven_repository</repository.location>
      
    2. 将以下文本添加至 <repositories> 标记:

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

      如果没有 <repositories> 标记下,创建标记 <properties> 标记之前。

    3. 将以下文本添加至 <dependencyManagement> 标记:

       <dependency>
         <groupId>com.adobe.aemforms.samples</groupId>
         <artifactId>forms.integration.docusign.all</artifactId>
         <type>zip</type>
         <version>1.0.0</version>
       </dependency>
      
  5. all/pom.xml Cloud Service项目文件夹中可用的文件:

    1. 将以下文本添加至 <embeddeds> 标记:

       <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> 标记:

       <dependency>
          <groupId>com.adobe.aemforms.samples</groupId>
          <artifactId>forms.integration.docusign.all</artifactId>
          <type>zip</type>
       </dependency>
      
  6. 打开命令提示符并导航至 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中创建的文件夹的名称。

  7. 将项目部署到您的本地开发环境。 您可以使用以下命令部署到本地开发环境

    mvn -PautoInstallPackage clean install

    执行这些步骤后,您可以查看新的自定义提交操作 使用DocuSign电子签名提交 在自适应表单和的提交选项列表中可用 DocuSign云服务配置 (在您的本地开发环境中)。

  8. 编译和 将代码部署到您的 AEM Forms as a Cloud Service环境.

集成 DocuSign 替换为 AEM Forms

满足前提条件后,执行以下步骤以集成 DocuSign 替换为 AEM Forms 在“创作”实例上。

  1. 导航到 工具 锤子 > Cloud Service > DocuSign 并选择一个文件夹来托管配置。

  2. 在配置页面上,选择 创建 创建 DocuSign AEM Forms配置。

  3. 常规 选项卡 创建DocuSign配置 页面,指定 名称 对于配置,并选择 下一个. 您可以选择指定 标题.

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

  5. 配置 DocuSign 应用程序的 OAuth 设置:

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

    有关为 DocuSign 应用程序配置 OAuth 设置并获取密钥的分步信息,请参阅为应用程序配置 OAuth 设置开发人员文档。

  6. 返回 创建DocuSign配置 页面。 在 设置 选项卡, OAuth URL 字段提及以下默认URL:

    https://account-d.docusign.com/oauth/auth

  7. 指定 客户端ID (DocuSign集成密钥)和 客户端密码 (DocuSign密钥)

  8. 选择 连接到DocuSign. 在系统提示输入凭据时,提供在创建 DocuSign 应用程序时所用帐户的用户名和密码。当要求确认访问时 your developer account,单击 允许访问. 如果凭据正确,将显示一条成功消息。

  9. 选择 创建 创建 DocuSign 配置。

  10. 选择配置并单击 Publish,选择配置,然后单击 Publish. 这会将配置复制到相应的发布环境。

  11. 在开发人员实例、暂存实例和生产实例(以剩下的实例为准)上重复上述所有步骤以使用 AEM Forms 为环境配置 DocuSign。

现在,您的AEM Forms环境配置为使用DocuSign。 确保将用于 Cloud Service 的配置容器添加到为 DocuSign 启用的所有自适应表单。您可以从自适应表单的属性中指定配置容器。

使用 DocuSign 在自适应表单中

您可以启用 DocuSign 创建自适应表单或创建 DocuSign 已启用自适应表单。 选择下列选项之一:

创建DocuSign自适应表单

要创建启用签名的自适应表单,请执行以下操作:

  1. 导航到 Adobe Experience Manager > Forms > Forms和文档.

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

  3. 基本 选项卡:

    1. 指定 名称标题 用于自适应表单。

    2. 选择 配置容器 创建时间 集成 DocuSign 替换为 AEM Forms.

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

  4. 表单模型 选项卡,选择以下选项之一:

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

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

  5. 选择 创建。 将创建一个支持签名的自适应表单。 您可以添加 DocuSign 将字段发送到表单以供签名。

  6. 在编辑模式下打开自适应表单。 在 内容 选项卡,选择 表单容器 并选择 配置.

  7. 提交 部分,选择 使用DocuSign电子签名提交提交操作 下拉列表。

  8. 操作配置 部分,选择 添加 以添加收件人并指定收件人的电子邮件地址。 选择 添加 以添加更多收件人。

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

  10. 选择 保存 以保存属性。

启用 DocuSign 自适应表单

使用 DocuSign 在现有的自适应表单中:

  1. 导航到 Adobe Experience Manager > Forms > Forms和文档.

  2. 选择自适应表单,然后选择 属性.

  3. 基本 选项卡,选择 配置容器 集成时创建 DocuSign 替换为 AEM Forms.

  4. 表单模型 选项卡,选择以下选项之一:

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

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

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

  6. 在编辑模式下打开自适应表单。 在 内容 选项卡,选择 表单容器 并选择 配置.

  7. 提交 部分,选择 使用DocuSign电子签名提交提交操作 下拉列表。

  8. 操作配置 部分,选择 添加 以添加收件人并指定收件人的电子邮件地址。 选择 添加 以添加更多收件人。

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

  10. 选择 保存 以保存属性。

在此页面上