Adobe Sign for Salesforce 套件第 20.9 版將大型文件支援中使用的物件授權，從網站使用者更改為明確取得授權的經授權「回呼」使用者。

請在用於大型檔案或推送合約的個別網站上，移除指派給其網站使用者的敏感或非公開物件的所有現有權限。

現有的客戶若要升級為第 20.9 版或以上版本，建議採用以下程序：

1. 將Adobe Sign for Salesforce 套件升級至 20.9 版 (或以上版本)

2. 建立新的回呼使用者設定檔

• 仿製「標準使用者」設定檔
  • 使用直覺式名稱為新設定檔命名 (例如：Adobe Sign 回呼使用者)
  • 編輯設定檔
    • 在「自訂索引標籤設定」底下，確認兩個「Adobe Sign 管理員」索引標籤都已設為「預設為開啟」
    • 在「自訂物件權限」底下，啟用「合約」物件的所有值
    • 確認以下 Visualforce 頁面均已啟用
      • echosign_dev1.EchosignAdmin
      • echosign_dev1.SalesforceOAuthPage
    • 啟用 echosign_dev1.AgreementAttachmentDownloadService Apex 類別
  • 儲存設定檔

3. 為回呼使用者設定檔啟用「附件服務叫用計數」

• 瀏覽至「物件管理員 > 合約 > 欄位與關係」
• 按一下「附件服務叫用計數」欄位標籤
• 按一下「設定欄位等級安全」按鈕
• 為回呼使用者設定檔啟用「可見」和「唯讀」
• 按一下「儲存」

4. 使用標準 Salesforce 授權建立新使用者

• 以直覺式名稱為使用者命名 (例如：Adobe Sign 回呼)
• 指派 Salesforce 授權
• 指派您上個步驟建立的設定檔
• 儲存新使用者
• 驗證使用者以建立已知密碼
• 登出 Salesforce

5. 定義回呼使用者

• 以回呼使用者身分登入 Salesforce
• 瀏覽至「Adobe Sign 管理員」頁面
• 按一下「回呼使用者」標題底下的「連結帳戶」
  • 隨即會顯示「允許存取?」頁面，要求連結至目前已驗證的 userID
• 按一下「允許」
  • 確認回呼使用者已正確連結
• 登出 Salesforce

5. 更新現有的網站

• 以 Salesforce 管理員身分登入
• 瀏覽至「平台工具 > 使用者介面 > 網站和網域 > 網站」
• 按一下「網站標籤」，開啟網站詳細資料
• 按一下「公開存取設定」按鈕
• 將滑鼠移到「已啟用的 Apex 類別存取權」連結，然後按一下「編輯」按鈕
  • 移除 AgreementAttachmentService 類別
  • 新增 LargeFileDownloadService 類別
  • 儲存頁面
• 按一下「Adobe Sign 回呼設定檔」頁面上的「編輯」按鈕
  • 移除明確指派給網站使用者的所有權限
  • 按一下「儲存」

Adobe Sign for Salesforce 套件第 20.9 版將推送合約支援中使用的物件授權，從網站使用者更改為明確取得授權的經授權「回呼」使用者。

請在各網站分別移除指派給網站使用者的所有權限。

現有的客戶若要升級為第 20.9 版或以上版本，建議採用以下程序：

1. 建立新的回呼使用者

• 仿製「標準使用者」設定檔
• 使用直覺式名稱為新設定檔命名 (例如：Adobe Sign 回呼使用者)
• 儲存設定檔

2. 使用標準 Salesforce 授權建立新的「回呼」使用者

• 以直覺式名稱為使用者命名 (例如：Adobe Sign 回呼)
• 指派 Salesforce 授權
• 指派您上個步驟建立的設定檔
  • 儲存新使用者
• 指派「Adobe Sign 整合使用者」權限集給上個步驟建立的回呼使用者
  • 儲存權限集

3. 將Adobe Sign for Salesforce 套件升級至 20.9 版 (或以上版本)

4. 定義回呼使用者

