用户指南取消(C)

配置大文档并推送协议服务

搜索

上次更新日期： 2023年9月6日 | 也应用至 Adobe Acrobat Sign

Adobe Acrobat Sign 集成
新增功能
产品版本和生命周期
Acrobat Sign for Salesforce
Acrobat Sign for Microsoft
1. Acrobat Sign for Microsoft 365
  1. 安装指南
2. 适用于 Outlook 的 Acrobat Sign
  1. 用户指南
3. 适用于 Word/PowerPoint 的 Acrobat Sign
  1. 用户指南
4. 适用于 Teams 的 Acrobat Sign
5. 适用于 Microsoft PowerApps 和 Power Automate 的 Acrobat Sign
  1. 用户指南
  2. 发行说明
6. 适用于 Microsoft Search 的 Acrobat Sign 连接器
  1. 用户指南
  2. 发行说明
7. 适用于 Microsoft Dynamics 的 Acrobat Sign
8. 适用于 Microsoft SharePoint 的 Acrobat Sign
Acrobat Sign for ServiceNow
适用于 HR ServiceNow 的 Acrobat Sign
1. 安装指南（已弃用）
适用于 SAP SuccessFactors 的 Acrobat Sign
适用于 Workday 的 Acrobat Sign
适用于 NetSuite 的 Acrobat Sign
1. 安装指南
2. 发行说明
适用于 SugarCRM 的 Acrobat Sign
适用于 VeevaVault 的 Acrobat Sign
适用于 Coupa BSM Suite 的 Acrobat Sign
1. 安装指南
Acrobat Sign for Zapier
Acrobat Sign 开发人员文档

概述

适用于 Salesforce 的 Adobe Acrobat Sign：大文档和推送协议服务指南介绍了如何配置适用于 Salesforce 的 Acrobat Sign，以针对在 Salesforce 环境外部创建的协议，发送大文档（从发送协议页面发送时大于 4.0 MB，批量发送时大于 9.0 MB）或推送协议。

要建立和使用“大文档”和“推送协议”服务，您必须定义回调环境。回调环境可用于一或两种服务。回调环境要求您创建一个新的专用用户和配置文件，以确保：

已知的最低授权权限集有效。
此功能不会因禁用用户而中断。

要建立回调环境并使用“大文档”和“推送协议”服务，您必须完成以下步骤：

验证先决条件

您必须已安装适用于 Salesforce 的 Adobe Acrobat Sign 包。
您必须已配置我的域，以允许回调用户的 OAuth 身份验证。

注意:

Salesforce 专业版不支持大文档交易或推送协议。

定义回调用户

您必须创建一个专用用户才能为回调过程授予对象权限。具体操作如下：

使用管理员凭据登录适用于 Salesforce 的 Acrobat Sign 帐户。
导航至设置 > 管理 > 用户 > 配置文件。
查找用户配置文件列表中的标准用户，然后为列表选择克隆。
在打开的克隆配置文件页面中，提供一个配置文件名称，然后选择保存。

此处的示例配置文件使用“Demo callback user”作为配置文件名称。
请按照以下步骤，使用标准 Salesforce 许可证创建新用户：
1. 在左侧面板中，选择用户。
2. 在“用户”页面上，选择新建用户。
3. 在新用户页面上，为用户提供一个直观的名称，分配 Salesforce 许可证，并分配您在上述步骤中创建的配置文件。选择保存。
按照以下步骤，将“Adobe Acrobat Sign 集成用户”权限集添加至回调用户：
1. 导航至设置 > 管理 > 用户 > 用户。
2. 选择回调用户的全名链接。
3. 将鼠标悬停在权限集任务上，然后选择编辑任务。
在权限集任务页面，执行以下操作：
1. 在可用权限集下，选择 Adobe Acrobat Sign 集成用户。
2. 选择添加可将权限集移入已启用列。
3. 选择保存。
按照与您正在使用的环境对应的步骤，将用户链接到 Acrobat Sign。
以新创建的回调用户身份登录。

