适用于 Salesforce 的 Adobe Sign:简易签名

“简易签名”是一个易于使用的开箱即用组件,允许社区门户用户签署自助服务协议。可将此组件添加到任何 Salesforce Experience 云门户(客户、合作伙伴、员工等),也可将此组件嵌入到其他 Lightning 组件。

先决条件

要访问简易签名功能,您必须安装用于 Salesforce 的 Adobe Sign 软件包的 21.0 版本或更高版本。

对于新的安装,请您在将 Salesforce 与 Adobe Sign 建立关联时,记着要选中“生成示例协议模板”。

第 1 步 - 关联您的帐户

如果安装期间未生成模板,或者如果您已从软件包的早期版本升级到 v19,则可以通过“Adobe Sign 管理员”选项卡来生成模板。

确认“协议模板”选项卡具有测试社区协议模板:

协议模板 - 测试社区

如果您还不具备上述两点,则启用 Lightning

必须在您的 Salesforce 组织中启用 Lightning,这样门户才能正常运行。

您很有可能没有启用 Lightning,请执行以下任一操作:

  • 单击顶部选项边栏中的切换到 Lightning 链接
  • 单击您的姓名,然后从子菜单中选择切换到 Lightning Experience
切换到 Lightning


启用 Chatter

必须在您的 SFDC 组织中启用 Chatter。

如果您尚未启用 Chatter:

  • 导航至:设置 > 平台工具 > 功能设置 > Chatter > Chatter 设置
  • 单击编辑按钮
  • 选中启用复选框
  • 单击保存


启用数字体验

如果尚未启用数字体验,则将需要进行启用。

  • 导航至:设置 > 平台工具 > 功能设置 > 数字体验 > 设置
  • 选中启用数字体验复选框
  • 为您的体验提供一个域名
    • 如果您的帐户已有创建的域,则可以将相同的值用于体验
  • 单击保存
    • 当系统警告您在创建域后无法对其更改时,单击确定
启用数字体验


激活两个受信任的 CSP 站点

必须配置两个受信任的内容安全策略站点,以便将 Adobe Sign 帐户的基础 URL 明确列入允许列表

1. 查找 Adobe Sign URL 分区:

  • 登录到 Adobe Sign 并查看 URL
  • 仅复制位于 echosign.com(可能是“adobesign.com”)部分之前的参数(分区值)
    • 在此示例中,分区值为.na1:https://caseyjones.na1.echosign.com
  • 关闭该选项卡

 

2. 导航至设置 > 设置 > 安全 > 受信任的 CSP 站点

3. 单击新建受信任的站点

 