• 升級完成後，請以回呼使用者身分登入 Salesforce
• 瀏覽至「Adobe Sign 管理員」頁面 (「App Launcher > Adobe Sign for Salesforce > Adobe Sign 管理員」)
• 按一下「回呼使用者」標題底下的「連結帳戶」
  • 隨即會顯示「允許存取?」頁面，要求連結至目前已驗證的 userID
• 按一下「允許」
  • 確認回呼使用者已正確連結
• 登出 Salesforce

5. 更新現有的網站

• 以管理員使用者的身分登入 Salesforce
• 瀏覽至「平台工具 > 使用者介面 > 網站和網域 > 網站」
• 按一下「網站標籤」，開啟網站詳細資料
• 按一下「公開存取設定」按鈕
• 按一下「檢視使用者」按鈕
• 按一下網站使用者的「全名」連結
• 將滑鼠移到「權限集指派」連結，並按一下「編輯指派」按鈕
• 移除「Adobe Sign 整合使用者」權限集
• 移除明確指派給網站使用者的所有其他權限
• 按一下「儲存」

在 Salesforce 中使用 Lightning 介面的組織，必須為 Adobe Sign 第 20 版套件啟用「我的網域」才能正常運作。

使用 Classic 介面的組織目前不需要設定「我的網域」。

Adobe Sign 第 20 版套件包含三個新的收件者角色：

• 接受者 - 當「收件者」需要在沒有正式核准內容的情況下認可接受合約時，適合使用「接受者」角色
  
• 表單填寫者 - 專為需要在簽名過程中填寫表單內容的客戶所設計
  
• 認證收件者 - 認證收件者可不具任何 (零個) 獲指派的表單欄位。在其「簽名」過程中，系統會要求認證收件者委派、拒絕或認可合約

若要使用這些角色，必須透過包含三個步驟的程序新增這些角色 (若要將角色本地化為非英文的語言，則需要四個步驟)。

在 Adobe Sign 中啟用角色：

1. 以管理員身分登入 Adobe Sign
2. 瀏覽至「帳戶 > 帳戶設定 > 傳送設定 > 允許的收件者角色」
3. 啟用您需支援的角色
4. 按一下「儲存」

在自訂設定中啟用角色 (Salesforce)：

1. 以管理員身分登入 Salesforce
2. 瀏覽至「設定 > 平台工具 > 自訂程式碼 > 自訂設定」
3. 按一下「Adobe Sign 設定」標籤
4. 按一下「管理」按鈕
5. 按一下「新增」(或者若過去曾進行設定，則按一下「編輯」)

設定值如下：

• 啟用接受者角色 — 標記為接受者的收件者可以接受文件。系統可能會要求標記為接受者的收件者輸入欄位資料
• 啟用表單填寫者角色 – 啟用表單填寫者，即可填寫欄位等級資料
• 啟用認證收件者角色 – 認證收件者可以認可合約，但無法進行簽署。系統可能會要求認證收件者填寫欄位資料

收件者的狀態值和合約物件直接與系統中啟用的角色綁定。若要啟用其他角色，也必須將相關的角色值新增到不同的物件挑選清單中。  同一套程序適用於所有物件，但根據物件的環境，值會有所不同。

需更新的物件 > 欄位為：

• 收件者 > 收件者角色
• 收件者 > 狀態
• 新增收件者 > 收件者角色
• 合約 > 合約狀態
• 欄位對應 > 對應事件
• 檔案對應 > 對應事件

應新增的欄位值為：

新增值和進行本地化的程序，所有物件均一致。

以下為「收件者 > 收件者角色」的程序，且可分別套用至每個物件。

將角色新增至「收件者」挑選清單：

啟用新角色後，必須更新欄位的挑選清單值以加入新角色。

1. 瀏覽至「設定 > 平台工具 > 物件和欄位 > 物件管理員」

2. 從左側的清單中選取「收件者」

3. 從左側欄中選取「欄位與關係」

4. 選取「收件者角色」欄位

5. 將頁面向下捲動至「值」區段，並選取「新增」