导航至应用程序启动器 > Adobe Acrobat Sign 管理员。

在回调用户下，选择链接帐户。

在允许访问对话框中，选择允许。
它提示您再次登录您的 Salesforce 帐户。

登录后，请转到 Adobe Acrobat Sign 管理员页面，并确认已链接回调用户。
使用标准系统管理员配置文件登录适用于 Salesforce 的 Acrobat Sign 帐户。

在“适用于 Salesforce 的 Sign”Lightning 页面上，选择 Adobe Acrobat Sign 管理员选项卡。

在回调用户下，选择链接帐户。

在允许访问对话框中，选择不是你？

在 Salesforce 登录页面上，输入回调用户的凭据，然后登录。

您将返回至 Adobe Acrobat Sign 管理员页面。验证回调用户是否已链接。

建立回调站点

Commercial Cloud 上的 Acrobat Sign 管理员必须专门为 Adobe Acrobat Sign 回调建立和配置站点。此设置可确保及时将协议更新推送到 Salesforce，并轻松下载大文档。请注意，推送协议功能不适用于政府云用户。

注意:

在组织中使用 Salesforce 站点之前，您必须注册 Force.com 域，用于您帐户中的所有 Salesforce 站点。选择域名时，请保持较短的长度，以防止超过 Adobe Acrobat Sign 对回调 URL 255 个字符的限制。

使用顶部的“搜索设置”栏搜索站点，然后从搜索结果中选择站点。或者，导航至设置 > 平台工具 > 用户界面 > 站点和域 > 站点。
如果要使用已注册的站点，可以跳过此步骤。

或者，按照以下步骤注册您的站点域名：
1. 在 https:// 后面的文本字段中输入所需的域名
2. 选择检查可用性以确保该域可用。在您拥有可用的域后，将会显示一条成功消息。
3. 接受使用条款，然后选择注册我的 Force.com 域。
在刷新之后的页面上，选择新建。
在站点编辑页面上，执行以下操作：
1. 将站点标签值设为 Adobe Acrobat Sign 回调。
2. 选择站点名称字段。它将值自动设置为 Adobe_Acrobat_Sign_Callback。
3. 将站点联系人值设为一个将接收站点相关通知的 Salesforce 用户。在大多数情况下，该值是帐户管理员。
4. 将默认 Web 地址值设为 AdobeAcrobatSignCallback。
5. 选中活动复选框。
6. 将活动站点主页值设为 EchoSignCallback。
  EchoSign 是 Adobe Acrobat Sign 的旧名称。
7. 选择保存。

在站点中添加公共访问权限设置的 IP 范围，以将其限制为 Adobe Acrobat Sign IP。具体操作如下：

从回调站点的站点详细信息页面中，选择公共访问权限设置。
选择登录 IP 范围。
选择新建。
在“登录 IP 范围”对话框中，输入第一个 IP 地址范围：
- 起始 IP 地址：52.71.63.224
- 结束 IP 地址：52.71.63.255
- 描述：Acrobat Sign
选择保存。
对于下表中的 IP 地址范围，请重复步骤 2-5。

要确定与您的区域关联的 IP 范围，请根据您使用的环境，参考以下 IP 地址列表之一：

示例 IP 地址范围列表：

起始 IP	结束 IP	说明
13.126.23.0	13.126.23.31	Adobe Acrobat Sign
3.236.206.64	3.236.206.95	Adobe Acrobat Sign
40.67.154.249	40.67.154.249	Adobe Acrobat Sign
40.67.155.112	40.67.155.112	Adobe Acrobat Sign
40.67.155.147	40.67.155.147	Adobe Acrobat Sign
40.67.155.185	40.67.155.185	Adobe Acrobat Sign
44.234.124.128	44.234.124.159	Adobe Acrobat Sign
51.105.221.160	51.105.221.191	Adobe Acrobat Sign
52.196.191.224	52.196.191.255	Adobe Acrobat Sign
52.35.253.64	52.35.253.95	Adobe Acrobat Sign
52.48.127.160	52.48.127.191	Adobe Acrobat Sign
52.58.63.192	52.58.63.223	Adobe Acrobat Sign
52.65.255.192	52.65.255.223	Adobe Acrobat Sign
52.71.63.224	52.71.63.255	Adobe Acrobat Sign

