用户指南 取消(C)

用于 Salesforce 的 Adobe Sign:使用进程构建器实现自动工作流程

  1. Adobe Acrobat Sign 集成
  2. 新增功能
  3. 产品版本和生命周期
  4. Acrobat Sign for Salesforce
    1. 安装指南
    2. 用户指南
    3. 开发人员指南
    4. 高级自定义指南
    5. 字段映射和模板指南
    6. Process Builder 指南
    7. Document Builder 指南
    8. 升级指南
    9. 发行说明
    10. 故障排除指南
    11. 其他文章
  5. Acrobat Sign for Microsoft
    1. Acrobat Sign for Microsoft 365
      1. 安装指南
    2. 适用于 Outlook 的 Acrobat Sign
      1. 用户指南
    3. 适用于 Word/PowerPoint 的 Acrobat Sign
      1. 用户指南
    4. Acrobat Sign 团队版
      1. 用户指南
      2. 发行说明
      3. Microsoft Teams 审批
    5. 适用于 Microsoft PowerApps 和 Power Automate 的 Acrobat Sign
      1. 用户指南
      2. 发行说明
    6. 适用于 Microsoft Search 的 Acrobat Sign 连接器
      1. 用户指南
    7. 适用于 Microsoft Dynamics 的 Acrobat Sign
      1. 概述
      2. Dynamics Online:安装指南
      3. Dynamics Online:用户指南
      4. Dynamics 内部部署版:安装指南
      5. Dynamics 内部部署版:用户指南
      6. Dynamics 工作流程指南
      7. Dynamics 365 for Talent
      8. 升级指南
      9. 发行说明
    8. 适用于 Microsoft SharePoint 的 Acrobat Sign
      1. 概述
      2. SharePoint On-Prem:安装指南
      3. SharePoint On-Prem:模板映射指南
      4. SharePoint On-Prem:用户指南
      5. SharePoint On-Prem:发行说明
      6. SharePoint Online:安装指南
      7. SharePoint Online:模板映射指南
      8. SharePoint Online:用户指南
      9. SharePoint Online:Web 表单映射指南
      10. SharePoint Online:发行说明
  6. Acrobat Sign for ServiceNow
    1. 概述
    2. 安装指南
    3. 发行说明
  7. 适用于 HR ServiceNow 的 Acrobat Sign
    1. 安装指南
  8. 适用于 SAP SuccessFactors 的 Acrobat Sign
    1. 主控室安装指南
    2. 招聘管理安装指南
    3. 招聘管理用户指南
    4. Cloud Foundry 安装指南
  9. 适用于 Workday 的 Acrobat Sign
    1. 安装指南
    2. 快速入门指南
    3. 配置教程
  10. 适用于 NetSuite 的 Acrobat Sign
    1. 安装指南
    2. 发行说明
  11. 适用于 SugarCRM 的 Acrobat Sign
  12. 适用于 VeevaVault 的 Acrobat Sign
    1. 安装指南
    2. 用户指南
  13. 适用于 Coupa BSM Suite 的 Acrobat Sign
    1. 安装指南
  14. Acrobat Sign 开发人员文档
    1. 概述
    2. Webhook
    3. 文本标记

概述

Salesforce 中的进程构建器是一个图形点击工具,可允许您根据 Salesforce 环境中的触发事件,自动编排要采取的措施。

进程是围绕 if/then 类型的逻辑流而构建的,进程包含一个触发事件、至少一个条件,以及至少一个可能实时发生和/或作为预定事件发生的操作

Adobe Sign 支持两种操作类型:更新记录和 Apex

每种操作类型都有若干可调用的操作

  • 发送
  • 取消
  • 删除
  • 提醒
  • 更新
  • 加载(模板)仅在使用 Apex 操作类型时可用

进程构建器是一个非常强大的工具,关于其工作方式的完整描述,超出了本文档的范围。

本文档将重点介绍通过用于 Salesforce 的 Adobe Sign 软件包 v20 可以执行的操作。

如果您想了解有关进程构建器的更多信息,请参阅 Salesforce 提供的文档交互式 Trailhead


使用“更新记录”作为操作类型的进程

此方法使用 Salesforce 进程构建器中的“更新记录”操作类型,来设置协议记录上的“后台操作”选择列表字段,以调用操作。

可以创建新进程(触发点是记录更改事件),随后可调用针对相关 Adobe Sign 协议的操作。用户可以控制触发操作的具体时间(例如,在主记录上的哪个字段更新后)和选定执行该操作的相关协议。

 

目前支持以下操作:

  • 发送
  • 取消
  • 删除
  • 提醒
  • 更新

注意事项:

  • 处理进程期间检测到的任何错误将存储在错误消息字段中,您可以在相应的协议页面上查看
  • 支持安排的操作
  • 支持 Adobe Sign 库文档
  • 可以选择一个或多个父协议或子协议
  • 在更新协议记录时,相关记录是 echosign_ dev 对象
    • echosign_ dev 对象与常用的 Salesforce 对象(帐户、业务机会、联系人等)关联。如果协议与某个自定义对象相关,则该名称在组织中是唯一的。

  • 通过使用相应的操作值更新协议记录上的后台操作选择列表字段,可触发相关操作