6. 輸入您已啟用的新角色值。有效的值如下：

• 接受者
• 表單填寫者
• 認證收件者
• 委派給接受者
• 委派給表單填寫者
• 委派給認證收件者

7. 完成後請按一下「儲存」

產生的挑選清單看起來應該像這樣 (假設新增了所有角色)：

透過翻譯工作台將角色狀態本地化：

1. 瀏覽至「設定 > 平台工具 > 使用者介面 > 翻譯工作台 > 翻譯」

• 選取您想本地化的目標語言
• 將「設定元件」選取為「挑選清單值」
• 將「物件」選取為「收件者」

• 在「主要挑選清單」表格中，展開「收件者角色」資料夾

• 連按兩下英文狀態旁的欄位空間，以開啟可輸入翻譯的文字欄位，然後輸入合適的本地化值

2. 完成後請按一下「儲存」

The status values of the agreement are tied directly to the roles that are enabled in the system. If you are enabling additional roles, then you also need to add the associated agreement statuses to the agreement status picklist.

To add the agreement statuses:

1. Navigate to Setup > Platform Tools > Objects and Fields > Object Manager

2. Select Agreement from the list on the left

3. Select Fields & Relationships from the left rail

4. Select the Agreement Status field

5. Scroll down the page to the Values section, and select New

6. Enter the new Agreement Status values for the recipient roles that you have enabled. Valid values are:

Acceptor

• Accepted
• Waiting for Counter-Acceptance
• Out for Acceptance

Form Filler

• Form-Filled
• Waiting for Counter-Form-Filling
• Out for Form-Filling

Certified Recipient

• Delivered
• Waiting for Counter-Delivery
• Out for Delivery

7. Click Save when done

The resulting picklist should look like this (assuming you added all roles):

Localize the role statuses through the translation workbench:

1. Navigate to: Setup > Platform Tools > User Interface > Translation Workbench > Translate

• Select the Language that you want to localize to
• Select the Setup Component as Picklist Value
• Select Object as Agreement

• In the Master Picklist table, expand the Status folder

• Double-click the column space next to the English status to open the text field where the translation can be entered, and enter the appropriate localized value 

2. Click Save when done

「合約」物件的「文件」欄位中包含合約的超連結。第 20 版中對此欄位做出兩項變更：

• 超連結文字不再顯示附加的合約狀態。 

在第 20 版之前，超連結文字包含合約名稱，且尾端會附加「- signed」或「- approved」狀態：

第 20 版移除了附加的狀態，僅保留合約名稱：

• 在第 20 版之前，「文件」欄位只會在合約交易完成時包含超連結。

在第 20 版套件中，「文件」欄位一律包含合約的最新版 PDF：

可以更新「在傳送合約時張貼」的 Chatter 事件說明文字，以便與新的收件者角色保持一致。

1. 瀏覽至「設定 > 平台工具 > 自訂程式碼 > 自訂設定」
2. 按一下「Adobe Sign Chatter 設定」標籤
3. 按一下「在傳送合約時張貼」旁邊的「編輯」連結

4. 將說明文字更新為：「傳送合約進行簽署/核准/接受/填寫表單/傳遞時張貼 Chatter 更新」。

5. 按一下「儲存」

When the Adobe Sign application for Salesforce is upgraded from versions older than v14 to the current build, users might not be able to perform actions such as Delete, Cancel, View, Remind, or Update on the existing agreements that were sent by other users before upgrade. 

Users may prompt an error when one of these actions is executed, similar to:

“INVALID_DOCUMENT_KEY” or “An internal server error has occurred”

This happens due to a legacy document key style that was used in versions of the application before version 14.

A one-time migration of those legacy keys is required. To this end, a new affordance as described below:

After completing the set-up steps, the following links will be available on the Adobe Sign Admin page:

• Fetch Missing Document Keys – Clicking this link will perform a batch action for fetching missing document keys for existing agreements
• Update Legacy Document Keys - Clicking this link will flush out the existing legacy document keys and fetch the new document keys for all the agreements existing in the org. 

