連線AEM Formsas a Cloud Service與Adobe Acrobat Sign integrate-adobe-sign-with-aem-forms

版本
文章連結
AEM 6.5
按一下這裡
AEM as a Cloud Service
本文章

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整合:

  1. 有效的Adobe Acrobat Sign開發人員帳戶
  2. Adobe Acrobat Sign API應用程式
  3. Adobe Acrobat Sign API 應用程式的認證 (用戶端 ID 和用戶端密碼)。
  4. (僅適用於政府機關身分證件驗證) 為政府機關身分證件驗證啟用驗證方法

連結AEM Forms製作和發佈執行個體與Adobe Acrobat Sign configure-adobe-sign-with-aem-forms

已具備下列先決條件後,請執行以下步驟,以在作者執行個體上設定 Adobe Acrobat Sign 和 AEM Forms。

  1. 在AEM Forms作者執行個體上,瀏覽至​ 工具 hammer > 一般 > 設定瀏覽器

  2. 在​ 設定瀏覽器 ​頁面上,選取​ 建立

  3. 在​ 建立設定 ​對話方塊中,指定設定的​ 標題、啟用​ 雲端設定,並選取​ 建立。 這樣便會建立儲存 Cloud Services 的設定容器。請確保資料夾名稱未含任何空格。

  4. 瀏覽至​ 工具 槌子 > Cloud Service > Adobe Acrobat Sign,並開啟您在上一步中建立的設定容器。

    note note
    NOTE
    建立最適化表單時,請在​ 設定容器 ​欄位中指定容器名稱。
  5. 在設定頁面上,選取「建立」以在AEM Forms中建立Adobe Acrobat Sign設定。

  6. 在​ 建立Adobe Acrobat Sign組態 ​頁面的​ 一般 ​標籤中,指定組態的​ 名稱,並選取​ 下一步。 您可以選擇指定​ 標題 ​並瀏覽以選取設定的​ 縮圖

  7. 現在您可以​ 選取方案 ​以選取Adobe Acrobat Sign。

    Adobe Acrobat Sign Solutions設定

  8. 將您目前瀏覽器視窗中顯示的URL複製到記事本,並從URL移除部分/ui#/aem。 在稍後步驟中,需要修改過的URL才能使用AEM Forms設定Adobe Acrobat Sign應用程式。 選取​ 「下一步」

  9. 在​ 設定 ​索引標籤中,

    • 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相關的資訊。
  10. 設定 Adobe Acrobat Sign 應用程式的 OAuth 設定:

    1. 開啟瀏覽器視窗並登入您的 Adobe Acrobat Sign 開發人員帳戶。

    2. 選取為AEM Forms設定的應用程式,然後選取​ 設定應用程式的OAuth

    3. 在​ 重新導向URL ​方塊中,新增在上一步驟中複製的URL (步驟8),然後按一下​ 儲存

    4. 為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 設定」開發人員文件。

    OAuth Config

  11. 返回​ 建立Adobe Acrobat Sign設定 ​頁面。 在​ 設定 ​索引標籤中,指定[使用者端識別碼 (也稱為應用程式識別碼)和​ 使用者端密碼]。 使用您在上一步建立的Adobe Acrobat Sign應用程式🔗的使用者端ID和使用者端密碼。

  12. 在授權範圍區段中,您可以視需要將前置詞「self」或「account」新增至範圍,將範圍修改為「account」或「self」。
    授權範圍

  13. 選取​ 為附件啟用Adobe Acrobat Sign ​選項,以將最適化表單附加的檔案附加至要簽名的對應Adobe Acrobat Sign檔案。

  14. 選取​ 連線至Adobe Acrobat Sign。 出現認證提示時,請提供建立Adobe Acrobat Sign應用程式時所使用帳戶的​ 使用者名稱 ​和​ 密碼。 當要求確認時,請按一下your developer account的存取權,然後按一下​ 允許存取權。 如果認證正確且您允許 AEM Forms 存取您的 Adobe Acrobat Sign 開發人員帳戶,則會出現與以下訊息相似的成功訊息。

    Adobe Acrobat Sign雲端設定成功

  15. 選取​ 建立 ​以建立Adobe Acrobat Sign組態。

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

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

