請前往 Salesforce AppExchange,找到最新版的適用於 Salesforce 的 Adobe Acrobat Sign 套件,然後選取「立即取得」。
- Adobe Acrobat Sign 整合
- 新增功能
- 產品版本與生命週期
- 適用於 Salesforce 的 Acrobat Sign
- 適用於 Microsoft 的 Acrobat Sign
- 適用於 Microsoft 365 的 Acrobat Sign
- 適用於 Outlook 的 Acrobat Sign
- 適用於 Word/PowerPoint 的 Acrobat Sign
- 適用於 Teams 的 Acrobat Sign
- 適用於 Microsoft PowerApps 和 Power Automate 的 Acrobat Sign
- 適用於 Microsoft Search 的 Acrobat Sign 連接器
- 適用於 Microsoft Dynamics 的 Acrobat Sign
- 適用於 Microsoft SharePoint 的 Acrobat Sign
- 適用於 Microsoft 365 的 Acrobat Sign
- 適用於 ServiceNow 的 Acrobat Sign
- 適用於 HR ServiceNow 的 Acrobat Sign
- 適用於 SAP SuccessFactors 的 Acrobat Sign
- 適用於 Workday 的 Acrobat Sign
- 適用於 NetSuite 的 Acrobat Sign
- 適用於 SugarCRM 的 Acrobat Sign
- 適用於 VeevaVault 的 Acrobat Sign
- 適用於 Coupa BSM Suite 的 Acrobat Sign
- 適用於 Zapier 的 Acrobat Sign
- Acrobat Sign 開發人員文件
概述
適用於 Salesforce 的 Adobe Acrobat Sign:升級指南提供如何將適用於 Salesforce 的 Adobe Acrobat Sign 套件從舊版升級至最新版本的說明。
Adobe 需要您將適用於 Salesforce 的 Adobe Acrobat Sign 升級至最新版本,因為:
- 適用於 Salesforce 的 Adobe Acrobat Sign 每一版都會推出大幅改善文件工作流程的新功能和增強功能。
- 適用於 Salesforce 的 Adobe Acrobat Sign 只對最新版本 (N) 和最新版本之前的兩個主要版本 (N-1 和 N-2) 提供支援。不支援的版本具有較高的安全性風險,且會無法存取 Adobe Acrobat Sign 服務的 API。
重要升級注意事項
- 請勿解除安裝現有適用於 Salesforce 的 Adobe Acrobat Sign 套件,因為這可能會造成 Salesforce 中的 Acrobat Sign 資料遺失。
- 如果您的 Salesforce 組織中有使用者隸屬於多個 Acrobat Sign 帳戶,請先聯絡 Adobe 客戶成功經理或 Adobe 客戶服務,再開始升級。
- 在升級生產帳戶之前,您必須先在沙箱環境中升級和測試。
如果您必須變更 Acrobat Sign 帳戶的電子郵件,請務必在沙箱環境中使用您能順利存取的電子郵件地址。 - 確認「將工作階段鎖定至來源 IP 位址」設定已停用。若要設定,請前往「設定 > 設定 > 安全性 > 工作階段設定」。
- 查看下方的「新增功能」區段,確認是否有需要手動設定的選項。
每個版本都有許多新的功能和設定,可能需要手動更新。 - 若要瞭解適用於 Salesforce 的 Adobe Acrobat Sign 的最新功能,請參閱 適用於 Salesforce 的 Adobe Acrobat Sign:版本注意事項。
- 若您要安裝套件的新執行個體,請參閱適用於 Salesforce 的 Adobe Acrobat Sign:安裝指南。
- 從第 24.14 版開始,適用於 Salesforce 的 Adobe Acrobat Sign 將不支援 SOAP API 式推送模型來觸發自動狀態更新。自動合約狀態更新只會使用 REST API 式提取模型來觸發。
如果您已安裝適用於 Salesforce 的 Adobe Acrobat Sign 套件 20.x 版或更舊版本,請在沙箱組織中測試升級。如果合約狀態無法升級,請前往「適用於 Salesforce 的 Adobe Acrobat Sign」頁面上的「管理」標籤,然後重新執行「啟用自動狀態更新」。 - 升級至 適用於 Salesforce 的 Adobe Acrobat Sign 第 24.14 版的使用者,需要手動新增新的挑選清單值,以設定合約中的提醒。然而,依預設,新的挑選清單值適用於已全新安裝套件第 24.14 版的使用者。
確認目前版本
升級前,請先找出目前安裝的套件版本:
- 以管理員認證登入 Salesforce。
- 導覽至「設定 > 平台工具 > 應用程式 > 套件 > 已安裝的套件」,然後檢查 Adobe Acrobat Sign 套件的版本編號。
更新套件
-
-
選取「登入 AppExchange」,然後輸入認證資訊以繼續執行。
-
在顯示的對話框中:
- 選取「在生產環境安裝」,將套件安裝於生產環境中。
- 選取「在沙箱中安裝」,將套件安裝於沙箱環境中。
建議您先在沙箱環境中測試每一項安裝。
-
請檢閱安裝資訊和條款與條件,確認您已閱讀內容並同意條件,然後再選取「確認並安裝!」
-
在系統提示登入您的 Salesforce 組織時,輸入您的使用者認證,然後選取「登入 Salesforce」。
-
在顯示的「升級 Adobe Acrobat Sign」頁面上,選取「為所有使用者安裝 」,然後選取「升級」。
注意:安裝可能需要幾分鐘的時間。
-
如果出現「核准第三方存取」對話框:
- 請勾選「是,授予存取權給這些第三方網站」。
- 選取「繼續」即可開始安裝。
-
在安裝可能需要一些時間的訊息上,請選取「完成」,並等候接收通知您套件已成功安裝的電子郵件。
收到確認電子郵件後,「已安裝的套件」頁面會顯示目前的套件版本。
若要設定您的新套件,請參閱「後續安裝設定」。
設定已更新的套件
您必須重新整理 Adobe Acrobat Sign 與 Salesforce 之間的 OAuth 連線。
適用於 Salesforce 的 Adobe Acrobat Sign 物件可能會隨著套件演進而有所變更,因此您必須驗證工作流程。如果您建置的自訂解決方案相依於這些有所變更的物件,那麼您可能會需要更新您的自訂內容。
-
瀏覽至「設定 > 平台工具 > 應用程式 > 套件 > 已安裝的套件」。
-
若為 Adobe Acrobat Sign 套件,請選取「設定」。
這會啟動「適用於 Salesforce 的 Adobe Acrobat Sign 設定精靈」。
注意:如果設定精靈未自動啟動,請導覽至「Adobe Acrobat Sign 管理員」標籤,然後選取「啟動設定精靈」。
-
在設定精靈的「步驟 1:將您的 Adobe 帳戶連結至 Salesforce」中:
- 選取「登入 Adobe」。
- 使用管理員認證登入「Adobe Acrobat Sign」。
- 出現提示時,選取「允許存取」。
此時會顯示「成功!您已成功授權您的 Adobe 帳戶」訊息。
-
在成功的「步驟 1」通知上,選取「下一步」。
-
在「步驟 2:啟用 Adobe Sign 自動狀態更新」:
- 選取「啟用」。
- 當系統詢問您是否允許存取 Adobe Acrobat Sign 時,請選取「允許」。
此時會顯示「成功!您已成功啟用帳戶的自動狀態更新功能」訊息。
-
選取「下一步」。
-
當設定精靈顯示「恭喜!您的設定已完成」訊息時,請選取「完成」。
-
視需要,設定「新增功能」區段中列出的所有手動更新。
完成新套件的安裝和設定作業後,請參閱適用於 Salesforce 的 Acrobat Sign:升級指南中的適當區段,了解先前的版本新增設定和欄位的相關資訊。
手動啟用組織中這些新設定和欄位值,新套件才能正確運作。例如,如果您要從第 19 版升級至第 23 版,則應啟用第 20 版、第 21 版和第 22 版所列出的任何手動編輯。
新增功能
套件 24.26 版
新增「電子郵件 OTP」挑選清單值
若是從 24.26 版升級的行動版使用者,依預設並未啟用「電子郵件 OTP」選項。您必須以下列方式手動啟用:
- 前往「設定 > 物件管理員 > 收件者 > 欄位和關係 > 簽署者驗證方法」。
- 向下捲動至「值」區段,然後選取「新增」。
- 輸入「電子郵件 OTP」。
- 選取「儲存」。
套件 24.14 版
- 適用於 Salesforce 的 Adobe Acrobat Sign 第 24.14 版包含新的挑選清單值 (如下圖所示),可在「合約範本」和「合約」中設定提醒。
升級至套件24.14版時,Salesforce管理員必須手動將下列選擇清單值新增至「協定範本」的「自動提醒」自訂欄位,以及「協定」中的「提醒收件者簽署」自訂欄位:- 每個工作天,直到簽署為止
- 每隔一天,直到簽署為止
- 每三天,直到簽署為止
- 每五天,直到簽署為止
- 若要啟用 Acrobat Sign 驗證方法,Salesforce 管理員必須將新的「Acrobat Sign」挑選清單值新增至收件者 (API 名稱 echosign_dev1SIGN_Recipients_c) 物件中的「簽署者驗證方法」(API 名稱 echosign_dev1_Signer_Verification_Methodc) 欄位。
- 第 24.14 版支援收件者名稱鎖定功能,可強制所有合約使用 KBA 驗證收件者名稱。若要成功實作需要 KBA 名稱的設定,管理員必須將新的挑選清單值「Acrobat Sign 驗證」新增至「合約」與「合約範本」物件中的「內部簽署者驗證方法」,如下所示。
- 從第 24.14 版開始,適用於 Salesforce 的 Adobe Acrobat Sign 將不支援 SOAP API 式推送模型來觸發自動狀態更新。自動合約狀態更新現在只會因使用 REST API 式提取模型而觸發。
套件 23.x 版
推出此功能是為了讓 Adobe Sign 收集使用資料來改良產品。此資料僅適用於開發階段,而非行銷用途。
管理員可在「Adobe Sign 管理員」標籤或藉由執行設定精靈,以啟用或停用此功能。
從適用於 Salesforce 的 Adobe Sign 套件第 23 版開始,檔案文件儲存物件將成為開發時使用的主要物件。
從第 23.0 版或更舊版本升級的客戶會將現有的預設儲存類型排除在升級 (通常為附件) 之外,以確保程序不中斷。
管理員應評估文件儲存類型變更為檔案的影響,以充分利用未來的功能。
為了支援管理員控制文件儲存類型,「自訂設定 > Adobe Sign 設定」控制項集新增了一個控制項。
此使用者介面對應至自訂物件:Agreement_Document_Storage_Type__c
可行的設定值為:
- {空} - 如果值是空的,則預設行為取決於套件的安裝版本
- 第 23.0 版或更新版本預設以檔案為預設儲存類型
- 第23.0版或更早版本預設以附件為預設儲存類型
- 檔案 - 將檔案強制定義為 Adobe Sign 文件的預設儲存物件
- 附件 - 將附件強制定義為 Adobe Sign 文件的預設儲存物件
套件 22.x 版
若要啟用將「工作流程」導入 Salesforce 套件的作業,需先額外啟用存取權限。
如果您要使用工作流程,則必須重新整理 OAuth 連結。
不需手動設定或變更系統。
套件 21.5.11 版
為 21.5.9 版之前所有版本的必要安裝套件
若要從第 21.5.9 版或更早版本升級,必須先安裝 21.5.11 版套件。
安裝 v21.5.11 後,才可安裝最新套件。
若要從第 21.5.9 版或更早版本升級,必須先安裝 21.5.11 版套件。安裝 21.5.9 版或更新版本之後,才可安裝最新套件。
須啟用 Chatter 才能安裝 v21.5.11 套件。
開始升級前,請確認您已啟用 Chatter:
- 導覽至「設定 > 平台工具 > 功能設定 > Chatter > Chatter 設定」。
- 如果 Chatter 為停用,請選取「編輯」。
- 選取「啟用」核取方塊。
- 選取「儲存」。
套件 21.x 版
21.x 版針對適用於 Salesforce 的 Adobe Sign 的操作方式導入了數項變更。
強烈建議您先將 21.x 版安裝在沙箱環境中,以確認安裝後各方面的操作方式都能符合您的預期。
開發人員應負責審視更新順序的變更,以及 Apex 方法的變更情形。
自 21.0 版起,SIGN_Signed_Agreement__c 物件 (標籤名稱:已簽署的合約) 即已汰除。
想要取得已簽署合約 URL 的客戶,應使用 REST API 合約呼叫 GET /agreements/{agreementId}/combinedDocument/url
注意:此 API 呼叫傳回的 URL 會受到保護,且存留時間有限。
以下是合約及其相關物件更新的新序列 (自 21.0 版起):
- 附件
- 收件者
- 合約 (狀態和它的其他屬性)
- 合約事件
- Chatter 摘要
從 21.x 版開始,所有非同步程序 (包括自動更新和資料對應) 都已從未來方法切換為可排入佇列 (Salesforce 建議使用的新方法)。
由於此變更的緣故,訂閱者組織在自動更新和/或資料對應的過程中,將工作新增至 Salesforce 佇列的任何自訂作業都會失敗,並顯示錯誤訊息「System.LimitException: 將太多可排入佇列的工作新增至佇列: 2」
之所以發生此情況,是因為可排入佇列的程序只能新增一個可排入佇列的子工作,但此配額已由 Adobe Sign 所使用 (請參閱此處的「可排入佇列的 Apex 限制」一節)。
「將工作鏈結時,您只能透過 System.enqueueJob 從執行中的工作新增一個工作,換句話說,每個可排入佇列的父工作只能有一個子工作。不支援從同一個可排入佇列的工作啟動多個子工作。」
此錯誤的徵狀是合約狀態未變更,以及/或資料對應作業未正確執行。
若要解決此錯誤,請尋找違規的觸發器、程序產生器或工作流程並加以停用,或將其切換為使用同步呼叫,或排程於未來時間執行,例如在 1 小時後執行。
- 合約狀態現已在文件和收件者更新之後更新。
對於第 21 版或更早版本,狀態如同以前的設定。
- 儲存影像 URL 的「簽署合約」物件現在不會插入。
針對第 21 版,該物件會在其他所有更新完成之後插入。 - 對於非同步 Apex,標註請求或回應的最大大小限制為 12MB,如同各個 Salesforce 管理員的限制:https://developer.salesforce.com/docs/atlas.en-us.210.0.apexcode.meta/apexcode/apex_gov_limits.htm
由於上述限制,所以大於 12MB 的文件無法從 Sign 取回。
- 合約事件說明現在符合 Sign API 所傳回的說明,並且具有稽核報告。
- 更新程序現在會以 Salesforce 內原生 Apex 批次程序 (它是非同步程序) 的形式執行。
先前,這是使用 Salesforce 外部的 API 呼叫進行的更新。因為 Salesforce 限制了從已在執行中的非同步程序呼叫其他非同步程序,所以觸發這些狀態更新 (會開始執行非同步程序) 不再適用。 - 合約物件現在會在一次交易中全部更新。
在第 21 版之前,合約屬性更新會分割成個別的更新呼叫。 - 現在更新更加可靠,因為 Sign 後端會自動對失敗事件重試指定的次數。
在第 21 版之前,失敗的合約只能藉由從 Salesforce 內執行手動更新來重試 - 手動更新現在會更新合約的所有層面,包括相關物件。
- 推送合約現在是在非同步模式中執行,與一般更新相同並且會更新其他屬性,與一般更新相同。
- 導入了新的設定,以便啟用與和停用合約不同層面的更新。
- 在 Salesforce 中儲存已簽署的 PDF 時,PDF 檔案名稱結尾不會再加上描述項 (-signed 或 -approved)。
升級完成後,請按照下列步驟重新建立與 Acrobat Sign 的 OAuth 連線:
- 選取「Adobe Acrobat Sign 管理員」標籤。
- 選取「啟用自動狀態更新」。
- 選取「啟用」。
- 選取「允許」。
在第 20 版中,Salesforce 中的回呼使用者不必是 Adobe Sign 授權使用者。
在第 21 版改善的「推送對應」中,回呼使用者在連線到 Salesforce 組織的 Acrobat Sign 帳戶中,必須有作用中的使用者 ID。
進行升級之前,使用「推送對應」的第 20 版客戶應確認已將回呼使用者佈建於 Adobe Acrobat Sign 中。否則,升級到第 21 版之後,「推送對應」將停止運作 (直到完成使用者佈建為止)。
針對使用「複製連絡人帳戶/機會」設定自動連結相關物件的「推送對應」功能,現已擴充為包含從 Salesforce 傳送的合約。
- 例如,如果傳送的合約沒有任何連結的「帳戶/機會」,從 Salesforce 傳送的合約會將第一位連絡人收件者的「機會」查詢自動複製到合約的「機會」查詢,且會將第一位連絡人收件者的「帳戶」查詢複製到合約的「帳戶」查詢
在第 21 版之前,只有在從 Salesforce 中傳送合約時,才會填入 Chatter 摘要
此更新將 Chatter 摘要擴充為包含從 Salesforce 外傳送的合約 (推送合約)
在第 21 版之前,在第一個收件者完成動作後,「合約檢視」只更新了 PDF 影像和 URL。
現在,在具有「預填」狀態或「傳出進行簽名」給第一個收件者時,影像和 URL 會提前進行更新。
不需要任何設定,即可啟用此功能。
已推出「等待我的委派」這項新合約狀態,反映合約處於等候傳送者委派目前收件者授權的狀態。
不需要任何設定,即可啟用此狀態。
「合約範本」具有「到期前的天數」欄位 (echosign_dev1__Days_Until_Expiration__c)。 這是數值欄位,且在第 21 版中已被取代。
已新增全新「到期前的天數」欄位 (API 名稱:echosign_dev1__Days_Until_Expiration2__c),但這是文字欄位,可讓它參照主要物件中的其他欄位 (例如 {!Expiry_Date__c})
從舊版進行升級時,任何對應到舊版到期欄位的表單資料都會自動複製到新欄位,這樣就不需要直接執行任何操作。
範本頁面已不再提供「帳戶」、「機會」和「契約」欄位。
管理員可使用「將資料對應至合約欄位」功能,在範本中設定這些欄位
之前,傳送者可將其簽名堆疊中的絕對位置定義為「傳送者先行簽署」或「傳送者最後簽署」。
「新」範本頁面中不再提供此欄位。傳送者可選擇在簽名堆疊的任何位置中自行插入。
已移除可將整個簽名流程控制為「順序」或「並行」的切換功能。
新範本樣式允許可完全自訂的工作流程,可設定為完全按照順序 (簽署者索引 1 到 1+N)、並行 (所有簽署者索引皆為 1),或混合使用順序和並行,其中簽署索引會設定為特定工作流程。
有五項設定在第 21 版中已被取代。所有設定皆位於「自訂設定」的「Adobe Sign 設定」區段
這五項設定包括:
- 將稽核 PDF 新增至附件清單 — 啟用這個設定,即可在合約簽署後將稽核記錄 PDF 附加到合約記錄。
- 將已簽署 PDF 新增為個別附件 — 啟用這個設定,即可在單筆交易中傳送多份文件時,以個別文件形式附加已簽署的合約 PDF。若要停止接收合併 PDF 形式的已簽署合約,請聯絡 Adobe 客戶服務尋求協助。
- 將支援檔案新增至附件清單 — 啟用這個設定,即可在合約簽署後將支援文件 PDF 附加到合約記錄。簽署者可透過合約中的支援文件欄位,上傳並附加支援文件到合約交易。
- 針對已推送合約新增已簽署 PDF 連結 (預設為啟用) — 這個設定僅適用於在 Salesforce 外部傳送的已推送合約。啟用這個設定,即可將已簽署 PDF 的連結新增至合約記錄。
- 針對已推送合約新增已簽署 PDF (預設為啟用) — 這個設定適用於從 Salesforce 外部傳送並推送至 Salesforce 的合約。啟用這個設定,即可將已簽署的 PDF 附加至合約記錄。
使用上述設定的客戶可在「Adobe Sign 合約更新設定」下設定新設定。
已被取代的設定 (在「Adobe Sign 設定」下) |
新設定 (在「Adobe Sign 合約更新設定」下) |
---|---|
將稽核 PDF 新增至附件清單 |
新增稽核報告 |
將已簽署 PDF 新增為個別附件 |
將已簽署 PDF 新增為個別附件 |
將支援檔案新增至附件清單 |
新增支援檔案 |
針對已推送合約新增已簽署 PDF 連結 |
新增已簽署 PDF 的 URL |
針對已推送合約新增已簽署 PDF |
新增已簽署的 PDF |