使用手冊 取消

適用於 Salesforce 的 Acrobat Sign:疑難排解指南

您是否無法從 Salesforce 傳送合約? 資料對應是否無法更新 Salesforce 欄位?

適用於 Salesforce 的 Adobe Acrobat Sign:疑難排解指南旨在協助您解決各種問題,例如從 Salesforce 傳送合約、資料對應或自動狀態更新。瞭解如何:

疑難排解「資料對應」失敗的問題

在簽署 Acrobat Sign 合約或合約工作流程中的指定階段時,Acrobat Sign 資料對應會更新 Salesforce 物件。每個資料對應都會提前設定,並納入資料對應規則。每個資料對應規則都會定義資料來源和必須更新的目標 Salesforce 欄位。如需詳細資訊,請參閱 Salesforce 資料對應

如果資料對應無法更新 Salesforce 欄位,請執行下列疑難排解步驟來識別與修正問題:

使用資料對應與合併對應傳送合約:範例情境

範例使用者:

John Smith

範例使用案例:

John 想要:

  • 使用合約範本,從名為「示範 1」的自訂物件傳送合約、
  • 從與「示範 1」相關聯的另一個自訂物件「示範 2」提取資訊並推送至合約,以及
  • 在簽署合約後,將資訊推送至「示範 2」物件記錄。 

 達成使用案例的步驟:

  1. 在 Acrobat Sign「合約」物件上,建立「示範 1」物件的查詢欄位。
  2. 在「示範 1」物件上,建立「示範 2」物件的查詢欄位。
    您無法從相關清單提取資訊,或將資訊推送至相關清單。
  3. 建立資料對應範本的方式如下:
    1. 提供唯一的範本名稱。
    2. 在「欄位對應」下方,選取「所選物件」,然後從下拉式選單中選取「示範 1」。
    3. 從載入的第二個下拉式選單中,選取「示範 2 ID」。
    4. 在載入的第三個下拉式選單中,保留為「無」,然後選取「選取」。
    5. 針對「要更新哪個 Salesforce 欄位?」,選擇您需要更新的欄位名稱。 
    6. 若要完成資料對應設定,請依照對應和範本指南中「使用資料對應將簽署者資料和檔案推送至 Salesforce 記錄」一節的步驟操作。
  4. 建立合併對應範本的方式如下:
    1. 提供唯一的範本名稱。
    2. 選取「新增欄位對應」。
    3. 在「來源值」下方,選取「所選物件」,然後從下拉式選單中選取「示範 1」。
    4. 從載入的第二個下拉式選單中,選取「示範 2 ID」。
    5. 從下一個載入的下拉式選單中,選取您需提取值的欄位名稱,然後選取「完成」。
    6. 若要完成合併對應設定,請依照對應和範本指南中「使用合併對應以產生含有 Salesforce 資料的文件」一節的步驟操作。
  5. 依照建立範本工作流程下的步驟建立合約範本。
  6. 在以上建立的合約範本中,確認「資料對應」區段中包含合併對應和資料對應範本。
  7. 在合約範本的「範本詳細資料」區段中,選取 Salesforce 物件做為「示範 1」。
  8. 選取「將資料對應至合約欄位」,然後在顯示的對話框中:
    1. 選取「從物件選取」選項。
    2. 在「來源類型下,選取「示範 1 ID」。
    3. 在「目標合約欄位」下的查詢欄位中,選取「示範 1」物件。
    4. 選取「儲存」。
  9. 在合約範本上,選取「儲存」。
    系統會建立連結至「示範 1」物件的合約範本,並啟用合併對應和資料對應。
  10. 開啟「示範 1」物件記錄,然後選取「 > 編輯頁面」。然後,從左側面板的自訂管理區段,拖放「合約面板」並選取「儲存」。
  11. 選取「啟用」,並根據您的需求指派記錄頁面。為了進行測試,請選擇「以組織預設模式指派」,如此會向所有使用者公開「合約面板」。
  12. 選取「下一步」和「儲存」。
  13. 導覽至「示範 1」物件記錄並重新整理頁面。畫面上應顯示您新增的「合約面板」。
  14. 選取「傳送合約以進行簽署」。畫面上會顯示您建立的合約範本。
  15. 選取合約範本,並依照畫面上的步驟傳送合約。確認合約包含來自「示範 2」的合併資料。 
  16. 簽署合約。其中會顯示以合約值更新的「示範 2」記錄。 

疑難排解從 Salesforce 傳送合約失敗的問題