Adobe Acrobat Sign 回调站点的最终登录 IP 范围应当如下所示：

注意:

如果您收到“此 IP 范围列表不包含您当前的 IP 地址...”错误，请启用保存此 IP 范围，即使它不包括我当前的 IP 地址选项，然后选择保存。

配置单个服务

大文档可提供发送事务和背景操作的默认支持，每个文档都有它自己的大小限制，如下所示：

发送事务— 您可以通过“协议”页面上的“发送以供签名”选项，发送单个文档或多个文档，总大小不得超过 4.0 MB。
背景操作 — 允许发送单个文档或多个文档，总大小不得超过 9.0 MB。有关更多详细信息，请参阅高级自定义指南。

要启用发送大文档，必须完成以下步骤：

编辑回调用户配置文件以授予额外访问权限。
启用 LargeFileDownloadService Apex 类用于站点。
更新自定义设置以使用回调 URL.

编辑回调用户配置文件

要启用 Adobe Acrobat Sign 回调站点用户的对象级别权限，请执行以下操作：

导航到“配置文件”页面，然后为您创建的回调用户（本示例中为“演示回调用户”），选择编辑。
向下滚动至自定义对象权限，然后启用所有协议对象权限：读取、创建、编辑、删除、查看全部、修改全部。
选择保存。

启用 LargeFileDownloadService Apex 类

您必须调整 Adobe Acrobat Sign 回调站点，以包括“LargeFileDownloadService”Apex 类，从而实现可见性。

以下说明与增强的配置文件界面一致。有关配置文件界面的详细信息，请参见 Salesforce配置文件的

使用顶部的“搜索设置”栏搜索站点，然后从搜索结果中选择站点。或者，导航至设置 > 平台工具 > 用户界面 > 站点和域 > 站点。
选择 Adobe Acrobat Sign 回调站点。
选择公共访问权限设置。
选择启用 Apex 类访问权限，然后选择编辑。
从左侧的可用 Apex 类列表，选择 echosign_dev1.LargeFileDownloadService，然后选择添加以将其移至启用的 Apex 类列表。然后，选择保存。

更新自定义设置以使用回调 URL

使用顶部的“搜索设置”栏搜索站点，然后从搜索结果中选择站点。

或者，导航至设置 > 用户界面 > 站点和域 > 站点。
选择 Adobe Acrobat Sign 回调。
在自定义 URL 部分下，选择视图。
从打开的新选项卡中，复制浏览器中的 URL 值，并将其粘贴到一个文本文档中。
URL 应类似于：https://<my-domain>.my.salesforce-sites.com/AdobeSignCallback
导航至设置 > 平台工具 > 自定义代码 > 自定义设置。
对于 Adobe Sign 设置标签，请选择管理 > 编辑或新建。
在 Adobe Acrobat Sign 设置编辑页面：
1. 在 Salesforce 站点的 Adobe 回调 URL 字段中，粘贴您在配置 Adobe Acrobat Sign 回调站点后复制的“安全 Web 地址”URL。
  确保地址前缀为“https”而不是“http”。
2. 选择保存。
它启用大文档服务。

Acrobat Sign API 允许您发送签名请求、创建 Web 窗体并将它们嵌入您的网站。然后，在 Salesforce 中推送和创建这些协议，就像直接从其中调度一样。您还可以通过 adobesign.com Web 应用程序发送协议，然后这些协议将同步回 Salesforce。

要启用推送协议，请执行以下操作：

添加“EchoSignAgreementPushCallback”Visualforce 页面至回调站点。
编辑站点对象和字段级别权限。
或者，添加特定配置。

