配置 Adobe Sign for Salesforce,以针对在 Salesforce 环境外部创建的协议,发送大文档(在发送协议页面中大于 4.0 MB,批量发送时大于 9.0 MB)或推送协议

先决条件

回调用户(配置大文档和推送协议时都必需回调用户)需要两个元素:

注意:

Salesforce Professional Edition 中既不支持大文档事务也不支持推送协议。


为服务建立站点

建立大文档和推送协议服务首先需要定义回调环境。

相同的站点和用户可用于一个或两个服务。

以下说明建议建立新的专用用户以及配置文件。这将确保已知的最低限度授权的权限集有效,并建立不可能禁用而破坏功能的用户。

所需执行步骤概述:

定义回调用户

建立回调站点

配置个别服务


定义 Adobe Sign 回调用户

建议专用用户为回调过程授予对象权限。

1. 创建新的回调用户配置文件

  • 克隆“标准用户” 配置文件
    • 使用直观的名称命名新配置文件(例如:Adobe Sign 回调用户)
  • 编辑配置文件
    • 在“自定义选项卡设置”下,确保两个 “Adobe Sign 管理”选项卡都设置为默认开启
    • 确保启用这些 Visualforce 页面
      • echosign_dev1.EchosignAdmin
      • echosign_dev1.SalesforceOAuthPage
  • 保存配置文件
1_clone_standarduserprofile
2_name_the_profile

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

  • 为该用户提供一个直观的名称(例如:Adobe Sign 回调)
  • 分配 Salesforce 许可证
  • 分配您在上述步骤中创建的配置文件
4_create_a_new_user
  • 保存该新用户
  • 验证用户是否已建立已知密码

 

3. 在 Adobe Sign 中激活回调用户

