連線AEM Formsas a Cloud Service與Adobe Acrobat Sign integrate-adobe-sign-with-aem-forms
Adobe Acrobat Sign可啟用最適化Forms和AEM工作流程的電子簽章工作流程。 電子簽名有助於改善處理法律、銷售、薪資、人力資源管理及許多領域文件的工作流程。
在標準 Adobe Acrobat Sign 和最適化表單情境下,用戶會填寫最適化表單來申請服務。例如,信用卡申請表和市民福利表單。用戶申請、提交和簽署申請表單時,此表單會被傳送給服務提供者,以進一步動作。服務提供者便會審查申請並使用 Adobe Acrobat Sign 標記已核准申請。AEM Forms同時支援適用於政府的Adobe Acrobat Sign和Adobe Acrobat Sign Solutions。 根據您的授權和需求,您可以將AEM Forms與以下任一解決方案整合或連線:
連結AEM Forms與Adobe Acrobat Sign adobe-sign
若要將 AEM Forms 與 Adobe Acrobat Sign 連線,請設定先決條件區段中列出的軟體和帳戶,並在您的Formsas a Cloud Service作者和Publish執行個體中設定Adobe Sign Cloud Service:
連線AEM Forms與Adobe Acrobat Sign的先決條件 prerequisites-for-adobe-sign
您需要下列安裝程式才能將Adobe Acrobat Sign與AEM Forms整合:
- 有效的Adobe Acrobat Sign開發人員帳戶。
- Adobe Acrobat Sign API應用程式。
- Adobe Acrobat Sign API 應用程式的認證 (用戶端 ID 和用戶端密碼)。
- (僅適用於政府機關身分證件驗證) 為政府機關身分證件驗證啟用驗證方法。
連結AEM Forms製作和發佈執行個體與Adobe Acrobat Sign configure-adobe-sign-with-aem-forms
已具備下列先決條件後,請執行以下步驟,以在作者執行個體上設定 Adobe Acrobat Sign 和 AEM Forms。
-
在AEM Forms作者執行個體上,瀏覽至 工具 > 一般 > 設定瀏覽器。
-
在 設定瀏覽器 頁面上,選取 建立。
-
在 建立設定 對話方塊中,指定設定的 標題、啟用 雲端設定,並選取 建立。 這樣便會建立儲存 Cloud Services 的設定容器。請確保資料夾名稱未含任何空格。
-
瀏覽至 工具 > Cloud Service > Adobe Acrobat Sign,並開啟您在上一步中建立的設定容器。
note note NOTE 建立最適化表單時,請在 設定容器 欄位中指定容器名稱。 -
在設定頁面上,選取「建立」以在AEM Forms中建立Adobe Acrobat Sign設定。
-
在 建立Adobe Acrobat Sign組態 頁面的 一般 標籤中,指定組態的 名稱,並選取 下一步。 您可以選擇指定 標題 並瀏覽以選取設定的 縮圖。
-
現在您可以 選取方案 以選取Adobe Acrobat Sign。
-
將您目前瀏覽器視窗中顯示的URL複製到記事本,並從URL移除部分
/ui#/aem
。 在稍後步驟中,需要修改過的URL才能使用AEM Forms設定Adobe Acrobat Sign應用程式。 選取 「下一步」。 -
在 設定 索引標籤中,
-
OAuth URL 欄位包含預設URL,其中包含Adobe Sign資料庫分片。 URL 的格式是:
https://<shard>/public/oauth/v2
例如:
https://secure.na1.echosign.com/public/oauth/v2
-
存取權杖URL 欄位包含預設URL,其中包含Adobe Sign資料庫分片。 URL 的格式是:
https://<shard>/oauth/v2/token
例如:
https://api.na1.echosign.com/oauth/v2/token
其中:
na1 是指預設的資料庫分片。您可以修改資料庫分片的值。確保 Adobe Acrobat Sign Cloud Configurations 指向正確的分片。
note note NOTE - 保持 建立Adobe Acrobat Sign設定 頁面開啟。 不要關閉它。 在設定Adobe Acrobat Sign應用程式的OAuth設定後,您可以擷取 使用者端識別碼 和 使用者端密碼,如即將進行的步驟所述。
- 登入您的Adobe Sign帳戶後,請瀏覽至 Acrobat Sign API > API資訊 > REST API方法檔案 > OAuth存取Token,以存取與Adobe Sign OAuth URL和存取權杖URL相關的資訊。
-
-
設定 Adobe Acrobat Sign 應用程式的 OAuth 設定:
-
開啟瀏覽器視窗並登入您的 Adobe Acrobat Sign 開發人員帳戶。
-
選取為AEM Forms設定的應用程式,然後選取 設定應用程式的OAuth。
-
在 重新導向URL 方塊中,新增在上一步驟中複製的URL (步驟8),然後按一下 儲存。
-
為Adobe Acrobat Sign應用程式啟用下列範圍,然後按一下 儲存。
- aggrement_read
- aggrement_write
- aggrement_send
- widget_read
- widget_write
- workflow_read
note note NOTE 您可以直接從AEM UI將範圍修飾元從 self
變更為account
,如步驟12中所述。如需設定 Adobe Acrobat Sign 應用程式的 OAuth 設定並取得金鑰的逐步資訊,請參閱「設定應用程式的 OAuth 設定」開發人員文件。
-
-
返回 建立Adobe Acrobat Sign設定 頁面。 在 設定 索引標籤中,指定[使用者端識別碼 (也稱為應用程式識別碼)和 使用者端密碼]。 使用您在上一步建立的Adobe Acrobat Sign應用程式🔗的使用者端ID和使用者端密碼。
-
在授權範圍區段中,您可以視需要將前置詞「self」或「account」新增至範圍,將範圍修改為「account」或「self」。
-
選取 為附件啟用Adobe Acrobat Sign 選項,以將最適化表單附加的檔案附加至要簽名的對應Adobe Acrobat Sign檔案。
-
選取 連線至Adobe Acrobat Sign。 出現認證提示時,請提供建立Adobe Acrobat Sign應用程式時所使用帳戶的 使用者名稱 和 密碼。 當要求確認時,請按一下
your developer account
的存取權,然後按一下 允許存取權。 如果認證正確且您允許 AEM Forms 存取您的 Adobe Acrobat Sign 開發人員帳戶,則會出現與以下訊息相似的成功訊息。 -
選取 建立 以建立Adobe Acrobat Sign組態。
-
選取組態並按一下 Publish,選取組態,然後按一下 Publish。 這會將設定複寫至對應的發佈環境。
-
請對您的開發人員、中繼及生產執行個體 (無論是哪個) 重複上述步驟,以完成您環境的設定 Adobe Acrobat Sign with AEM Forms。
現在您可以使用新增Adobe Acrobat Sign欄位至最適化表單。 請確保您將用於 Cloud Service 的設定容器新增至 Adobe Acrobat Sign 啟用的所有最適化表單。您可從最適化表單的屬性指定設定容器。
疑難排解 resolve-config-error
當您連線Adobe Acrobat Sign與AEM Forms並尋找錯誤Unable to authorize access because the client configuration is invalid: invalid_request
時,如下圖所示。 請依照下列步驟解決此問題:
- 將您目前瀏覽器視窗中顯示的URL複製到記事本,並從URL移除部分
/ui#/aem
。 - 開啟瀏覽器視窗並登入您的 Adobe Acrobat Sign 開發人員帳戶。
- 選取為AEM Forms設定的應用程式,然後選取 設定應用程式的OAuth。
- 在 重新導向URL 方塊中,新增先前步驟中複製的URL,然後按一下 儲存。
連線適用於政府的AEM Forms與Adobe Acrobat Sign Solutions adobe-acrobat-sign-for-government
將AEM Forms與適用於政府的Adobe Acrobat Sign Solutions連線是多步驟流程。 其中涉及:
- 為您的AEM執行個體建立重新導向URL
- 與適用於政府團隊的Adobe Sign解決方案共用重新導向URL和範圍
- 接收來自Adobe Sign團隊的認證
- 使用收到的憑證將AEM Forms與適用於政府的Adobe Acrobat Sign Solutions連線
AEM Formsas a Cloud Service提供開發、預備和生產環境。 您可以開始將的開發環境與適用於政府的Adobe Acrobat Sign Solutions連線,並在稍後連線預備和生產環境。
開始之前 prerequisites-for-adobe-sign-for-acrobat-sign-for-government
開始將AEM Forms與Adobe Acrobat Sign解決方案連線之前,請確定已布建您的Adobe Acrobat Sign Solutions for Government帳戶。
連線適用於政府的AEM Forms as a Cloud Service與Adobe Acrobat Sign Solutions connect-adobe-acrobat-sign-for-government
為您的AEM執行個體建立重新導向URL
- 在Formsas a Cloud Service作者執行個體上,瀏覽至 工具 > 一般 > 設定瀏覽器。
- 在 設定瀏覽器 頁面上,選取 建立。
- 在 建立設定 對話方塊中,指定設定的 標題、啟用 雲端設定,並選取 建立。 這樣便會建立儲存Cloud Service的設定容器。 請確保資料夾名稱未含任何空格。
- 瀏覽至 工具 > Cloud Service > Adobe Acrobat Sign,並開啟您在上一步中建立的設定容器。 建立最適化表單時,請在 設定容器 欄位中指定容器名稱。
- 在設定頁面上,選取「建立」以在AEM Forms中建立Adobe Acrobat Sign設定。
- 將您目前瀏覽器視窗的URL複製到記事本,並從URL中移除
/ui#/aem
。 此URL稱為re-direct URL
。
在下一節中,您會與Adobe Sign團隊共用re-direct URL
和Scopes
,並要求認證(使用者端ID和使用者端密碼)。
與Adobe Sign團隊共用重新導向URL和範圍並接收認證
適用於政府的Adobe Acrobat Sign解決方案團隊需要為您的Adobe Acrobat Sign應用程式(如下所列)啟用re-direct URL
和某些範圍,才能產生認證(使用者端ID和使用者端密碼),讓您將AEM Forms與適用於政府的Adobe Acrobat Sign Solutions連線。
與您的Adobe Acrobat Sign政府解決方案代表(Adobe Professional Services團隊成員)共用scopes
(如下所列),以及建立並記下上一節的最後一步的re-direct URL
。
領域
- aggrement_read
- aggrement_write
- aggrement_send
- widget_read
- widget_write
- workflow_read
- offline_access
代表會產生認證並與您共用。 在下一節中,您會使用認證(使用者端ID和使用者端密碼)來連線AEM Forms和適用於政府的Adobe Acrobat Sign Solutions。
使用收到的認證連線AEM Forms與適用於政府的Adobe Acrobat Sign Solutions
-
在瀏覽器中開啟
re-direct URL
。 您在在您的AEM執行個體區段上建立重新導向URL的最後一步中建立並記下re-direct URL
。 -
在 建立Adobe Sign組態 頁面的 一般 標籤中,指定組態的 名稱,並選取 下一步。 您可以選擇指定 標題 並瀏覽以選取設定的 縮圖。 按一下「下一步」。
-
在 建立Adobe Sign組態 頁面的 設定 標籤中,針對 選取解決方案 選項,選取Adobe Acrobat Sign Solutions for Government。
政府用
-
在 電子郵件 欄位中,指定與您Adobe Acrobat Sign Solutions政府帳戶相關的電子郵件地址。
-
在 設定 索引標籤中,
-
OAuth URL 欄位包含預設URL,其中包含Adobe Sign資料庫分片。 URL 的格式是:
https://<shard>/api/gateway/adobesignauthservice/api/v1/authorize
例如:
https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/authorize
-
存取權杖URL 欄位包含預設URL,其中包含Adobe Sign資料庫分片。 URL 的格式是:
https://<shard>/api/gateway/adobesignauthservice/api/v1/token
例如:
https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/token
其中:
na1 是指預設的資料庫分片。您可以修改資料庫分片的值。確保 Adobe Acrobat Sign Cloud Configurations 指向正確的分片。
note note NOTE - 登入您的Adobe Sign帳戶後,請瀏覽至 Acrobat Sign API > API資訊 > REST API方法檔案 > OAuth存取Token,以存取與Adobe Sign oAuth URL和存取權杖URL相關的資訊。
-
-
在上一節中,將Adobe Acrobat Sign為政府解決方案代表([Adobe Professional Services團隊成員])共用的認證用作[使用者端識別碼 和 使用者端密碼]。
-
選取 為附件啟用Adobe Acrobat Sign 選項,以將最適化表單附加的檔案附加至要簽名的對應Adobe Acrobat Sign檔案。
-
選取 連線至Adobe Sign。 出現認證提示時,請提供在建立 Adobe Acrobat Sign 應用程式時使用的帳戶使用者名稱和密碼。當要求確認
your developer account
的存取時,請按一下 允許存取。 如果認證正確且您允許 AEM Forms 存取您的 Adobe Acrobat Sign 開發人員帳戶,則會出現與以下訊息相似的成功訊息。 -
選取 建立 以建立組態。
-
選取組態並按一下 Publish,選取組態,然後按一下 Publish。 這會將設定復寫至對應的發佈環境。
-
請對您的開發人員、中繼及生產執行個體 (無論是哪個) 重複上述步驟,以完成您環境的設定 Adobe Acrobat Sign Solutions for Government with AEM Forms。
現在,您可以在最適化表單或AEM Workflow中新增Adobe Acrobat Sign欄位。 請確定您將用於Cloud Service設定的設定容器新增到為Adobe Acrobat Sign啟用的所有最適化Forms。 您可從最適化表單的屬性指定設定容器。
設定Adobe Acrobat Sign排程器以同步處理簽署狀態 configure-adobe-sign-scheduler-to-sync-the-signing-status
AEM Formsas a Cloud Service提供排程器服務,可依定義的間隔檢查簽署者的狀態。 設定排程器服務的情境:
- 如果您使用提交表單(在每個收件者完成簽署儀式後)來簽署檔案,則表單只會在所有簽署者簽署表單後提交。
- 如果您使用AEM工作流程🔗中的簽署步驟來簽署檔案,則簽署步驟會等待所有簽署者簽署檔案,再繼續工作流程的下一個步驟。
Adobe Acrobat Sign 排程器服務預設為每 24 小時檢查 (輪詢) 簽名者回應。您可以為您的環境變更預設間隔。
若要變更預設間隔,請為 Adobe Acrobat Sign組態服務 組態的 sign.status.exp 屬性指定cron運算式。
例如,若要在每日午夜12點執行組態服務,請設定 Adobe Acrobat Sign Configuration Service 組態的 sign.status.exp 屬性,以指定0 0 0 1/1 * ? *
。 下列 JSON 檔案會顯示每日在午夜 12 點執行設定服務的範例:
{
"sign.status.exp":"0 0 0 1/1 * ? *"
}
若要設定值,請使用 AEM SDK 產生 OSGi Configurations,並將設定部署至您的 Cloud Service 執行個體。
常見問題
- 問:我是否可以在iframe中轉譯Adobe Sign GovCloud簽章頁面?
- A: 是,您可以在iframe中轉譯Adobe Sign GovCloud簽章頁面。