In case there are any agreements that don’t have associated document keys, it will fetch document keys for them as well

Once the agreements have new document keys, users will be able to perform all agreement actions on existing agreements sent by other users.

DCSI-12872 "Adobe Document Cloud" appearing in place of "Adobe Sign" at Multiple instances

隨著 Adobe Sign 的擴展，基礎架構已移轉至更為強大的資料中心，這會對 IP 範圍會做出若干改變，您的 Salesforce 組織必須信任新的 IP 位址，以確保服務間的最佳通訊。

以下是從第 18 版到第 19 版所進行的變更。  除了核心信任網路之外，請確保所有已設定的回呼網站均已進行更新。

隨著第 19 版的發行，組織的 CRUD 和 FLS 設定在標準與自訂物件中將被強制執行。此應用程式會檢查物件和欄位層級，以及讀寫權限。如果使用者沒有適當的存取權限，則畫面會顯示使用權限遭拒的錯誤訊息。

升級至第 19 版之後，如果 salesforce 使用者得到類似如下的使用權限遭拒錯誤訊息：

使用權限遭拒。無法將欄位 echosign_dev1__Contract__c 插入物件：echosign_dev1__SIGN_Agreement__c

則 salesforce 管理員必須對合約物件新增讀寫權限，而對於所有已經建立的自訂欄位，則必須新增權限至相關的設定檔。

• 瀏覽至：「設定 > 管理 > 使用者 > 設定檔 > {設定檔名稱}」
• 向下捲動至「欄位級安全性」區段，按一下「合約」物件的「檢視」按鈕
• 提供相關欄位「讀取」和「編輯」的存取權限

第 19 版有一項過時的自訂設定：

• 啟用將書面簽名傳送至傳真的功能 – Adobe Sign 不再支援將合約傳送至電話號碼的功能。書面簽名將實施與電子簽名相同的程序，必須等到第一位簽署者套用簽名之後，才能下載、簽署、掃描並將該檔案上傳回 Adobe Sign。
  

>> 更多有關書面簽名的詳細資訊

第 19 版新增一個標籤：合約類型

• 此版本引入一個名稱為「合約類型」的自訂物件 (Agreement_Type__c)，可用來定義合約類型。其中含有一個「名稱」標準欄位，其他欄位可於稍後再新增並由您定義專屬的自訂欄位。以物件取代簡單文字欄位後，就能使用唯一記錄定義類型，不僅更彈性也更具擴充能力。此外，這也能使類型獨立於合約範本及合約，當合約範本變更時，就無須綁定類型，且多個範本也能設為相同類型。
• 名為「合約類型」的父查詢欄位 (Agreement_Type__c) 已新增至「合約範本」物件，並指向「合約類型」物件。此欄位會顯示於合約範本頁面的「合約範本詳細資訊」區段。
• 名為「合約類型」的父查詢欄位 (Agreement_Type__c) 已新增至「合約」物件，並指向「合約類型」物件。此欄位不會顯示於「合約編輯器」頁面。

將名為「合約類型」的父項查詢欄位 (Agreement_Type__c) 新增至「合約範本頁面版面配置」：

• 瀏覽至「設定 > 平台工具 > 物件和欄位 > 物件管理員 > 合約範本 > 頁面版面配置 > 合約範本版面配置」
• 選取「欄位」選項
• 按一下「合約類型」欄位，然後將其拖曳到頁面版面配置上
• 按一下「儲存」

強烈建議升級客戶採用「快速」頁面樣式，確保在持續改善產品的開發過程中，您可以使用到所有新功能。

也就是說，維持其中一個舊有頁面版面配置對您有益無害。請參閱調整 Salesforce 頁面版面配置指南，再考慮移至「快速」頁面樣式是否為最合適的決定。

當 Adobe Sign for Salesforce 應用程式從 v14 之前的版本升級至目前版本，針對升級前其他使用者所傳送的現有合約，使用者可能無法執行例如刪除、取消、檢視、提醒或更新的動作。

使用者可能會在執行這些動作時，收到發生錯誤的提示，例如：

