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

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

先决条件

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

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

link-accounts

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

generate-self-sign-template

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

verify-test-community-agreement

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

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

要启用 Lightning 界面,请执行以下操作:

  • 从顶部菜单中,选择切换到 Lightning,或者
  • 选择您的姓名,然后从下拉菜单中选择切换到 Lightning Experience
切换到 Lightning


启用 Chatter

必须在您的 SFDC 组织中启用 Chatter。具体操作如下:

  1. 导航至:设置 > 平台工具 > 功能设置 > Chatter > Chatter 设置.
  2. 选择编辑
  3. 选中启用复选框。
  4. 选择保存


启用数字体验

要启用数字体验,请执行以下操作:

  1. 导航至设置 > 平台工具 > 功能设置 > 数字体验 > 设置。
  2. 选中启用数字体验复选框。
  3. 为您的体验提供一个域名.
    如果您的帐户已有创建的域,则可以将相同的值用于体验.
  4. 选择保存
  5. 此时将出现一个对话框,警告您一旦创建域后就无法更改,请选择确定
启用数字体验


激活两个受信任的 CSP 站点

您必须配置两个受信任的 CSP(内容安全策略)站点,以允许您的 Adobe Acrobat Sign 帐户使用基本 URL。具体操作如下:

  1. 按如下步骤获取 Acrobat Sign 帐户分区值:

    1. 登录到您的 Adobe Acrobat Sign 帐户。
    2. 从 URL 中,仅复制位于 echosign.com(也可能是 adobesign.com)部分之前的参数(分区值)。 
      例如,URL https://caseyjones.na1.echosign.com的分区值为na1。
    3. 关闭该选项卡.

    了解如何识别 Adobe Acrobat Sign 帐户环境

    global-settings

  2. 导航至设置 > 设置 > 安全性 > CSP 受信任站点,然后选择新建受信任站点

    csp-trusted-sites

  3. 在打开的“新站点定义”页面中,按如下要求填写必填字段:

    1. 受信任站点名称 - 提供一个名称,如 AcrobatSign
    2. 受信任站点 URL - 输入站点 URL https://secure.<shard>.adobesign.com
      例如,https://secure.na1.adobesign.com
      如果您的帐户未更新到 adobesign.com 域,则可以改用 echosign.com
    3. 选中活动复选框。
    4. 上下文 - 选择用于上下文的 Experience Builder 站点。
    5. 选中 CSP 指令允许 frame-src 站点复选框。
    6. 选择保存
    csp-trusted-site-definition

  4. 导航回设置 > 设置 > 安全性 > CSP 受信任站点,然后选择新建受信任站点

  5. 在打开的“新站点定义”页面中,按如下要求填写必填字段:

    1. 受信任站点名称 - 提供一个名称,如 AcrobatSign2
    2. 受信任站点 URL - 输入站点 URL https://secure.adobesign.com
    3. 选中活动复选框。
    4. 上下文 - 选择用于上下文的 Experience Builder 站点。
    5. 选中 CSP 指令允许 frame-src 站点复选框。
    6. 选择保存
    第二个 CSP 信任站点

  6. 验证两个 CSP 受信任站点。

    CSP 信任站点


创建社区门户用户

克隆社区用户配置文件

要将您的用户配置文件配置为使用 Adobe Acrobat Sign 自助服务门户,您必须克隆并编辑其中一个标准配置文件。具体操作如下:

  1. 导航至设置 > 管理 > 用户 > 配置文件

  2. 对于任何标准客户配置文件,请选择克隆

    有四个客户社区配置文件,您可以使用任意一个来克隆和创建用户配置文件。 请注意您克隆的配置文件的用户许可证类型。

    setup-profiles

  3. 为克隆的配置文件提供一个直观的名称,然后选择保存

    cloned-profile-name

  4. 在打开的“克隆的配置文件”页面上,选择编辑

    cloned-profile-edit

  5. 在“自定义编辑”页面上,向下滚动至自定义对象权限并启用所有 Adobe Acrobat Sign 对象。您可以选中全部修改复选框或仅选择增加安全性所需的权限。

    cloned-prodile-custom-object-permissions


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

您必须为社区创建一个帐户、联系人和用户。 

帐户所有者必须与某个角色相关联,才能启用门户用户。要将某个角色与 Salesforce 用户相关联,请转至设置 > 管理 > 用户 > 用户。接下来,从用户列表中,为相应用户选择编辑,然后在打开的页面中,打开角色下拉菜单 > 选择一个角色 > 选择保存

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

  1. 从应用程序启动器中启动 Sales 应用程序。

  2. 打开帐户下拉菜单,然后选择 +新建帐户

    sales-new-account

  3. 在打开的新建帐户页面中,输入一个帐户名称值,然后选择保存

    帐户名称应将该帐户标识为 Adobe Acrobat Sign 门户帐户。帐户名称是您需要在此处提供的唯一值。

    sales-new-account-details


配置 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,而不以覆盖模式加载 e-Sign 页面
    • 如果设置为 true,则不但会返回 signingURL,还会以覆盖模式加载 e-Sign 页面
    • 默认值为 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 徽标

登录到您的帐户