限制:
  • 必须已经存在协议记录。不能使用“更新记录”操作类型从协议模板创建或加载


使用 Apex 作为操作类型的进程

此方法使用 Salesforce 进程构建器中的 Apex 操作类型,调用与托管软件包随附在一起的“可调用方法”,以执行相应的操作。

可以创建新进程(触发点是记录更改事件),随后可调用针对相关 Adobe Sign 协议的操作。

已定义下面几个可调用的操作:

  • 协议模板加载可调用操作
    • AgreementTemplateLoadInvocableAction.load
      • 传入模板和主记录 ID 以及所有运行时变量。
      • 传入可选参数以控制模板生成是否在异步模式下运行
        • 如果模板包含 Adobe Sign 库中的文档,则需要提供该参数
      • 返回生成的协议记录 ID 或任何错误消息
        • 执行触发操作时,用户无法看到错误

在调用加载协议类型类时,有四个字段选项可供配置:

  • 主记录 ID - 协议应与之建立关系的对象的 Salesforce 记录 ID。
    • 通常将类型设置为“字段引用”,将值设置为“[Object]. Id”,其中“Object”指的是业务机会、帐户等。
  • 协议模板 ID - 要加载的协议模板的 Salesforce 记录 ID。将类型设置为“ID”,将值设置为“记录 ID”
  • 协议模板运行时变量- 变量中的收件人和/或文档。
    • 一个变量:myRecipient=auserguy@adobe.com 
    • 两个变量:myRecipient=auserguy@adobe.com,myAttachment=00Pf4000002df0q
  • 异步处理 -可选项,除非需要,否则不指定该选项。默认情况下,此项设置为 False,这样将在同步模式下调用模板(例如,相同的事务/线程)
    • 如果协议模板加载了 Adobe Sign 库文档,则设置为 True
    • 如果模板的 AutoSend 为 True,请确保上述值为 False
    • 不能将自动发送与 Adobe Sign 库文档一同使用
    • 如果从批处理或其他异步进程调用该进程,请注意 Salesforce 的内置限制

 

  • 协议取消可调用操作
    • AgreementCancelInvocableAction.cancelAgreement
      • 传入协议 ID
      • 返回所有错误消息
  • 协议删除可调用操作
    • AgreementDeleteInvocableAction.deleteAgreement
      • 传入协议 ID
      • 返回所有错误消息
  • 协议提醒可调用操作
    • AgreementRemindInvocableAction.sendReminder
      • 传入协议 ID
      • 返回所有错误消息
  • 协议发送可调用操作
    • AgreementSendInvocableAction.sendAgreement
      • 传入协议 ID
      • 返回所有错误消息
  • 协议更新可调用操作
    • AgreementUpdateInvocableAction.updateAgreement
      • 传入协议 ID
      • 返回所有错误消息

对于“取消”、“删除”、“提醒”、“发送”“更新”操作,只需提供要执行操作的协议所对应的协议 ID


注意事项:

  • 支持安排的操作
  • 支持具有自动发送功能的协议模板(例如,生成并发送)
  • 在一次调用中,所有操作可接受多个请求
  • 可以捕获任何异常情况,并存储在结果记录中,然后在 Apex 调试日志中记录为错误,以避免阻止进程执行。
  • 模板加载”函数(异步处理)的参数可用来控制是在同步模式还是异步模式下处理模板。调用者需要指定模板加载应该在同步模式还是异步模式下运行
    • 默认情况下,进程在同步模式下运行。如果是批量进程,则应当同步运行
    • 如果启用自动发送,则进程必须使用同步模式
    • 如果需要加载 Adobe Sign 库文档,则显然是异步进程。

 

限制:

  • 由于 Salesforce 中存在的限制,即一个线程无法启动另一线程,因此不支持组合使用“自动发送”模板和“Adobe Sign 库文档
  • 对于传入可调用操作的任何参数,只能引用父字段(而非子字段)。不能对主记录下的子协议执行操作
  • Apex 调用的返回值不能用在进程构建器中。不支持任何具有返回值的操作(例如,获取文档信息或获取签名 URL)。


可列队的服务

已经实施了新的服务层,以通过 Salesforce 可列队的界面调用协议操作。有关“可列队的服务”的更多信息,可单击此处查看。这些操作可以调用核心服务 API,然后调用 Adobe Sign API。

支持以下操作:

  • 发送
  • 取消
  • 删除
  • 提醒
  • 更新

全局 echosign_dev1.AdobeSignApiQueueableService 是服务 Apex 类,可接受的类型参数为 echosign_dev1.QueueableServiceParameter,其中包含要调用的操作和协议记录 ID:

 

echosign_dev1.AdobeSignApiQueueableService.QueueableServiceParameter param = new echosign_dev1.AdobeSignApiQueueableService.QueueableServiceParameter();

param.actionType = EchoSignApiService.ACTION_TYPE.AGREEMENT_REMIND;
param.agreementId = 'a0I0S000000KwkaUAC';

ID jobID = System.enqueueJob(new echosign_dev1.AdobeSignApiQueueableService(param));
Adobe 徽标

登录到您的帐户