「INVALID_DOCUMENT_KEY」或「發生內部伺服器錯誤」

這是因為第 14 版之前的應用程式版本採用的是舊版文件金鑰樣式的緣故。

需要進行舊版金鑰的一次性移轉。新的因應措施如下所述：

完成設定步驟後，下列連結會在 Adobe Sign 管理員頁面上可用：

• 取得遺失的文件金鑰 - 按一下此連結將執行批次動作以取得現有合約遺失的文件金鑰。
• 更新舊版文件金鑰 - 按一下此連結將清除現有的舊版文件金鑰，並取得組織中所有合約的新版文件金鑰。

若有合約沒有相關的文件金鑰，這麼做也會為合約取得文件金鑰

一旦合約都有新版文件金鑰，使用者將可以在其他使用者傳送的現有合約上執行合約動作。

針對已推送合約新增已簽署 PDF 連結 - 這個設定僅適用於在 Salesforce 外部傳送的已推送合約。啟用這個設定即可將已簽署 PDF 的連結新增至合約記錄。

任何直接與群組對應互動的使用者需要確認他們擁有正確的權限。

• 為使用者新增 Adobe Sign 管理員權限集合是最好的達成方式。
• 使用者設定檔必須啟用檢視設定和配置權限

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

所有使用 Adobe Sign API 的使用者必須具備 Adobe Sign 使用者權限集合。

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

針對與 Adobe Sign 適用之自我簽署元件互動的使用者：

• Adobe Sign 使用者權限集合應套用至使用者
• Salesforce 連絡人物件必須啟用讀取
  • 連絡人物件上的電子郵件欄位必須啟用讀取

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

與合約範本互動的使用者必須具備：

• 新增 Adobe Sign 管理員權限集合
• 存取 Salesforce 中指定主要物件的所有欄位

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

觸發批次行動的使用者必須具備：

• Adobe Sign 管理員權限集合

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

透過 S1 Mobile 使用 Adobe Sign 的使用者必具備：

• Adobe Sign 使用者權限集合
• Salesforce 機會物件必須啟用讀取
  • 機會物件上的名稱欄位必須啟用讀取
    

• Salesforce 帳戶物件必須啟用讀取
  
  • 帳戶物件上的名稱欄位必須啟用讀取
    

• Salesforce 合約物件必須啟用讀取
  
  • 合約物件上的名稱欄位必須啟用讀取
    
  • 合約物件上的合約編號欄位必須啟用讀取
    

• Salesforce 連絡人物件必須啟用讀取
  
  • 連絡人物件上的名稱欄位必須啟用讀取
    
  • 連絡人物件上的電子郵件欄位必須啟用讀取
    

• Salesforce 商機物件必須啟用讀取
  
  • 商機物件上的名稱欄位必須啟用讀取
    
  • 商機物件上的電子郵件欄位必須啟用讀取

• Salesforce 文件物件必須啟用讀取
  
  • 文件物件上的名稱欄位必須啟用讀取
    
  • 文件物件上的類型欄位必須啟用讀取
  • 文件物件上的內容類型欄位必須啟用讀取
    
  • 文件物件上的內文欄位必須啟用讀取

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

若使用者需存取「管理」標籤，必須具有 Adobe Sign 管理員權限集合。

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

利用發行者行動的使用者必須具備：

• Adobe Sign 使用者權限集合
• 啟用系統權限中的為 Chatter 摘要插入系統欄位值

• Salesforce 機會物件必須啟用讀取
  • 機會物件上的名稱欄位必須啟用讀取
    

• Salesforce 帳戶物件必須啟用讀取
  
  • 帳戶物件上的名稱欄位必須啟用讀取

• Salesforce 連絡人物件必須啟用讀取
  
  • 連絡人物件上的名稱欄位必須啟用讀取
    
  • 連絡人物件上的電子郵件欄位必須啟用讀取
    

• Salesforce 商機物件必須啟用讀取
  
  • 商機物件上的名稱欄位必須啟用讀取
    
  • 商機物件上的電子郵件欄位必須啟用讀取