通过发送协议,您将在 Adobe Sign 帐户中生成和激活用户:

  • 以回调用户身份登录至 Salesforce
  • 导航到“协议”选项卡(应用程序启动器 > 用于 Salesforce 的 Adobe Sign > 协议
  • 单击新建以打开一个新协议页面
  • 配置一个基本协议
    • 添加一个收件人 - 任何类型的任意收件人皆可,包括完全杜撰的电子邮件地址
    • 附加文件 - 任何文件皆可
  • 单击发送
send_agreement
  • 单击发送后页面上的确定以返回到“协议”
  • 单击取消按钮以取消协议

 

 

4. 将回调用户链接到 Adobe Sign

  • 导航至“Adobe Sign 管理”页面(应用程序启动器 > Adobe Sign for Salesforce > Adobe Sign 管理
  • 单击回调用户标题下的链接帐户
5_1_link_the_callbackuser

将显示“允许访问?”页面

  • 单击允许
5_4_allow_access-accept

  • 在正确链接回调用户的“Adobe Sign 管理”页面上进行验证
5_5_authenticatedcallbackuser
  • 注销 Salesforce
  • 以 Salesforce 管理员身份重新登录


建立回调站点

您必须设置并配置一个 Adobe Sign 回调站点,以便将协议更新及时推送到 Salesforce。

注意:

如果您的 Salesforce 组织中没有使用 Salesforce 站点,则必须先注册一个 Force.com 域名,以用于帐户中的所有 Salesforce 站点。(请参阅 Salesforce.com 帮助中的注册自定义 Force.com 域)。请记住,如果您要注册新域名,则建议您的域名不要太长,否则,安全 Web URL 可能会超出 Adobe Sign 对回调 URL 设定的 255 个字符的上限。

  1. 导航至设置 > 平台工具 > 用户界面 > 站点和域 > 站点
  2. 注册您的站点域名
    1. http:// 后面的文本字段中键入所需域的名称
    2. 单击检查可用性按钮以确保该域可供您使用
      1. 在您拥有可用的域后,将会显示一条“成功”消息。
    3. 接受“使用条款”,然后单击注册我的 Force.com 域按钮
站点配置面板

“站点”页面将刷新以显示您的新站点

  3. 单击新建按钮

  • 此时会加载“站点编辑”页面
Adobe Sign 回调参数

4. 在“站点编辑”页面中,执行以下操作:

  • 将“站点标签”值设为:Adobe Sign 回调
  • 将“站点名称”值设为:Adobe_Sign_Callback
  • 将“站点联系人”值设为一个将接收站点相关通知的 Salesforce 用户。在大多数情况下,该值将为帐户管理员。
  • 将“默认 Web 地址”值设为:AdobeSignCallback
  • 启用活动控件。
  • 将“活动站点主页”值设为:EchoSignCallback
    • EchoSign 是 Adobe Sign 产品的旧名称

 

这些字段应如下所示:

Adobe Sign 回调

    5. 单击保存 

 


添加站点的 IP 范围

    6. 在站点中添加公共访问设置的 IP 范围,以将其正确地限制为 Adobe Sign IP。

        a. 从回调站点的“站点详细信息”页面,单击公共访问权限设置按钮

        a. 单击登录 IP 范围链接以跳转到相应的部分

        c. 单击新建按钮

        d. 在“登录 IP 范围”对话框中,输入第一个 IP 地址范围:

○ 起始 IP 地址:52.71.63.224

○ 结束 IP 地址:52.71.63.255

○ 说明:Adobe Sign

        e. 单击保存

enter_the_ip_addressrange

注意:

如果出现错误“此 IP 范围列表不包含您当前的 IP 地址...”,请启用保存此 IP 范围,即便不包含我当前的 IP 地址选项,然后再次单击“保存”。

 

        f. 对以下所有 IP 地址范围重复上述步骤 b-e:

起始 IP

结束 IP

说明

40.67.154.249 40.67.154.249 Adobe Sign
40.67.155.112 40.67.155.112 Adobe Sign
40.67.155.147 40.67.155.147 Adobe Sign
40.67.155.185 40.67.155.185 Adobe Sign

52.35.253.64

52.35.253.95

Adobe Sign

52.48.127.160

52.48.127.191

Adobe Sign

52.58.63.192

52.58.63.223

Adobe Sign

52.196.191.224

52.196.191.255

Adobe Sign

52.65.255.192

52.65.255.223

Adobe Sign

13.126.23.0 13.126.23.31 Adobe Sign

 

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

ip_ranges


配置个别服务

配置大文档服务

发送事务和后台操作自动支持大文档,这些文档存在以下特定限制:

  • 发送事务 - 在单击“协议”页面上的“发送以请求签名”按钮时,可发送一个最大为 4.0 MB 的文档,或发送大小总计不超过 4.0 MB 的多个文档。
  • 后台操作 - 在使用后台操作发送文档时,可发送一个最大为 9.0 MB 的文档,或发送多个总大小最大为 9.0 MB 的文档。(请参阅高级自定义指南以了解有关后台操作的更多信息。)

 

要启用更大的文档,必须执行以下操作:

  • 编辑回调用户配置文件以授予额外访问权限
  • 对回调用户配置文件启用附件服务调用计数
  • 编辑站点以启用 LargeFileDownloadService Apex 类
  • 更新自定义设置以使用回调 URL


编辑回调用户配置文件

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

  • 单击“Adobe Sign 回调配置文件”页面上的编辑按钮,然后向下滚动至“自定义对象权限”
  • 启用所有协议对象权限(读取、创建、编辑、删除、查看全部、修改全部)
  • 启用 echosign_dev1. AgreementAttachmentDownloadService Apex 类
  • 单击保存
自定义对象权限


对回调用户配置文件启用附件服务调用计数

  • 导航至对象管理器 > 协议 > 字段和关系
  • 单击“字段标签”附件服务调用计数
  • 单击设置字段级别安全性按钮
  • 对回调用户配置文件启用可见只读
  • 单击保存
invocation_countsettings


编辑站点以启用 LargeFileDownloadService Apex 类

您还必须自定义自己的 Adobe Sign 回调站点的配置文件以添加 LargeFileDownloadService Apex 类使其可见

  1. 导航至设置 > 平台工具 > 用户界面 > 站点和域 > 站点
  2. 单击 Adobe Sign 回调站点的站点标签
  3. 单击公共访问设置按钮
公共访问

 

    4. 单击启用 Apex 类访问权限链接以跳转到该部分,然后单击编辑

启用 Apex 类

 

  • 从左侧的“可用的 Apex 类”列表中,选择 echosign_dev1.LargeFileDownloadService,然后单击添加以将其移到右侧的“启用的 Apex 类”列表中,如下所示。
  • 单击保存
启用 Apex 类


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

1. 导航至设置 > 用户界面 > 站点和域 > 站点

2. 单击回调站点的站点标签

自定义 URL 部分中,单击查看链接

  • 此时将打开一个新选项卡
2b_sites_configdsaved

从新选项卡中,复制浏览器中的 URL 值,并将其粘贴到一个文本文件中。

  • 如果要对沙箱进行测试,请复制 http URL 而不是 https URL。

您的 URL 应与下面显示的 URL 类似:

站点 URL

 

5. 导航至设置 > 平台工具 > 自定义代码 > 自定义设置

  • 此时将加载“自定义设置”页面

6. 单击 Adobe Sign 设置标签

  • 此时将加载“Adobe Sign 设置”页面
Adobe Sign 设置

 

7. 单击管理按钮

Adobe Sign 设置:管理

 

8.单击新建编辑

  • 此时将加载“Adobe Sign 设置编辑”页面。
Adobe Sign 设置:新建

 

9. 将“从 Adobe 到 Salesforce 站点的回调 URL”值设为在配置 Adobe Sign 回调站点后复制的“安全 Web 地址”的值(请参阅上述步骤 7)。

  • 确保地址前缀为“https”而不是“http”。
回调 URL 设置

10. 单击保存以保存您的设置。

 

现在已启用大文档服务。

配置推送协议

您可以使用 Adobe Sign API 发送协议以请求签名,或创建 Widget 并将其嵌入您的网站,然后在 Salesforce 中推送和创建所有这些协议,就好像它们是从 Salesforce 发送的一样。您还可以通过 echosign.adobe.com Web 应用程序发送协议,然后将它们全部推送回 Salesforce。

要启用这些推送协议,您必须:

  • 编辑回调用户以提供 Adobe Sign 集成用户权限集
  • 编辑回调站点以添加 EchoSignAgreementPushCallback Visualforce 页面
  • 编辑站点对象和字段级别权限
  • 任何特定于使用的配置,取决于您打算如何使用 Adobe Sign


编辑回调用户以提供 Adobe Sign 集成用户权限集

  1. 导航至设置 > 管理 > 用户 > 用户
  2. 查找回调用户,然后单击全名链接以打开“用户详细信息”页面
click_the_full_namelinkofthecallbackuser

 

3. 将鼠标置于“权限集分配” 链接上方,然后单击编辑分配按钮

edit_assigned_permissionsets

 

4. 在“可用权限集”部分中,选择 Adobe Sign 集成用户

  • 单击添加按钮
  • 单击保存
assign_permission


编辑回调站点以添加 EchoSignAgreementPushCallback Visualforce 页面

  1. 导航至设置 > 平台工具 > 用户界面 > 站点和域 > 站点
  2. 单击 Adobe Sign 回调站点的站点标签
6_click_the_sitelabel

 

3. 滚动到站点 Visualforce 页面部分,然后单击编辑

callback_vf_page

4. 找到 echosign_dev1.EchoSignAgreementPushCallback,然后单击以选中

5. 单击添加以将页面移至“启用的 Visualforce 页面”侧

6. 单击保存

callback_add_vf


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

添加 Visualforce 页面后,您会返回到回调站点的“站点详细信息”页面。

  • 单击公共访问设置打开配置文件页面
  • 单击配置文件页面上的编辑
  • 向下滚动到标准对象权限部分
  • 为以下对象启用读取创建
联系人 帐户 业务机会
潜在客户 合同  
  • 单击保存,这将返回到回调配置文件

 

有些对象还需要进行字段级别的调整:

  • 向下滚动到字段级别安全性部分并编辑:
    • 标准字段级别安全性
      • 联系人
        • 帐户 > 确保已启用“读取”和“编辑”访问权限
        • 电子邮件 > 确保已启用“读取”和“编辑”访问权限
        • 名称 > 确保已启用“读取”和“编辑”访问权限
      • 潜在客户
        • 公司 > 确保已启用“读取”和“编辑”访问权限
        • 电子邮件 -> 确保已启用“读取”和“编辑”访问权限
        • 名称 -> 确保已启用“读取”和“编辑”访问权限


使用特定配置

如果您希望将帐户中所有在 Adobe Sign 之外发送的协议创建并推送到 Salesforce 中,请按照以下说明执行操作:

  • 从您创建的 Adobe Sign 回调站点复制安全 URL 地址,并在其后附加 /echosign_dev1__EchoSignAgreementPushCallback 以构成回调 URL。联系 Adobe 支持部门并向其提供您的回调 URL,以将其设置为您的 Adobe Sign 帐户的默认回调 URL。例如:如果您的站点地址为:https://echov11-dev.na12.force.com/EchoSignCallback,回调 URL 将为:https://echov11-dev.na12.force.com/EchoSignCallback/echosign_dev1__EchoSignAgreementPushCallback
  • Adobe 支持部门还应在默认回调 URL API 用户设置中输入您的 Adobe Sign 用户 ID。使用 Salesforce 的所有帐户还应设置其帐户以将文档密钥附加到回调 URL。

 

如果您通过 API 发送协议,请按照以下说明执行操作:

  • 从您创建的 Adobe Sign 回调站点复制安全 URL 地址,并在其后附加 /echosign_dev1__EchoSignAgreementPushCallback 以创建在 Adobe Sign API 中使用的回调 URL。
    • 例如:如果您的站点地址为:https://echov11-dev.na12.force.com/EchoSignCallback
      您应在 Adobe Sign API 中使用的 URL 将为:https://echov11-dev.na12.force.com/EchoSignCallback/echosign_dev1__EchoSignAgreementPushCallback
  • 在通过 API 发送协议或创建 Widget 时,您将需要提供回调 URL(请访问 https://secure.echosign.com/redirect/latestApiMethods 并参考 API 参数“CallbackInfo”)。
  • 还请确保您的帐户设置设为将文档密钥附加到回调 URL,这应当是使用 Adobe Sign 的 Salesforce 客户的默认设置。如有任何问题,请联系 Adobe Sign 支持部门
  • 此外,请转到“推送映射设置”以定义有关在将协议推送到 Salesforce 时如何创建记录的首选项。

本产品经 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License 许可  Twitter™ 与 Facebook 中的内容不在 Creative Commons 的条款约束之下。

法律声明   |   在线隐私策略