注意:

要使推送回调协议在 Webhook 2.0 迁移后能够正常运行，必须添加 Webhook IP 地址到站点回调用户配置文件。

添加“EchoSignAgreementPushCallback”Visualforce 页面至回调站点

使用顶部的“搜索设置”栏搜索站点，然后从搜索结果中选择站点。

或者，导航至设置 > 平台工具 > 用户界面 > 站点和域 > 站点。
选择 Adobe Acrobat Sign 回调。
向下滚动至站点 Visualforce 页面部分，然后选择编辑。
在启用 Visualforce 页面访问页面：
1. 从可用的 Visualforce 页面列表中，找到并选择 echosign_dev1.EchoSignAgreementPushCallback。
2. 选择添加。
  此操作会将页面移动到启用的 Visualforce 页面。
3. 选择保存。

编辑站点对象和字段级别权限

添加 Visualforce 页面后，您会返回到回调站点的站点详细信息页面。请按照以下步骤编辑页面：

选择公共访问权限设置。
在 Adobe Acrobat Sign 回调配置文件页面上，选择编辑。
向下滚动到标准对象权限部分.
针对以下对象启用读取和创建：帐户、联系人、合同、商机和机会。
选择保存。
此时将返回到回调配置文件。
要在必要时进行字段级别调整，请向下滚动至字段级别安全性部分，然后按所述编辑以下字段的设置：
- 联系人
  - 帐户：确保选中读取访问权限和编辑访问权限复选框。
  - 电子邮件：确保选中读取访问权限和编辑访问权限复选框。
  - 名称：确保选中读取访问权限和编辑访问权限复选框。
- 潜在客户
  - 公司：确保选中读取访问权限和编辑访问权限复选框。
  - 电子邮件：确保选中读取访问权限和编辑访问权限复选框。
  - 名称：确保选中读取访问权限和编辑访问权限复选框。

添加特定配置

要创建您帐户中所有在 Acrobat Sign 之外发送的协议并传输至 Salesforce，请执行以下步骤：

从您创建的 Acrobat Sign 回调站点复制安全 URL 地址，并在其后附加 /echosign_dev1__EchoSignAgreementPushCallback 以构成回调 URL。
联系 Adobe 支持部门并向其提供您的回调 URL，以将其设置为您的 Adobe Acrobat Sign 帐户的默认回调 URL。

示例：如果您的站点地址为 https://<MyDomain>.my.salesforce-sites.com/AdobeSignCallback，您的 Acrobat Sign API URL 则应为：https://<MyDomain>.my.salesforce-sites.com/AdobeSignCallback/echosign_dev1__EchoSignAgreementPushCallback。

Adobe 支持部门必须在默认回调 URL API 用户设置中输入您的 Adobe Acrobat Sign 用户 ID。确保设置了所有 Salesforce 帐户，以将文档密钥添加到回调 URL。

如需通过 API 发送协议：

从您创建的 Adobe Sign 回调站点复制安全 URL，并在其后附加 /echosign_dev1__EchoSignAgreementPushCallback 以创建 Adobe Acrobat Sign API 的回调 URL。

示例：如果您的站点地址为 https://<MyDomain>.my.salesforce-sites.com/AdobeSignCallback，您的 Acrobat Sign API URL 则应为：https://<MyDomain>.my.salesforce-sites.com/AdobeSignCallback/echosign_dev1__EchoSignAgreementPushCallback
当通过 API 发送协议或创建 Web 表单时，您必须提供回调 URL。
请参阅当前的 Acrobat Sign Document API 方法并参阅 API 参数“CallbackInfo”。
确保您的帐户设置设为将文档密钥附加到回调 URL，这应当是使用 Adobe Sign 的 Salesforce 客户的默认设置。
如有任何问题，请联系 Adobe 支持部门。
请转到推送映射设置以定义有关在将协议推送到 Salesforce 时如何创建记录的首选项。

更快、更轻松地获得帮助

新用户？