转到 Salesforce AppExchange 以访问最新的适用于 Salesforce 的 Adobe Acrobat Sign 包，然后选择立即获取。
上次更新日期：
2023年11月30日
|
也应用至 Adobe Acrobat Sign
- Adobe Acrobat Sign 集成
- 新增功能
- 产品版本和生命周期
- Acrobat Sign for Salesforce
- Acrobat Sign for Microsoft
- Acrobat Sign for Microsoft 365
- 适用于 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
- Acrobat Sign for Microsoft 365
- Acrobat Sign for ServiceNow
- 适用于 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
- 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）。不受支持的版本会增加安全风险，并会阻止 API 访问 Adobe Acrobat Sign 服务。
升级重要注意事项
- 请勿卸载现有的适用于 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 的 Push 模型。将仅使用基于 REST API 的 Push 模型触发协议自动状态更新。
如果您已安装适用于 Salesforce 的 Adobe Acrobat Sign 软件包版本 20.x 或更低版本，请在沙盒组织中测试升级。如果协议状态升级无效，请转至适用于 Salesforce 的 Adobe Acrobat Sign 页面上的管理员选项卡，然后重新运行启用自动状态更新。 - 升级到适用于 Salesforce 的 Adobe Acrobat Sign V 24.14 的用户需要手动添加新选择列表值，以便在协议中设置提醒。但是，默认情况下，全新安装包 v 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
添加“通过电子邮件发送一次性密码”选择列表值
对于从版本 24.26 升级的移动用户，默认情况下不启用“通过电子邮件发送一次性密码”选项。您必须按照以下方式手动启用该选项：
- 转到设置 > 对象管理器 > 收件人 > 字段和关系 > 签名者身份验证方法。
- 向下滚动到值部分，然后选择新建。
- 输入通过电子邮件发送一次性密码。
- 选择保存。
包版本 24.14
- 适用于 Salesforce 的 Adobe Acrobat Sign V 24.14 包含新选择列表值（如下图所示），用于在协议模板和协议中设置提醒。
升级到程序包V 24.14时，Salesforce管理员必须手动将以下选择列表值添加到协议模板中的“自动提醒”自定义字段以及协议中的“提醒收件人签名”自定义字段：- 每个工作日一次，直到签名
- 每两天一次，直到签名
- 每三天一次，直到签名
- 每五天一次，直到签名
- 要启用 Acrobat Sign 身份验证方法，Salesforce 管理员必须将新的“Acrobat Sign”选择列表值添加到收件人（API 名称 echosign_dev1SIGN_Recipients_c）对象中的“签名者身份验证方法”（API 名称 echosign_dev1_Signer_Verification_Methodc）字段中。
- V 24.14 支持收件人姓名锁定功能，该功能针对所有协议强制指定进行 KBA 身份验证的收件人姓名。要成功实施 KBA 姓名所需设置，管理员必须将新的选择列表值“Acrobat Sign 身份验证”添加到协议和协议模板对象中的“内部签名者身份验证方法”中，如下所示。
- 从 V 24.14 开始，适用于 Salesforce 的 Adobe Acrobat Sign 不再支持用于触发自动状态更新的基于 SOAP API 的 Push 模型。现在，仅使用基于 REST API 的 Push 模型触发协议自动状态更新。
包版本 23.x
此功能已经实施，以允许 Adobe Sign 收集使用情况数据来改进产品。此数据仅用于开发，而不用于营销。
管理员可以在 Adobe Sign 管理员选项卡上或通过运行设置向导来启用或禁用此功能。
从适用于 Salesforce 的 Adobe Sign 包的版本 23 开始，Files 文档存储对象将是开发中使用的主要对象。
从版本 v23.0 或更早版本升级的客户将使其现有默认存储类型免于升级（通常为附件），以确保不会遇到流程中断的情况。
管理员应评估将文档存储类型更改为文件的影响，以便最好地利用未来的功能。
为支持文档存储类型的管理员控制，向自定义设置 > Adobe Sign 设置控件集添加了新控件。
此用户界面映射到自定义对象：Agreement_Document_Storage_Type__c
可行的设置值有：
- {empty} - 如果值为空，则默认行为基于包的安装版本
- 版本 23.0 或更高版本将默认采用文件作为默认存储类型
- 版本 23.0 或更早版本默认采用附件作为默认存储类型
- 文件 - 明确将文件定义为 Adobe Sign 文档的默认存储对象
- 附件 - 明确将附件定义为 Adobe Sign 文档的默认存储对象
包版本 22.x
在 Salesforce 包中引入工作流程时，需要启用其他访问权限。
如果您打算使用工作流程，则必须刷新 OAuth 链接。
无需手动配置或系统更改.
软件包版本 21.5.11
所有低于 V21.5.9 的版本都必须安装软件包
从 21.5.9 或更早版本升级的任何现有安装均必须首先安装 21.5.11 包。
安装版本 21.5.11 后，才可安装当前包。
从 21.5.9 或更早版本升级的任何现有安装均必须首先安装 21.5.11 包。安装版本 21.5.9+ 后，即可安装当前软件包。
必须启用 Chatter 才能安装版本 21.5.11 包.
在开始升级过程之前，请验证 Chatter 是否已启用：
- 导航至设置 > 平台工具 > 功能设置 > Chatter > Chatter 设置。
- 如果 Chatter 已禁用，请选择编辑。
- 选择已启用复选框。
- 选择保存。
包版本 21.x
注意:
V21.x 提供了适用于 Salesforce 的 Adobe Sign 操作方式的若干更新。
强烈建议先将 v21.x 安装到沙盒环境中，以确认应用程序的所有功能均按预期工作。
开发人员应注意检查对更新顺序以及 Apex 方法所做的更改。
自 v21.0 起，已弃用 SIGN_Signed_Agreement__c 对象（标签名称：已签名协议）。
要获取已签名协议 URL 的客户应使用 REST API 协议调用 GET /agreements/{agreementId}/combinedDocument/url
注意：从 API 调用返回的 URL 是安全的，并且仅在有限时间内可行。
以下是更新协议及其相关对象的新序列（自版本 21.0 开始）：
- 附件
- 收件人
- 协议（状态及其他属性）
- 协议事件
- Chatter 订阅源
从 v21.x 起，所有异步进程（包括自动更新和数据映射）都已从未来方法切换到可排队，这是 Salesforce 建议的新方法。
由于此更改，订阅者组织中将作业添加到 Salesforce 队列作为自动-更新和/或数据映射进程一部分的任何自定义设置都将失败，并出现错误“System.LimitException：太多可排队作业添加到队列：2”
发生这种情况的原因是可排队进程只能添加一个可排队子作业，但已被 Adobe Sign 占用（请参阅此处的“可排队 Apex 限制”部分）。
“当链接作业时，您只能使用 System.enqueueJob 从执行作业中添加一个作业，这意味着每个父级可排队作业只能存在一个子作业。不支持从同一个可排队作业启动多个子作业”。
此错误表现在协议状态不变和/或数据映射未正常运行。
要解决此错误，请查找错误触发器、进程构建器或工作流程，然后将其停用或切换为使用同步调用，或安排在未来进行，例如 1 小时后。
- 现在，文档和收件人更新之后，协议状态也会更新.
对于 V21 或更早版本，之前已设置状态。
- 现在不会插入存储图像 URL 的已签名协议对象。
对于 v21，在完成所有其他更新后可以插入已签名协议对象。 - 根据 Salesforce 调节器限制，异步 Apex 呼出请求或响应的最大大小限制为 12MB：https://developer.salesforce.com/docs/atlas.en-us.210.0.apexcode.meta/apexcode/apex_gov_limits.htm
由于上述限制，无法从 Sign 获取大于 12MB 的文档。
- 现在，协议事件描述与 Sign API 返回的描述和审核报告相匹配。
- 现在，更新进程在 Salesforce 中作为本机 Apex 批处理进程（异步进程）运行。
之前，更新进程是在 Salesforce 外部使用 API 调用进行的更新。触发这些启动异步进程的状态更新不再起作用，因为 Salesforce 限制从已经运行的异步进程调用另一个异步进程. - 现在，协议对象在一个事务中全部更新。
在 v21 之前，协议属性更新拆分为单独的更新单元。 - 现在，更新更加可靠，因为 Sign 后端会自动以指定的次数重试失败事件。
在 v21 之前，失败的协议只能通过在 Salesforce 中进行手动更新来重试 - 现在，手动更新会更新协议的所有方面，包括相关对象。
- 与常规更新一样，现在推送协议会以异步模式运行，并且也会更新其他属性。
- 引入了新设置，以启用和禁用协议不同方面的更新。
- 当已签名 PDF 存储在 Salesforce 中时，PDF 文件名的末尾将不再附加描述符（-signed 或 -approved）。
升级完成后，请按照以下步骤以重新建立与 Acrobat Sign 的 Oauth 连接：
- 选择 Adobe Acrobat Sign 管理员选项卡。
- 选择启用自动状态更新。
- 选择启用。
- 选择允许。
在 v20 中，Salesforce 中的回调用户无需成为 Adobe Sign 许可用户。
v21 中的推送映射改进要求回调用户在 Acrobat Sign 帐户中拥有活跃的用户 ID，并且该帐户已连接到 Salesforce 组织。
使用推送映射的 v20 客户必须确保已在 Adobe Acrobat Sign 中设置了回调用户，然后再进行升级。否则，推送映射将在升级到 v21 之后停止运行（直到设置了回调用户为止）。
推送映射功能使用“复制联系人帐户/业务机会”设置自动链接相关的对象，现已扩展为包含从 Salesforce 发送的协议。
- 例如，如果从 Salesforce 发送的协议没有任何链接的帐户/业务机会，那么发送的协议会自动将第一个联系收件人的业务机会查找复制到协议的业务机会查找，将第一个联系收件人的帐户查找复制到协议的帐户查找
在 v21 之前，只有从 Salesforce 发送协议时才会填充 Chatter 订阅源。
此更新对 Chatter 订阅源功能进行了扩展，以包含从 Salesforce 之外发送的协议（推送协议）
在 v21 之前，协议视图只会在第一个收件人完成他们的操作后更新 PDF 图像和 URL。
现在，图像和 URL 会提前更新，会在处于预填充状态、或针对第一个收件人已发出进行签名时更新。
启用此功能无需进行额外配置。
引入了一个新的协议状态正在等待我的委派，用以反映协议正在等待发件人委派当前接收权限。
启用此状态无需进行额外配置。
协议模板有一个“距到期日天数”字段（echosign_dev1__Days_Until_Expiration__c）。 这是一个数字字段，在 v21 中已放弃使用。
已添加一个新的“距到期日天数”字段（API 名称：echosign_dev1__Days_Until_Expiration2__c），但这是一个文本字段，允许引用主对象中的其他字段（例如 {!Expiry_Date__c}）
从先前版本升级时，任何映射到原到期字段的表单数据会自动复制到新字段，因此不需要额外进行直接操作。
帐户、业务机会、和合同字段在模板页面上不再可用。
管理员可以使用将数据映射到协议字段功能在模板中配置这些字段
以前，发件人可以将自己在签名堆栈中的绝对位置定义为“发件人先签名”或“发件人后签名”。
该字段在“新模板”页面上不再可用。发件人可以选择在签名堆栈中的任意位置插入自己的位置。
用于控制总体签名流为“顺序”或“并行”的开关已被移除。
新模板风格允许可完全配置的工作流程，可以完全按顺序（签名者索引 1 到 1+N）、并行（所有签名者索引均为 1）或顺序和并行混合，此时签名索引会配置到特定的工作流程。、
v21 中已放弃使用五个设置。所有设置均位于自定义设置的 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 |