現在您可以使用新增Adobe Acrobat Sign欄位至最適化表單。 請確保您將用於 Cloud Service 的設定容器新增至 Adobe Acrobat Sign 啟用的所有最適化表單。您可從最適化表單的屬性指定設定容器。

NOTE
若要設定Adobe Sign沙箱,您可以依照Adobe Sign中說明的相同設定步驟操作。

疑難排解 resolve-config-error

當您連線Adobe Acrobat Sign與AEM Forms並尋找錯誤Unable to authorize access because the client configuration is invalid: invalid_request時,如下圖所示。 請依照下列步驟解決此問題:

設定錯誤

  1. 將您目前瀏覽器視窗中顯示的URL複製到記事本,並從URL移除部分/ui#/aem
  2. 開啟瀏覽器視窗並登入您的 Adobe Acrobat Sign 開發人員帳戶。
  3. 選取為AEM Forms設定的應用程式,然後選取​ 設定應用程式的OAuth
  4. 在​ 重新導向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連線

Adobe Sign政府工作流程

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

  1. 在Formsas a Cloud Service作者執行個體上,瀏覽至​ 工具 槌子 > 一般 > 設定瀏覽器
  2. 在​ 設定瀏覽器 ​頁面上,選取​ 建立
  3. 在​ 建立設定 ​對話方塊中,指定設定的​ 標題、啟用​ 雲端設定,並選取​ 建立。 這樣便會建立儲存Cloud Service的設定容器。 請確保資料夾名稱未含任何空格。
  4. 瀏覽至​ 工具 槌子 > Cloud Service > Adobe Acrobat Sign,並開啟您在上一步中建立的設定容器。 建立最適化表單時,請在​ 設定容器 ​欄位中指定容器名稱。
  5. 在設定頁面上,選取「建立」以在AEM Forms中建立Adobe Acrobat Sign設定。
  6. 將您目前瀏覽器視窗的URL複製到記事本,並從URL中移除/ui#/aem。 此URL稱為re-direct URL
    在下一節中,您會與Adobe Sign團隊共用re-direct URLScopes,並要求認證(使用者端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

  1. 在瀏覽器中開啟re-direct URL。 您在在您的AEM執行個體區段上建立重新導向URL的最後一步中建立並記下re-direct URL

  2. 在​ 建立Adobe Sign組態 ​頁面的​ 一般 ​標籤中,指定組態的​ 名稱,並選取​ 下一步。 您可以選擇指定​ 標題 ​並瀏覽以選取設定的​ 縮圖。 按一下「下一步」。

  3. 在​ 建立Adobe Sign組態 ​頁面的​ 設定 ​標籤中,針對​ 選取解決方案 ​選項,選取Adobe Acrobat Sign Solutions for Government。

    政府用 Adobe Acrobat Sign Solutions

  4. 在​ 電子郵件 ​欄位中,指定與您Adobe Acrobat Sign Solutions政府帳戶相關的電子郵件地址。

  5. 在​ 設定 ​索引標籤中,

    • 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相關的資訊。
  6. 在上一節中,將Adobe Acrobat Sign為政府解決方案代表([Adobe Professional Services團隊成員])共用的認證用作[使用者端識別碼 ​和​ 使用者端密碼]。

  7. 選取​ 為附件啟用Adobe Acrobat Sign ​選項,以將最適化表單附加的檔案附加至要簽名的對應Adobe Acrobat Sign檔案。

  8. 選取​ 連線至Adobe Sign。 出現認證提示時,請提供在建立 Adobe Acrobat Sign 應用程式時使用的帳戶使用者名稱和密碼。當要求確認your developer account的存取時,請按一下​ 允許存取。 如果認證正確且您允許 AEM Forms 存取您的 Adobe Acrobat Sign 開發人員帳戶,則會出現與以下訊息相似的成功訊息。

    Adobe Acrobat Sign雲端設定成功

  9. 選取​ 建立 ​以建立組態。

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

  11. 請對您的開發人員、中繼及生產執行個體 (無論是哪個) 重複上述步驟,以完成您環境的設定 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簽章頁面。
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab