搭配最適化表單使用DocuSign integrate-aem-forms-with-DocuSign
DocuSign是重要的電子簽章解決方案。 您可以用它來簽署合約。 您可以將DocuSign與最適化表單整合。 它可協助您傳送最適化表單以供多個收件者進行電子簽章。 使用電子簽章可協助您:
- 透過完全自動化的提案、報價及合約程式,完成任何裝置的交易。
- 更快地完成人力資源程式,並為員工提供數位體驗。
- 縮短合約週期時間,讓您的廠商更快上線。
AEM Formsas a Cloud Service提供DocuSign🔗的自訂提交動作。 提交動作可協助您使用DocuSign API傳送電子簽章的最適化表單。
先決條件 prerequisites
以下是DocuSign與AEM Forms整合的必要條件:
- DocuSign 開發人員帳戶
- docussign應用程式
- 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專案,或根據AEM Archetype 27或更新版本將Experience Manager Forms建立為Cloud Service專案。 若要根據AEM Archetype將Experience Manager Forms建立為Cloud Service專案:
開啟命令提示字元並執行以下命令以建立Experience Manager Formsas 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>
-
-
在Cloud Service專案資料夾中可用的
all/pom.xml
檔案中執行以下步驟:-
在
<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。
-
瀏覽至 Tools > Cloud Service > DocuSign,並選取要裝載設定的資料夾。
-
在設定頁面上,選取「建立」以在AEM Forms中建立DocuSign設定。
-
在 建立DocuSign組態 頁面的 一般 標籤中,指定組態的 名稱,並選取 下一步。 您可以選擇指定 標題。
-
將您目前瀏覽器視窗中的 URL 複製到筆記本。在後續步驟中,需要使用此 URL 設定 DocuSign 應用程式和 AEM Forms。
-
設定 DocuSign 應用程式的 OAuth 設定:
- 開啟瀏覽器視窗並登入您的DocuSign 開發人員帳戶。
- 開啟為AEM Forms設定的應用程式。
- 在 重新導向URI 方塊中,新增在上一步中複製的URL,然後按一下 儲存。
- 記下整合與秘密金鑰。
如需設定 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。
現在,您的AEM Forms環境已設定為使用DocuSign。 請確保您將用於 Cloud Service 的設定容器新增至 DocuSign 啟用的所有最適化表單。您可以從最適化表單的屬性指定設定容器。
在最適化表單中使用DocuSign enabledocusign
您可以為現有的調適型表單啟用DocuSign,或建立啟用DocuSign的調適型表單。 選擇下列其中一項:
- 建立啟用 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電子簽章提交。
-
在 動作組態 區段中,選取 新增 以新增收件者並指定收件者的電子郵件地址。 再次選取 新增 以新增更多收件者。
-
在 電子郵件主旨 欄位中指定電子郵件訊息的主旨。 選取 包含附件 以在電子郵件訊息中包含附件。
-
選取 以儲存屬性。