如果您無法從 Salesforce 傳送合約,請執行下列疑難排解步驟:

  1. 確認您使用支援的 Adobe Acrobat Sign 版本。請參閱支援的版本

  2. 確認您擁有傳送者所需的權限。
    請參閱如何授予使用者必要的存取權限。 除了指南中提及的物件和欄位外,傳送者還必須能存取工作流程中使用的其他 Salesforce 物件。

  3. 檢查 Salesforce 中的「合約」物件或其他 Acrobat Sign 物件是否有自訂項目,例如觸發條件、工作流程或規則。如果是,請停用所有自訂項目並傳送測試合約,查看是否傳送成功。
    如果停用自訂項目後成功傳送合約,請參閱開發人員指南以取得準則。

    註解:

    我們不支援疑難排解自訂項目的問題。

  4. 使用下列其中一種方法,找出您在傳送合約時收到的錯誤類型:

    • 在 Salesforce 中開啟受影響的合約記錄,並檢查含有錯誤訊息的紅色橫幅。此錯誤應指出根本原因。
    • 檢查「合約通知」物件上的「錯誤訊息」欄位。
    • 若要透過 Developer Console 檢查並執行下列 SOQL 查詢:

    Select echosign_dev1__Error_Message__c from

    echosign_dev1__Agreement_Notification__c where

    echosign_dev1__Agreement__c = ‘<輸入合約 ID>

  5. 請參閱以下表格的錯誤與解決步驟:

    錯誤

    解決方法

    在 x-api-user 標頭中提供無效的使用者 ID 或電子郵件

    您沒有有效的 Adobe Acrobat Sign 使用者帳戶

    這些錯誤表示傳送者沒有有效的 Acrobat Sign 授權。若要進行疑難排解:

    1. 檢查合約記錄上的「記錄的傳送者」欄位,找出合約的傳送者。
      如果在 Salesforce 中的「記錄的傳送者」欄位找不到使用者,Acrobat Sign 套件會使用「建立者」欄位做為合約的「傳送者」。
    2. 瀏覽至 Salesforce 中傳送者的「使用者詳細資料」頁面,並確認「電子郵件」欄位含有有效的電子郵件地址和作用中的 Sign 企業版授權。若要檢查電子郵件地址是否具有作用中的 Sign 企業版授權。
      1. 使用管理員認證登入 Acrobat Sign
      2. 導覽至「帳戶 > 使用者」,然後查詢電子郵件地址。
      3. 使用者的狀態應為作用中。不是「作用中」狀態的使用者無法傳送合約。如果使用者狀態不是作用中,請深入了解如何新增及管理使用者,並參閱「電子郵件正在使用中,但使用者的狀態不是作用中」一節下的步驟。
      4. 若使用「代表傳送」(SOB),請檢查「合約」物件上「代表傳送」的欄位,驗證電子郵件地址。登入 Acrobat Sign,確認此使用者的電子郵件地址含有效的 Sign 授權。確認 SOB 使用者在「使用者詳細資料」頁面上的「允許以其他使用者身分傳送」欄位已啟用。依預設,此欄位可能不會顯示在「使用者物件」頁面版面上。
    3. 按照上述的步驟 2 確認使用者權限。請參閱如何授予使用者必要的存取權限

    檔案格式未支援

    當您嘗試傳送以供簽署的文件格式不受支援,就會發生此錯誤。

    請參閱 Acrobat Sign 的系統需求中的支援的文件格式一節,以查看支援上傳至 Acrobat Sign 的檔案格式為何。

    簽名按鈕中使用不正確的物件 ID

     當「代表傳送」按鈕的範本 ID 或物件的主要 ID 無效時,就會發生此錯誤。

    我們建議您輸入正確的物件 ID,然後重試程序。

疑難排解自動狀態更新失敗的問題