4. 按照如下所示设置相应字段:

  • 受信任的站点名称:AdobeSign
  • 受信任的站点 URL:https://secure.<分区>.adobesign.com
    • (例如,https://secure.na1.adobesign.com)
    • 如果您的帐户尚未更新到 adobesign.com 域,则可以改用 echosign.com
  • 活动:保持选中状态
  • 上下文:体验构建器站点

5. 单击保存

CSP 信任站点定义

 

6. 导航回设置 > 设置 > 安全 > 受信任的 CSP 站点

7. 单击新建受信任的站点

8. 按照如下所示设置相应字段:

  • 受信任的站点名称:AdobeSign2
  • 受信任的站点 URL:https://secure.adobesign.com
  • 活动:保持选中状态
  • 上下文:体验构建器站点

9. 单击保存

第二个 CSP 信任站点

 

完成后,CSP 站点应类似于:

CSP 信任站点


创建社区门户用户

克隆社区用户配置文件

要将您的用户配置文件配置为使用 Adobe Sign 自助服务门户,您需要编辑配置文件,这意味着需要克隆其中一个标准配置文件。

  • 导航至:设置 > 管理 > 用户 > 配置文件
  • 单击某个标准“客户社区”配置文件旁边的克隆链接
    • 共有四个“客户社区”配置文件,可使用其中的任意一个
    • 请注意您克隆的配置文件的“用户许可证”类型
  • 为克隆的配置文件提供一个直观名称,并进行保存


为社区创建帐户、联系人和用户

需要创建一个帐户、联系人和用户。

注意:

帐户所有者必须与某个角色相关联,才能启用门户用户。请确保您的 Salesforce 用户具有关联的角色(任何角色都可以)。

设置 > 管理 > 用户 > 用户 > {单击您的“全名”左侧的“编辑”链接}

要创建帐户,请执行以下操作:

  • 从“应用程序启动器”中启动销售应用程序
  • 单击“帐户”选项卡上的向下箭头,选择 + 新建帐户菜单选项

显示“新建帐户”叠加窗口时,输入“帐户名称”值,该值需明确标识此帐户为 Adobe Sign 门户帐户。

  • 这是唯一需要的值
  • 完成后单击保存

接下来,需要在帐户中创建联系人和用户:

  • 单击窗口右上方的创建图标
  • 从菜单中选择新建联系人

出现“新建联系人”叠加窗口时:

  • 输入一个有意义的名称
  • 输入联系人的电子邮件值。最好是负责管理社区门户内容的管理员的电子邮件
  • 将“联系人”关联到您在上一步中创建的 Adobe Sign 社区门户帐户
  • 单击保存
配置社区联系人

  • 打开您刚刚创建的新“联系人”页面
  • 单击窗口右上角的设置齿轮
  • 从菜单中选择编辑对象
编辑联系人对象

 

  • 从左侧边栏中选择页面布局选项
  • 编辑联系人布局

 

  • 从对象选项中选择 Mobile 和 Lightning 操作
  • 启用客户用户按钮拖动到“Salesforce Mobile 和 Lightning Experience 操作”部分
  • 以用户身份登录到体验按钮拖动到“Salesforce Mobile 和 Lightning Experience 操作”部分
  • 保存页面布局

  • 返回至社区联系人,然后单击启用客户用户按钮
启用客户用户

此时会打开“新建用户”页面,其中包含导入的联系人信息。

配置用户:

  • 将“用户许可证”设置为与您之前克隆的配置文件的许可证相匹配
  • 将“配置文件”设置为克隆的配置文件
  • 完成后单击保存

 

页面会刷新以显示新用户。

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

 

Adobe Sign 社区用户权限集添加到用户并保存


配置 SFDC 社区页面


启动新的社区

  • 导航到:设置 > 平台工具 > 功能设置 > 数字体验 > 所有站点
  • 单击新建按钮
数字体验 - 所有站点

 

  • 选择客户服务体验
    • 自助服务组件需要“客户服务”体验

 

  • 加载“客户服务”页面后,单击开始

 

  • 输入社区的名称
    • 或者,您也可以向 URL 中添加特定于站点的名称,这在您拥有多个社区时非常有用
  • 配置“名称”后,单击创建

创建社区时会显示一个令人愉快的图形。完成操作后,将会显示社区页面。

►社区名称显示在窗口顶部,以黄色突出显示

►URL 中特定于站点的字符串可以在地址栏中看到,以青绿色突出显示


配置体验工作区以启用“用户”

  • 导航到:设置 > 平台工具 > 功能设置 > 数字体验 > 所有站点
  • 单击您的社区的工作区链接
单击“工作区”

此时会加载“我的工作区”页面:

  • 单击管理选项

此时会打开您的社区的“管理”页面。

在左侧边栏中选择“设置”后:

  • 单击“状态”指示符右侧的激活按钮

 

从左侧边栏中选择成员

  • 从“搜索”下拉菜单中选择全部
  • 从“可用的配置文件”列表中选择您创建的自定义配置文件
  • 单击添加按钮,将配置文件移动到“选定的配置文件”列表
  • 单击保存按钮


将社区用户的“电子邮件”设置的“配置文件可见性”设置设为“公开”

社区的配置文件可见性部分中的电子邮件地址必须设置为公开

  • 打开您将代表其执行发送操作的用户的“联系人”页面
  • 选择以用户身份登录到体验
以用户身份登录到体验

此时会打开门户界面:

  • 单击社区页面窗口右上角的用户名称,以打开下拉窗口
  • 选择我的设置

此时会打开用户的“我的设置”页面:

  • 在“配置文件可见性”部分,将“电子邮件”值设置为公开
  • 单击保存

将“Adobe 简易签名”组件添加到工作空间

  • 导航到:设置 > 平台工具 > 功能设置 > 数字体验 > 所有站点
  • 单击您的社区中的工作区链接
  • 单击页面上“我的工作区”部分中的构建器选项
  • 单击页面左上方的“组件”图标,滚动至菜单底部,然后单击 Adobe 简易签名选项并将其拖动到页面布局中。
    • 将该组件放置到您希望公开 Adobe Sign 协议的任何位置
将简易签名拖入门户模板

 

页面会刷新以在页面布局中显示添加的组件,并在右上角呈现该组件的管理面板。

窗口右上角的管理面板只有一个可配置的选项:

协议模板 - 用于管理组件中列出的协议的模板

 

选择模板,然后单击发布按钮,以使门户可用。

  • 每次对门户或任何设置进行更改后,必须重新发布该门户

将“简易签名”代码嵌入到 Lightning 组件中

简易签名组件可以嵌入到另一个 Lightning 组件中。

该组件的示例代码:

<echosign_dev1:SimpleSign templateId="a0L190000019xUrEAI" />

 

当该组件以编程方式嵌入到另一个组件时,可以指定以下额外参数:

  • agreementId - 正在传送或草稿状态的协议的 Salesforce ID
    • 草稿协议应当配置以他人名义发送
  • templateId - 用于控制所生成协议的模板的 Salesforce ID
  • pollingInterval - 该值应该是以毫秒为单位的数字
    • 表示每次尝试获取签名 URL 之前经过的时间
      • 最小值为 500
      • 最大值为 50000
      • 默认值为 1000
  • showSigningModal
    • 如果设置为 false,则仅返回 signingURL,而不以覆盖模式加载 ESign 页面
    • 如果设置为 true,则不但会返回 signingURL,还会以覆盖模式加载 ESign 页面
    • 默认值为 true

 

参数遵循以下规则:

  • 应指定 agreementID 或 templateID
    • 如果同时指定两个值,将使用 agreementID
    • 如果不指定任何值,将返回错误
  • 在使用 agreementID 时,协议必须为草稿已发出进行签名状态,并且至少还剩余一个等待签名的收件人
    • 如果协议为草稿状态,则原样发出,抓取签名 URL 并显示出来
    • 如果协议是正在传送状态,则抓取签名 URL 并显示出来
    • 如果协议已完成,则显示并通知错误
  • 如果使用模板 templateID,则强制启用自动发送
    • 当使用 agreementID 时,则遵从模板上的自动发送设置
  • 简易签名协议模板必须联系人主对象类型
  • 强烈建议使用代表其他人发送,因为许多社区用户通常没有发送许可权

 

该组件还可以向使用者发布事件。以下是事件处理程序示例:

<aura:handler name="notifyError" event="echosign_dev1:ErrorEvent" action="{!c.onError}"/>

可用事件包括:

已发送协议

name="notifyAgreementSent" event="echosign_dev1:AgreementSentEvent" action="{!c.onAgreementSent}"

已从模板加载协议

name="notifyAgreementLoaded" event="echosign_dev1:AgreementLoadedEvent" action="{!c.onAgreementLoaded}"

已打开签名页面

name="notifySigningLoaded" event="echosign_dev1:SigningLoadedEvent" action="{!c.onSigningLoaded}"

已签名

name="notifyRecipientCompleted" event="echosign_dev1:RecipientCompletedEvent" action="{!c.onRecipientCompleted}"

未签名

name="notifyRecipientNotCompleted" event="echosign_dev1:RecipientNotCompletedEvent" action="{!c.onRecipientNotCompleted}"

在任何操作时出错

name="notifyError" event="echosign_dev1:ErrorEvent" action="{!c.onError}"


简易签名的协议模板要求

简易签名环境中的模板必须配置为根据对主对象的查找来分配收件人,并且该对象必须是联系人。

模板详情选项卡上:

  • 单击 Salesforce 对象下面的下拉列表
  • 选择从其他对象选择
    • 这样会显示一个新的下拉字段
  • 从第二个下拉字段中选择联系人

  • 单击收件人选项卡
  • 删除已在模板中的一个收件人
  • 单击从对象或运行时变量添加收件人链接
    • 此时将出现添加收件人覆盖窗口
  • 选择对象或运行时变量字段中,选择基于主对象字段的查找
    • 第一个收件人必须设置为主对象(联系人),来自主对象的源字段应该是联系人 ID
  • 单击“保存”

必须将某种类型的文件附加到模板,简易签名才能使用。“发件人附加文档”不同于活动发送流程。

  • 单击“附件”选项卡
  • 从本地系统上传文档
    • 或选择文档所在的环境(在选择添加文档部分中)。
      • 单击查找字段以查看该部分中所有可用的文档
      • 一次选择一个文档来添加到模板

附加所有文档后,单击保存

注意:

您上传的任何文件都将存储在 Salesforce(在 Salesforce CRM 和文件选项中)

如果您有未获得 Adobe Sign 许可的门户用户,则需要利用软件包中内置的“代表以下人员发送”功能,避开用户许可。这允许社区用户使用其他用户的许可生成协议。

此设置需要三个配置:

  • 在自定义设置中启用允许代表他人发送设置
  • 配置受许可用户以允许代表其用户发送
  • 使用上述用户的 Salesforce ID 配置协议模板


启用设置

  1. 导航至:设置 > 平台工具 > 自定义代码 > 自定义设置
    • 此时将加载“自定义设置”页面
  2. 单击 Adobe Sign 设置标签
    • 此时将加载“Adobe Sign 设置”页面

    3. 单击管理按钮

    4. 单击新建(如果您之前配置了设置,则单击编辑

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

5. 搜索允许代表他人发送

  • 通过选中相应的复选框以启用该设置
  • 单击保存

配置用户以代表自己发送协议

要允许用户支持代表其他人发送功能,必须向用户记录布局添加两个字段:

  • 导航至设置 > 平台工具 > 对象和字段 > 对象管理器
  • 从对象管理器选择用户
  • 从“用户”对象页面的左侧边栏中选择用户页面布局
  • 单击用户布局链接
  • 选中字段时,单击并拖动以下两个字段到布局的“其他信息(标题仅在编辑时可见)”部分
    • Adobe Sign 允许以其他用户身份发送
    • 已验证 Adobe Sign 电子邮件 
  • 单击“保存”

放置这两个字段后,启用特定用户:

  • 导航至:设置 > 管理 > 用户 > 用户
  • 单击“社区联系人”用户对应的编辑操作
  • 用户编辑页面的其他信息部分中
    • 选中 Adobe Sign 允许以其他用户身份发送选项
    • 选中 Adobe Sign 电子邮件已验证选项

用户编辑页面仍保持打开,从浏览器地址栏中的 URL 中复制用户 ID。

可在该页面的 URL 中找到用户 ID(下面以黄色突出显示的内容):

以上的 URL 为(包含以粗体显示的 ID):

https://adobedocwinter18test-dev-ed.lightning.force.com/one/one.app?source=aloha#/setup/page?nodeId=ManageUsers&address=%2F0051I000000TA5N%3F

请注意不要包含开头的 %2F 和结尾的 %3

  • 复制和保存用户 ID 以供下一步使用

 

完成后,单击保存按钮来保存配置。


使用用户 ID 更新模板

  • 导航至:应用程序启动器 > Adobe Sign > 协议模板
  • 单击要编辑的“协议模板名称”
导航至“协议模板”

单击“收件人”选项卡并编辑代表以下人员发送字段

  • 将 Salesforce 用户 ID 粘贴到该字段中(存在一个占位符 ID,您可以放心地将其删除)
  • 单击“保存”
编辑“发件人名义”


组件限制

简易签名组件有一些需要注意的限制:

 

1. 在配置该模板时不能启用仅发件人签名

○ 在这种情况下,社区用户将看到当前用户没有签名 URL 的错误

2. 模板可能没有选中启用预览和位置字段选项

○ 在这种情况下,协议保持预发送状态,且不会加载签名 URL

3. 模板可能没有选中启用托管签名选项

4. 简易签名不支持委派

○ 在这种情况下,另一位收件人无法访问签名 URL

5. 简易签名不支持更换签名者(这是一种形式的委派)

○ 在这种情况下,新签名者无法访问签名 URL

6. 要访问任何 Salesforce 对象的备注和附件,管理员必须启用社区设置中的允许客户用户访问备注和附件

Adobe 徽标

登录到您的帐户