搭配最適化表單使用DocuSign integrate-aem-forms-with-DocuSign

複製AEM Formsas a Cloud Service專案，或根據AEM Archetype 27或更新版本將Experience Manager Forms建立為Cloud Service專案。 若要根據AEM Archetype將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 複製到筆記本。在後續步驟中，需要使用此 URL 設定 DocuSign 應用程式和 AEM Forms。

設定 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

指定​ 使用者端識別碼 （DocuSign整合金鑰）和​ 使用者端密碼 （DocuSign密碼金鑰）。

選取​ 連線到DocuSign。 出現認證提示時，請提供在建立 DocuSign 應用程式時使用的帳戶使用者名稱和密碼。當要求確認your developer account的存取時，請按一下​ 允許存取。 如果認證正確，則會顯示成功訊息。

選取​ 建立 ​以建立DocuSign組態。

選取組態並按一下​ Publish，選取組態，然後按一下​ Publish。 這會將設定複寫至對應的發佈環境。

請對您的開發人員、中繼及生產執行個體 (無論是哪個) 重複上述步驟，以完成您環境的設定 DocuSign with AEM Forms。

導覽至​ Adobe Experience Manager > Forms > Forms與檔案。

選取​ 建立 ​並選取​ 最適化表單。 範本清單隨即顯示。 選取範本並選取​ 下一步。

在​ 基本 ​索引標籤中：

1. 指定最適化表單的​ 名稱 ​和​ 標題。

2. 選取整合 DocuSign 與 AEM Forms時所建立的設定容器。

設定容器包含為您的環境設定的DocuSign個Cloud Service。 這些服務可在最適化表單編輯器中選取。

在​ 表單模型 ​索引標籤中，選取下列其中一個選項：

• 如果您有自訂表格範本，而且需要以表格範本為基礎的記錄檔案，請選取​ 關聯表格範本作為記錄檔案範本 ​選項，並選取記錄檔案範本。 當您使用選項時，傳送以供簽署的檔案只會顯示以相關表單範本為基礎的欄位。 它不會顯示最適化表單的所有欄位。

• 如果您沒有自訂表格範本，請選取​ 產生記錄檔案 ​選項。 當您使用選項時，傳送以供簽署的檔案會顯示最適化表單的所有欄位。

選取​ 建立。 ​已建立啟用簽署的最適化表單。 您可以將DocuSign欄位新增至表單，並傳送以進行簽署。

在編輯模式中開啟最適化表單。 在​ 內容 ​索引標籤中，選取​ 表單容器，然後選取 。

在​ 提交 ​區段中，從​ 提交動作 ​下拉式清單中選取​ 使用DocuSign電子簽章提交。

在​ 動作組態 ​區段中，選取​ 新增 ​以新增收件者並指定收件者的電子郵件地址。 再次選取​ 新增 ​以新增更多收件者。

在​ 電子郵件主旨 ​欄位中指定電子郵件訊息的主旨。 選取​ 包含附件 ​以在電子郵件訊息中包含附件。

選取 以儲存屬性。

導覽至​ Adobe Experience Manager > Forms > Forms與檔案。

選取最適化表單並選取​ 屬性。

在​ 基本 ​索引標籤中，選取整合DocuSign與AEM Forms時所建立的設定容器。

在​ 表單模型 ​索引標籤中，選取下列其中一個選項：

• 如果您有自訂表格範本，而且需要以表格範本為基礎的記錄檔案，請選取​ 關聯表格範本作為記錄檔案範本 ​選項，並選取記錄檔案範本。 當您使用選項時，傳送以供簽署的檔案只會顯示以相關表單範本為基礎的欄位。 它不會顯示最適化表單的所有欄位。

• 如果您沒有自訂表格範本，請選取​ 產生記錄檔案 ​選項。 當您使用選項時，傳送以供簽署的檔案會顯示最適化表單的所有欄位。

選取​ 儲存並關閉。 已為DocuSign啟用最適化表單。 現在，您可以將DocuSign欄位新增至表單，並傳送以進行簽署。

在編輯模式中開啟最適化表單。 在​ 內容 ​索引標籤中，選取​ 表單容器，然後選取 。

在​ 提交 ​區段中，從​ 提交動作 ​下拉式清單中選取​ 使用DocuSign電子簽章提交。

在​ 動作組態 ​區段中，選取​ 新增 ​以新增收件者並指定收件者的電子郵件地址。 再次選取​ 新增 ​以新增更多收件者。

在​ 電子郵件主旨 ​欄位中指定電子郵件訊息的主旨。 選取​ 包含附件 ​以在電子郵件訊息中包含附件。

選取 以儲存屬性。