如果合約未以正確狀態更新,請執行下列疑難排解步驟:

  1. 確認您已執行適用於 Salesforce 的 Adobe Acrobat Sign:安裝指南中提及的必要條件和後續安裝設定 (必要)。

  2. 在 Salesforce Lightning 頁面上,前往「Adobe Acrobat Sign 管理員 > 啟用自動狀態更新」,確定您看到「已為此組織啟用自動狀態更新」的訊息。

    salesforce-faq-status-update-enabled

    如果您沒有看到訊息,請執行下列步驟:

    1. 登出並以系統管理員身分再次登入。
    2. 前往「Adobe Acrobat Sign 管理員 > 啟用自動狀態更新」,然後選取「啟用」。
    3. 在顯示的「允許存取 Acrobat Sign」對話框中:
      1. 記下對話框底部的電子郵件地址。
      2. 確認此電子郵件地址含有效的 Sign 授權,而且是 Salesforce 系統管理員。
      3. 確認使用者已指派「Adobe Sign 整合使用者」權限集合。 
      4. 選取「允許」。

    畫面上應該會顯示以下訊息:「已為此組織啟用自動狀態更新」。

  3. 檢查「合約通知」物件的「錯誤訊息」欄位。若要檢查欄位上的值,請在 Developer Console 上執行以下 SOQL 查詢:

    SELECT Id, echosign_dev1__Agreement_Event_Type__c, echosign_dev1__Agreement_Status__c, echosign_dev1__Document_Key__c, echosign_dev1__Error_Message__c, echosign_dev1__Notification_Type__c, echosign_dev1__Status__c FROM echosign_dev1__Agreement_Notification__c where echosign_dev1__Agreement__c='<agreementId>'

  4. 如果是在 Salesforce 環境之外建立的推送合約,請務必遵循適用於 Salesforce 的 Adobe Acrobat Sign:大型文件與推送合約服務指南

  5. 前往「設定 > 自訂設定 > Adobe Sign 合約更新設定 > 管理 > 新增 (或編輯)」。在開啟的頁面中,確認已啟用「更新合約狀態」核取方塊 (位於「預設組織層級值」下)。

  6. 前往「合約」標籤,選取所有無法更新的合約,然後從右上角選取「更新合約」。

    salesforce-faq-update-agreement

  7. 檢查這些合約的狀態是否已更新。如果現在已更新,請用新的測試合約檢查問題是否仍可重現。如果可重現,請繼續進行下列疑難排解步驟。

    如果問題未重現,則可能是一次性的問題,我們建議您在問題再次發生時,參考此疑難排解指南。 

  8. 檢查 Salesforce 中的「合約」物件或其他 Acrobat Sign 物件是否有自訂項目,例如觸發條件、工作流程或規則。

    如果是,請停用所有自訂項目並按照往常的步驟傳送測試合約,看看是否傳送成功。狀態應從「草稿」變更至「傳出進行簽名」。

    如果在停用自訂項目後,合約狀態變更至「傳出進行簽名」,請參閱開發人員指南以取得準則。

    如果狀態未更新,請直接從「合約」標籤傳送已停用自訂項目的測試合約,並檢查是否傳送成功。如果狀態仍未改變,請查看上述步驟 1 和 2。

    註解:

    我們不支援疑難排解自訂項目的問題。

    Acrobat Sign 物件
    新增檔案附件 檔案對應 將資料對應至合約欄位
    新增表單欄位範本 表單欄位匯入 合併對應
    新增收件者 表單欄位子對應 Mutex
    合約 表單欄位子對應項目 物件對應
    合約事件 表格欄位對應 收件者
    合約範本 表單欄位對應項目 已簽署的合約
    資料對應 群組對應 觸發
    欄位對應 元件庫範本 使用者同步結果
    合約類型    

對啟用「增強」網域後可能出現的問題進行疑難排解

現在,所有組織均預設啟用 Salesforce 的「增強」網域,這不會影響適用於 Salesforce 的 Adobe Acrobat Sign 套件。 但是,為大檔案下載和推送協定配置其站點的客戶在啟用其增強域時會遇到問題,從而導致站點URL更改和協定中斷。

為確保合約順利運行,客戶需要更新針對大型檔案下載的自訂設定,以反映更新的網站 URL。

如要更新推送合約回呼 URL,客戶必須連絡支援人員並提供所需資訊。如需詳細資訊,請參閱取得您所設定之 Acrobat Sign 帳戶的個人服務

對搜尋政府雲端環境之商機的問題進行疑難排解

選取「商機」作為收件者類型時,適用於 Salesforce 的 Acrobat Sign 可讓您搜尋銷售機會,並將其新增為合約收件者。然而,如果政府雲端使用者建立商機、聯絡人或使用者,但無法使用「搜尋」欄位找到這些項目,Saleforce 組織管理員可依下列解決步驟操作:

  1. 前往「設定 > 物件管理員」,然後搜尋「商機」。
  2. 從左側面板選取「欄位和關係」。
  3. 針對所有必填欄位 (例如「名稱」、「電子郵件」、「行動裝置」等),勾選使用者的可存取性。若要這麼做:
    1. 選取您要勾選的任何欄位。例如,選取「行動裝置」。
    2. 針對您要啟用欄位存取權的所有使用者,選取顯示核取方塊。
    3. 選取「儲存」。
在政府雲端上從適用於 Salesforce 的 Acrobat Sign 將合約傳送給您的商機。

在政府雲端上從適用於 Salesforce 的 Acrobat Sign 將合約傳送給您的商機。

連絡支援人員

如果執行上述疑難排解步驟後,問題仍未解決,請連絡支援人員並提供我們下列詳細資料:

  • 問題描述
  • 用於設定整合的 Acrobat Sign 帳戶管理員電子郵件地址
  • 用於啟用自動狀態更新的 Acrobat Sign 帳戶管理員電子郵件地址:
  • 安裝在 Salesforce 中的 Acrobat Sign 套件版本
  • Salesforce 組織 ID
  • 受影響合約的 Salesforce 記錄 ID
  • 受影響使用者的電子郵件地址
  • 問題是可持續重現、不時出現,或僅發生一次?
  • 上次發生日期:<請提供已知的上次發生日期/時間/時區>
  • 重現問題的步驟
  • 預期行為:<請說明您在執行步驟時預期發生的行為>
  • 疑難排解備註:<請提供至今為止您使用這份文件採取的疑難排解方法詳情>

更快、更輕鬆地獲得協助

新的使用者?