• Salesforce 文件物件必須啟用讀取
  
  • 文件物件上的名稱欄位必須啟用讀取
    
  • 文件物件上的類型欄位必須啟用讀取
  • 文件物件上的內容類型欄位必須啟用讀取
    
  • 文件物件上的內文欄位必須啟用讀取
• Salesforce 報價物件必須啟用讀取

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

編輯範本的使用者必須具備：

• Adobe Sign 管理員權限集合
• Salesforce 連絡人物件必須啟用讀取
  
• Salesforce 商機物件必須啟用讀取
• Salesforce 文件物件必須啟用讀取
  
  • 文件物件上的 URL 欄位必須啟用讀取
    

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

合約範本處理者必須具備：

• Adobe Sign 管理員權限集合
• Salesforce 連絡人物件必須啟用讀取
  
  • 連絡人物件上的手機號碼欄位必須啟用讀取
    

• Salesforce 商機物件必須啟用讀取
  
  • 商機物件上的手機號碼欄位必須啟用讀取
    

• Salesforce 機會物件必須啟用讀取
• Salesforce 帳戶物件必須啟用讀取
  
• Salesforce 群組物件必須啟用讀取
  
• Salesforce 報價物件必須啟用讀取

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

編輯合約的使用者必須具備：

• Adobe Sign 使用者權限集合

• Salesforce 商機物件必須啟用讀取
  • 商機物件上的公司欄位必須啟用讀取

• Salesforce 事件物件必須啟用建立
  
  • 事件物件上的所有欄位必須啟用修改

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

編輯合併對應的使用者必須具備：

• Adobe Sign 管理員權限集合
• 任何合併對應存取的物件/欄位需要啟用讀取和修改
  

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

利用合併對應的使用者必須具備：

• Adobe Sign 使用者權限集合
• Salesforce 帳戶物件必須啟用讀取
  
  • 帳戶物件上的名稱欄位必須啟用讀取

• Salesforce 機會物件必須啟用讀取
  
  • 機會物件上的名稱欄位必須啟用讀取

• 任何合併對應存取的物件/欄位需要啟用讀取和修改

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

編輯資料對應的使用者必須具備：

• Adobe Sign 管理員權限集合
• 任何合併對應存取的物件/欄位需要啟用讀取和修改
  

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

資料對應處理者必須具備：

• Adobe Sign 整合使用者權限集合
• 任何資料對應存取的物件/欄位需要啟用讀取和修改
  
• Salesforce 附件物件需要有根據上層記錄的存取權限

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

Chatter 整合必須具備：

• Adobe Sign 整合使用者權限集合
• 啟用 Salesforce 系統權限中的為 Chatter 摘要插入系統欄位值

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

推送合約要求已連結的回呼使用者具備：

• Adobe Sign 整合使用者權限集合

• Salesforce 帳戶物件必須啟用讀取和建立

• Salesforce 合約物件必須啟用讀取和建立
   

• Salesforce 機會物件必須啟用讀取和建立
  

• Salesforce 連絡人物件必須啟用讀取和建立
  • 連絡人物件上的名稱欄位必須啟用讀取和修改
    
  • 連絡人物件上的電子郵件欄位必須啟用讀取和修改
  • 連絡人物件上的帳戶欄位必須啟用讀取和修改
    

• Salesforce 商機物件必須啟用讀取和 建立 
  • 商機物件上的名稱欄位必須啟用讀取和修改
    
  • 商機物件上的電子郵件欄位必須啟用讀取和修改
  • 商機物件上的公司欄位必須啟用讀取和修改

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：

必須設定和連結回呼使用者：

• Adobe Sign 整合使用者權限集已新增
• 回呼使用者設定檔必須為「修改中繼資料」啟用「管理權限」

此外，必須編輯網站設定檔以便：

• 新增 LargeFileDownloadService 類別
• 移除 AgreementAttaqchmentService 類別

若出於任何原因無法使用權限集合，以下是明確的物件清單和必要欄位：