Adobe Sign for Salesforce 包 V20.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 管理”页面
• 单击“回调用户”标题下的链接帐户
  • 将显示“允许访问？”页面，寻求链接当前已认证的用户标识
• 单击允许
  • 验证回调用户是否已正确链接
• 注销 Salesforce

5. 更新现有站点

• 以 Salesforce 管理员身份登录
• 导航至平台工具 > 用户界面 > 站点和域 > 站点
• 单击“站点标签”以打开站点详细信息
• 单击公共访问设置按钮
• 将鼠标悬停在“已启用 Apex 类访问”链接上，然后单击编辑按钮
  • 删除 AgreementAttachmentService 类
  • 添加 LargeFileDownloadService 类
  • 保存页面
• 单击“Adobe Sign 回调配置文件”页面上的编辑按钮
  • 删除明确分配给站点用户的所有权限
  • 单击保存

Adobe Sign for Salesforce 包 V20.9 将推送协议支持中所使用对象的授权从站点用户转变为具有明确授予权限的许可“回调”用户。

请删除在相应站点上分配给站点用户的所有权限。

对于要升级到 20.9 或更高版本的现有客户，建议的过程如下：

1. 创建新的回调用户

• 克隆标准用户配置文件
• 使用直观的名称命名新配置文件（例如：Adobe Sign 回调用户）
• 保存配置文件

2. 创建一个使用标准 Salesforce 许可证的新“回调”用户

• 为该用户提供一个直观的名称（例如：Adobe Sign 回调）
• 分配 Salesforce 许可证
• 分配您在上述步骤中创建的配置文件
  • 保存该新用户
• 向在上述步骤中创建的回调用户分配 Adobe Sign 集成用户权限集
  • 保存权限集

3. 将 Adobe Sign for Salesforce 包升级到 20.9（或更高版本）

4. 定义回调用户

• 在升级完成后，以回调用户身份登录至 Salesforce
• 导航至“Adobe Sign 管理”页面（应用程序启动器 > Adobe Sign for Salesforce > Adobe Sign 管理）
• 单击回调用户标题下的链接帐户
  • 将显示“允许访问？”页面，寻求链接当前已认证的用户标识
• 单击允许
  • 验证回调用户是否已正确链接
• 注销 Salesforce

5. 更新现有站点

• 以管理员用户身份登录至 Salesforce
• 导航至平台工具 > 用户界面 > 站点和域 > 站点
• 单击“站点标签”以打开站点详细信息
• 单击公共访问设置按钮
• 单击查看用户按钮
• 单击站点用户的全名链接
• 将鼠标置于“权限集分配”链接上方，然后单击编辑分配按钮
• 删除 Adobe Sign 集成用户权限集
• 移除明确分配给站点用户的所有其他权限
• 单击保存

在 Salesforce 中使用 Lightning 界面的组织必须启用我的域，以使 Adobe Sign v20 包正常运行。

使用 Classic 界面的组织此时无需配置“我的域”。

Adobe Sign v20 包中包含三个新收件人角色：

• 接受人- 当“接收者”需要确认已接受协议，但不需要正式审批内容时，“接受人”的角色较为适用
  
• 表单填写人 - 专为需要在签名期间填写表单内容的客户而设计
  
• 经过认证的收件人 - 可以不向经过认证的收件人分配表单字段。 在他们的“签名”流程中，他们需要委派、拒绝或确认协议。

要获取这些角色的访问权限，必须执行三步进行添加（如果要将角色本地化为非英语语言，则需要执行四步）。

在 Adobe Sign 中启用角色：

1. 以管理员身份登录至 Adobe Sign
2. 导航至帐户 > 帐户设置 > 发送设置 > 允许的接收者角色
3. 启用您需要支持的角色
4. 单击保存

在自定义设置中启用角色 (Salesforce)：

1. 以管理员身份登录至 Salesforce
2. 导航至设置 > 平台工具 > 自定义代码 > 自定义设置
3. 单击 Adobe Sign 设置标签
4. 单击管理按钮
5. 单击新建（或者，如果您之前配置了设置，请单击编辑）

设置值为：

• 启用接受者角色 - 标记为接受者的收件人可接受文档。他们可能需要输入字段数据。
• 启用表单填写者角色 - 启用表单填写者后，可填写字段级别数据
• 启用经过认证的收件人角色 - 经过认证的收件人可确认协议，但不能签署协议。他们可能需要填写字段数据。

收件人和协议对象的状态值直接与系统中启用的角色绑定。如果要启用其他角色，那么还需要将关联的角色值添加到各种对象选择列表中。针对每个对象的过程是一致的，根据对象的上下文添加的值有一些变化。

需要更新的“对象”>“字段”包括：

• 收件人 > 收件人角色
• 收件人 > 状态
• 添加收件人 > 收件人角色
• 协议 > 协议状态
• 字段映射 > 在事件上映射
• 文件映射 > 在事件上映射

