在 Salesforce Lightning 頁面上，導覽至「Adobe Acrobat Sign 管理員」標籤。
上次更新時間
2024年10月16日
您是否無法從 Salesforce 傳送合約? 資料對應是否無法更新 Salesforce 欄位?
適用於 Salesforce 的 Adobe Acrobat Sign：疑難排解指南旨在協助您解決各種問題，例如從 Salesforce 傳送合約、資料對應或自動狀態更新。 瞭解如何：
在簽署 Acrobat Sign 合約或合約工作流程中的指定階段時，Acrobat Sign 資料對應會更新 Salesforce 物件。 每個資料對應都會提前設定，並納入資料對應規則。 每個資料對應規則都會定義資料來源和必須更新的目標 Salesforce 欄位。 如需詳細資訊，請參閱 Salesforce 資料對應。
如果資料對應無法更新 Salesforce 欄位，請執行下列疑難排解步驟來識別與修正問題：
請這麼做：
確認自動狀態更新使用者 (通常是您用來設定整合的 Sign 帳戶管理員)，而且寄件者可以存取您嘗試以資料對應更新的物件。
若要檢查欄位的值，您可以將欄位新增至「合約」清單檢視、使用 Developer Console，或使用工作台。
資料對應錯誤欄位會儲存資料對應的錯誤。 若要檢查欄位的值，您可以將欄位新增至「合約」清單檢視、使用 Developer Console，或使用工作台。 以下列出常見錯誤與對應的解決步驟：
| 錯誤 | 無法對應資料欄位：System.DmlException 更新失敗。 第 0 列有第一個例外狀況，ID 為 00ZxxqwertasdmjVUAR；第一個錯誤：STRING_TOO_LONG，所有者名稱：資料值太大：Adobe Acrobat Sign Adobe inc (長度上限 = 20)：[Owner_Title__c] (echosign_dev1) 165 |
解析度： 此錯誤代表已更新文件表單欄位中的資料，超過您嘗試更新的 Salesforce 欄位大小限制。 解決方法為：
|
|
| 錯誤 |
嘗試對應至未在合約上設定的相關物件參照：「<您嘗試更新的 Salesforce 物件欄位 API 名稱>」 |
解析度： 此錯誤代表「合約」物件與您嘗試更新的 Salesforce 物件之間未建立連結。 請參閱上述「步驟4」。 |
|
| 錯誤 |
無法對應資料欄位：System.NullPointerException 嘗試將取消參照空物件 (echosign_dev1) 656 |
解析度 此錯誤表示資料對應失敗，因為無法存取所需物件。 請嘗試操作以下步驟來解決錯誤：
|
範例使用者：
John Smith
範例使用案例：
John 想要：
- 使用合約範本，從名為「示範 1」的自訂物件傳送合約、
- 從與「示範 1」相關聯的另一個自訂物件「示範 2」提取資訊並推送至合約，以及
- 在簽署合約後，將資訊推送至「示範 2」物件記錄。
達成使用案例的步驟：
- 在 Acrobat Sign「合約」物件上，建立「示範 1」物件的查詢欄位。
- 在「Demo 1」物件上，為「Demo 2」物件建立查閱欄位。
您無法從相關清單提取或推播資訊。 - 建立資料對應範本的方式如下：
- 提供唯一的範本名稱。
- 在「欄位對應」下方，選取「所選物件」，然後從下拉式選單中選取「示範 1」。
- 從載入的第二個下拉式選單中，選取「示範 2 ID」。
- 在載入的第三個下拉式選單中，保留為「無」，然後選取「選取」。
- 針對「要更新哪個 Salesforce 欄位?」，選擇您需要更新的欄位名稱。
- 若要完成資料對應設定，請依照對應和範本指南中「使用資料對應將簽署者資料和檔案推送至 Salesforce 記錄」一節的步驟操作。
- 建立合併對應範本的方式如下：
- 提供唯一的範本名稱。
- 選取「新增欄位對應」。
- 在「來源值」下方，選取「所選物件」，然後從下拉式選單中選取「示範 1」。
- 從載入的第二個下拉式選單中，選取「示範 2 ID」。
- 從下一個載入的下拉式選單中，選取您需提取值的欄位名稱，然後選取「完成」。
- 若要完成合併對應設定，請依照對應和範本指南中「使用合併對應以產生含有 Salesforce 資料的文件」一節的步驟操作。
- 依照建立範本工作流程下的步驟建立合約範本。
- 在以上建立的合約範本中，確認「資料對應」區段中包含合併對應和資料對應範本。
- 在合約範本的「範本詳細資料」區段中，選取 Salesforce 物件做為「示範 1」。
- 選取「將資料對應至合約欄位」，然後在顯示的對話框中：
- 選取「從物件選取」選項。
- 在「來源類型下，選取「示範 1 ID」。
- 在「目標合約欄位」下的查詢欄位中，選取「示範 1」物件。
- 選取「儲存」。
- 在協議範本上，選取「儲存」。
它會建立一個連結到「Demo 1」物件的協議範本，並啟用合併對應和資料對應。 - 開啟「示範 1」物件記錄，然後選取「
> 編輯頁面」。 然後，從左側面板的自訂管理區段，拖放「合約面板」並選取「儲存」。 - 選取「啟用」，並根據您的需求指派記錄頁面。 為了進行測試，請選擇「以組織預設模式指派」，如此會向所有使用者公開「合約面板」。
- 選取「下一步」和「儲存」。
- 導覽至「示範 1」物件記錄並重新整理頁面。 畫面上應顯示您新增的「合約面板」。
- 選取「傳送合約以進行簽署」。 畫面上會顯示您建立的合約範本。
- 選取合約範本，並依照畫面上的步驟傳送合約。 確認合約包含來自「示範 2」的合併資料。
- 簽署合約。 其中會顯示以合約值更新的「示範 2」記錄。
如果您無法從 Salesforce 傳送合約，請執行下列疑難排解步驟：
確認您使用支援的 Adobe Acrobat Sign 版本。 請參閱支援的版本。
確保您作為寄件者具有必要的權限。
請參閱如何授予使用者必要的存取權限 除了指南中提及的物件和欄位外，傳送者還必須能存取工作流程中使用的其他 Salesforce 物件。
檢查 Salesforce 中的「合約」物件或其他 Acrobat Sign 物件是否有自訂項目，例如觸發條件、工作流程或規則。 如果是，請停用所有自訂並傳送測試協議，查看是否能夠成功。
如果在停用自訂後協議成功傳送，請參考我們的開發人員指南以取得準則。
備註
我們不支援疑難排解自訂項目的問題。
請參閱以下表格的錯誤與解決步驟：
|
錯誤 |
解決方法 |
|---|---|
|
在 x-api-user 標頭中提供無效的使用者 ID 或電子郵件 您沒有有效的 Adobe Acrobat Sign 使用者帳戶 |
這些錯誤表示傳送者沒有有效的 Acrobat Sign 授權。 若要進行疑難排解：
|
|
檔案格式未支援 |
當您嘗試傳送以供簽署的文件格式不受支援，就會發生此錯誤。 請參閱 Acrobat Sign 的系統需求中的支援的文件格式一節，以查看支援上傳至 Acrobat Sign 的檔案格式為何。 |
|
簽名按鈕中使用不正確的物件 ID |
當「代表傳送」按鈕的範本 ID 或物件的主要 ID 無效時，就會發生此錯誤。 我們建議您輸入正確的物件 ID，然後重試程序。 |
如果合約未以正確狀態更新，請執行下列疑難排解步驟：
確認您已執行適用於 Salesforce 的 Adobe Acrobat Sign：安裝指南中提及的必要條件和後續安裝設定 (必要)。
如果您沒有看到訊息，請執行下列步驟：
- 登出並以系統管理員身分再次登入。
- 前往「Adobe Acrobat Sign 管理員 > 啟用自動狀態更新」，然後選取「啟用」。
- 在顯示的「允許存取 Acrobat Sign」對話框中：
- 記下對話框底部的電子郵件地址。
- 確認此電子郵件地址含有效的 Sign 授權，而且是 Salesforce 系統管理員。
- 確認使用者已指派「Adobe Sign 整合使用者」權限集合。
- 選取「允許」。
畫面上應該會顯示以下訊息：「已為此組織啟用自動狀態更新」。
檢查「合約通知」物件的「錯誤訊息」欄位。 若要檢查欄位上的值，請在 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>'
如果是在 Salesforce 環境之外建立的推送合約，請務必遵循適用於 Salesforce 的 Adobe Acrobat Sign：大型文件與推送合約服務指南。
檢查 Salesforce 中的「合約」物件或其他 Acrobat Sign 物件是否有自訂項目，例如觸發條件、工作流程或規則。
如果是，請停用所有自訂項目並按照往常的步驟傳送測試合約，看看是否傳送成功。 狀態應從「草稿」變更至「傳出進行簽名」。
如果在停用自訂項目後，合約狀態變更至「傳出進行簽名」，請參閱開發人員指南以取得準則。
如果狀態未更新，請直接從「合約」標籤傳送已停用自訂項目的測試合約，並檢查是否傳送成功。 如果狀態仍未改變，請查看上述步驟 1 和 2。
備註
我們不支援疑難排解自訂項目的問題。
| Acrobat Sign 物件 | ||
|---|---|---|
| 新增檔案附件 | 檔案對應 | 將資料對應至合約欄位 |
| 新增表單欄位範本 | 表單欄位匯入 | 合併對應 |
| 新增收件者 | 表單欄位子對應 | Mutex |
| 合約 | 表單欄位子對應項目 | 物件對應 |
| 合約事件 | 表格欄位對應 | 收件者 |
| 合約範本 | 表單欄位對應項目 | 已簽署的合約 |
| 資料對應 | 群組對應 | 觸發 |
| 欄位對應 | 元件庫範本 | 使用者同步結果 |
| 合約類型 | ||
現在，所有組織均預設啟用 Salesforce 的「增強」網域，這不會影響適用於 Salesforce 的 Adobe Acrobat Sign 套件。 但是，為大檔案下載和推送協定配置其站點的客戶在啟用其增強域時會遇到問題，從而導致站點URL更改和協定中斷。
為確保合約順利運行，客戶需要更新針對大型檔案下載的自訂設定，以反映更新的網站 URL。
如要更新推送合約回呼 URL，客戶必須連絡支援人員並提供所需資訊。 如需詳細資訊，請參閱取得您所設定之 Acrobat Sign 帳戶的個人服務。
選取「商機」作為收件者類型時，適用於 Salesforce 的 Acrobat Sign 可讓您搜尋銷售機會，並將其新增為合約收件者。 然而，如果政府雲端使用者建立商機、聯絡人或使用者，但無法使用「搜尋」欄位找到這些項目，Saleforce 組織管理員可依下列解決步驟操作：
- 前往「設定 > 物件管理員」，然後搜尋「商機」。
- 從左側面板選取「欄位和關係」。
- 針對所有必填欄位 (例如「名稱」、「電子郵件」、「行動裝置」等)，勾選使用者的可存取性。 若要這麼做：
- 選取您要勾選的任何欄位。 例如，選取「行動裝置」。
- 針對您要啟用欄位存取權的所有使用者，選取「顯示」核取方塊。
- 選取「儲存」。
如果執行上述疑難排解步驟後，問題仍未解決，請連絡支援人員並提供我們下列詳細資料：
- 問題描述
- 用於設定整合的 Acrobat Sign 帳戶管理員電子郵件地址
- 用於啟用自動狀態更新的 Acrobat Sign 帳戶管理員電子郵件地址：
- 安裝在 Salesforce 中的 Acrobat Sign 套件版本
- Salesforce 組織 ID
- 受影響合約的 Salesforce 記錄 ID
- 受影響使用者的電子郵件地址
- 問題是可持續重現、不時出現，或僅發生一次?
- 上次發生日期：<請提供已知的上次發生日期/時間/時區>
- 重現問題的步驟
- 預期行為：<請說明您在執行步驟時預期發生的行為>
- 疑難排解備註：<請提供至今為止您使用這份文件採取的疑難排解方法詳情>