应添加的字段值包括：

要添加值并对其进行本地化的过程在所有对象中都是一致的。

以下是针对“收件人”>“收件人角色”的过程，可以依次应用于每个对象。

将角色添加到“收件人”选择列表：

启用新角色后，必须更新字段的选择列表值以包含这些新角色。

1. 导航至设置 > 平台工具 > 对象和字段 > 对象管理器

2. 从左侧列表中选择收件人表单

3. 从左侧栏中选择字段和关系表单

4. 选择收件人角色字段

5. 将页面向下滚动至值部分，然后选择新建

6. 输入您启用的新角色值。 有效值包括：

• 接受者
• 表单填写人
• 经过认证的接收者
• 委派给接受者
• 委派给表单填写人
• 委派给经过认证的接收者

7. 在完成后单击保存

生成的选择列表应如下所示（假设您已添加所有角色）：

通过翻译工作台本地化角色状态：

导航至：设置 > 平台工具 > 用户界面 > 翻译工作台 > 翻译

• 选择要本地化为的语言
• 将设置组件选为选择列表值
• 将对象选为收件人

• 在“主选择列表”表格中，展开收件人角色文件夹

• 双击英文状态旁边的栏空间，以打开可在其中输入译文的文本字段，然后输入相应的本地化值。

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

协议对象的文档字段包含协议的超链接。v20 发行版中对此字段有两处更改：

• 超链接文本不再具有追加到它的协议的状态。

在 v20 之前，超链接文本包含协议名称以及追加到末尾的状态“- 已签名”或“- 已批准”：

V20 将删除追加状态，只留下协议名称：

• 在 v20 之前，只有当成功完成协议事务，文档字段才会包含超链接。

在 v20 包中，文档字段始终包含协议的最新 PDF 版本：

可以更新 Chatter 事件发送协议时发布的帮助文本，以保持与新收件人角色一致。

1. 导航至设置 > 平台工具 > 自定义代码 > 自定义设置
2. 单击 Adobe Sign Chatter 设置标签
3. 单击“发送协议时发布”旁边的编辑链接

4. 更新要显示的帮助文本：当发送协议以进行签名/批准/验收/表单填写/交付时更新 Post 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 运营范围的扩张，其基础设施已转移到功能更为强大的数据中心，这导致 Saleforce 组织需要信任的 IP 范围发生了一些变化，以此来确保各项服务之间达到最佳的通信效果。

以下是从版本 18 到版本 19 所做的更新。除了受信任的核心网络之外，还需确保所有配置的站点均已更新。

版本 19 发行之后，Saleforce 组织中标准对象及自定义对象的 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) 添加到“协议模板页面布局”：

• 导航至设置 > 平台工具 > 对象和字段 > 对象管理器 > 协议模板 > 页面布局 > 协议模板布局
• 选择字段选项
• 单击协议类型字段，然后将其拖到页面布局上
• 单击保存

强烈建议要升级的客户采用 Lightning 页面，以确保在开发过程不断改进产品的同时，可以使用新功能。

即便如此，您也可能会有极其充分的理由需要保留使用某个旧页面布局。请参阅有关调整 Salesforce 页面布局的指南，以确定是否适合移至 Lightning 页面。

如果适用于 Salesforce 的 Adobe Sign 应用程序是从低于 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 Feed 插入系统字段值

• 必须为 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 Feed 插入系统字段值

以下是对象的明确列表，以及必填字段（如果由于任何原因而不可使用权限集）：

推送协议要求已链接的回调用户具有：

• Adobe Sign 集成用户权限集

• 必须为 Salesforce 帐户对象启用读取和创建

• 必须为 Salesforce 合同对象启用读取和创建
  

• 必须为 Salesforce 业务机会对象启用读取和创建
  

• 必须为 Salesforce 联系人对象启用读取和创建
  • 必须为“联系人”对象上的名称字段启用读取和修改
    
  • 必须为“联系人”对象上的电子邮件字段启用读取和修改
  • 必须为“联系人”对象上的帐户字段启用读取和修改
    

• 必须为 Salesforce 潜在客户对象启用读取和创建
  • 必须为“潜在客户”对象上的名称字段启用读取和修改
    
  • 必须为“潜在客户”对象上的电子邮件字段启用读取和修改
  • 必须为“潜在客户”对象上的公司字段启用读取和修改

以下是对象的明确列表，以及必填字段（如果由于任何原因而不可使用权限集）：

必须配置和链接回调用户：

• 已添加 Adobe Sign 集成用户权限集
• 回调用户配置文件必须对修改元数据启用管理权限

此外，必须编辑站点配置文件以：

• 添加 LargeFileDownloadService 类
• 删除 AgreementAttaqchmentService 类

以下是对象的明确列表，以及必填字段（如果由于任何原因而不可使用权限集）：