Salesforce模块

在Adobe Workfront Fusion场景中,您可以自动使用Salesforce的工作流,并将其连接到多个第三方应用程序和服务。

有关Salesforce连接器的视频介绍,请参阅:

如果需要有关创建方案的说明,请参阅在 Adobe Workfront Fusion中创建方案。

有关模块的信息,请参阅 Adobe Workfront Fusion🔗中的模块。

NOTE
  • 并非所有版本的Salesforce都具有API访问权限。 有关详细信息,请参阅Salesforce社区网站上有关具有API访问权限的Salesforce版本的信息。
  • 有关从Salesforce API返回的特定错误的信息,请参阅Salesforce API文档。 您还可以检查Salesforce API的状态以确定任何可能的服务中断。

访问要求

您必须具有以下权限才能使用本文中的功能:

Adobe Workfront 计划*
Pro或更高版本
Adobe Workfront 许可证*
计划,工作
Adobe Workfront Fusion 许可证**

当前许可证要求:无Workfront Fusion许可证要求。

旧版许可证要求:Workfront Fusion for Work Automation and Integration

产品

当前产品要求:如果您有Select或Prime Adobe Workfront计划,则贵组织必须购买Adobe Workfront Fusion和Adobe Workfront才能使用本文中描述的功能。 Workfront Fusion包含在Ultimate Workfront计划中。

旧版产品要求:您的组织必须购买Adobe Workfront Fusion和Adobe Workfront,才能使用本文中介绍的功能。

要了解您拥有什么计划、许可证类型或访问权限,请与Workfront管理员联系。

有关Adobe Workfront Fusion许可证的信息,请参阅Adobe Workfront Fusion 许可证

先决条件

要使用Salesforce模块,您必须具有Salesforce帐户。

Salesforce API信息

Salesforce连接器使用以下对象:

基本URL
{{connection.instanceUrl}}
API版本
v46.0
API标记
v1.15.14

关于搜索Salesforce对象

在搜索对象时,您可以输入单个搜索词,也可以使用通配符和运算符创建更复杂的查询:

  • 使用星号通配符(*)代替零个或多个字符。 例如,搜索Ca*会查找以Ca开头的项目
  • 使用问号通配符(?) 作为单个字符的替代。 例如,搜索Jo?n将查找词为John或Joan但不包含Jon的项目
  • 使用引号运算符(“ ”)查找精确匹配的短语。 例如:“星期一会议”

有关搜索可能性的更多信息,请参阅有关SOQL和SOSL的Salesforce开发人员文档。

Salesforce模块及其字段

触发器

观看记录

此触发器模块在创建或更新对象中的记录时执行场景。 该模块返回与一个或多个记录关联的所有标准字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
类型
选择要模块监视的Salesforce记录的类型。
记录字段
选择您希望模块监视的字段。 可用字段取决于记录类型。
最大记录数
输入或映射您希望模块在每个方案执行周期内返回的最大记录数。
监视
确定您希望方案仅监视所选类型的新记录,还是只监视所选类型的新记录以及该类型记录的所有其他更改。

观看出站消息

此触发器模块会在有人发送消息时执行场景。 该模块返回与一个或多个记录关联的所有标准字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

此模块需要一些额外的设置:

  1. 转到Salesforce设置页面。

    要访问设置页面,请找到并单击Salesforce帐户右上角标记为“设置”的按钮。 从Salesforce设置页面中,找到左侧的“快速查找/搜索”栏。 搜索“工作流规则”。

  2. 单击​ 工作流规则

  3. 在显示的工作流规则页面上,单击​ 新建规则,然后选择该规则将应用到的对象类型(例如,如果您正在监视对Opportunity记录的更新,则为“Opportunity”)。

  4. 单击​ 下一步

  5. 设置规则名称、评估标准和规则条件,然后单击​ 保存 ​和​ 下一步

  6. 单击​ 完成

  7. 在新创建的工作流规则中,单击​ 编辑

  8. 从​ 添加工作流操作 ​下拉列表中,选择​ 新建出站消息

  9. 指定名称、描述、端点URL以及要包括在新出站消息中的字段,然后单击​ 保存

    终结点URL ​字段包含在Workfront Fusion中的Salesforce 出站消息上提供的URL。

  10. 配置以出站消息事件开头的方案。

  11. 单击右下角的​ </> ​图标,并复制提供的URL。

  12. 返回​ 工作流规则 ​页面,找到新创建的规则,然后单击​ 激活

配置此模块时,会显示以下字段。

Webhook

选择要用于监视传出消息的webhook。 要添加webhook,请单击 添加 并输入webhook的名称和连接。

有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明

记录类型
选择您希望模块监视传出消息的Salesforce记录的类型。
字段
选择您希望模块监视传出消息的字段。 可用字段取决于记录类型。

观看字段

此触发器模块在Salesforce中更新字段时启动方案。

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
记录类型
选择记录类型,其中包含您希望模块监视的字段。 您必须选择在Salesforce设置中启用了字段历史记录的记录类型。 有关详细信息,请参阅Salesforce文档中的字段历史记录跟踪
字段
选择您希望模块关注更改的字段。
限制
输入或映射您希望模块在每个方案执行周期中返回的最大字段数。

操作

创建记录

此操作模块在对象中创建新记录。

利用模块,可选择模块中可用的对象字段。 这减少了设置模块时必须滚动的字段数。

该模块返回记录ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
记录类型
选择要模块创建的Salesforce记录的类型。 根据记录类型字段中选择的记录类型,字段将变为可用。 这些字段基于Salesforce API。
选择要映射的字段

选择您希望模块在创建新记录时配置的字段。 必填字段位于列表顶部。

您选择的字段在此字段下打开。 您现在可以在这些字段中输入值。

读取记录

此操作模块从Salesforce中的单个对象读取数据。

您指定记录的ID。

该模块返回记录ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
记录类型
选择您希望模块[action].read的Salesforce记录类型。
记录字段
选择您希望模块读取的字段。 您必须至少选择一个字段。
ID

输入或映射您希望模块读取的记录的唯一Salesforce ID。

要获取ID,请在浏览器中打开Salesforce对象,并复制URL末尾处最后一个正斜杠(/)后面的文本。 例如: https://eu5.salesforce.com/<object ID>

删除记录

此操作模块删除对象中的现有记录。

您指定记录的ID。

该模块返回记录ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
记录类型
选择要模块删除的Salesforce记录的类型。
ID

输入或映射您希望模块删除的记录的唯一Salesforce ID。

要获取ID,请在浏览器中打开Salesforce对象,并复制URL末尾处最后一个正斜杠(/)后面的文本。 例如: https://eu5.salesforce.com/<object ID>

自定义API调用

此操作模块允许您对Salesforce API进行经过身份验证的自定义调用。 这样,您可以创建其他Salesforce模块无法实现的数据流自动化。

模块返回以下内容:

  • 状态代码 (数字):这表示HTTP请求是成功还是失败。 这些是标准代码,您可以在互联网上查找。

  • 标头 (对象):与输出正文无关的响应/状态代码的更详细的上下文。 并非响应标头中显示的所有标头都是响应标头,因此某些标头可能对您没什么用。

    响应标头取决于您在配置模块时选择的HTTP请求。

  • Body(对象):根据您在配置模块时选择的HTTP请求,您可能会收到一些返回的数据。 该数据,例如来自GET请求的数据,包含在此对象中。

配置此模块时,会显示以下字段。

选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅Adobe Workfront Fusion中的HTTP请求方法。

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
URL

输入相对于 <Instance URL>/services/data/v46.0/的路径。

有关可用端点的列表,请参阅Salesforce REST API开发人员指南

方法
Headers
以标准JSON对象的形式添加请求的标头。例如,{"Content-type":"application/json"}。 Workfront Fusion会为您添加授权标头。
查询字符串
以标准JSON对象的形式添加API调用的查询。例如: {"name":"something-urgent"}
Body

以标准JSON对象的形式添加API调用的正文内容。

注意:

在JSON中使用条件语句(如if)时,请将引号放在条件语句之外。

INFO

示例: ​以下API调用返回您Salesforce帐户中所有用户的列表:

- URLquery- 方法: GET- 查询字符串:- q- SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10

在​ 包 > 正文 > 记录 ​下的模块输出中可以找到搜索匹配项。

在我们的示例中,返回了6个用户:

上载附件/文档

此操作模块上传文件并将其附加到您指定的记录,或上传文档。

模块会返回附件或文档的ID以及任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明

上载类型
选择您希望模块上载附件还是文档。
ID
输入或映射要向其上载附件的对象的ID。
文件夹
选择包含您希望模块上传的文件的文件夹。
Source File
从上一个模块中选择源文件,或映射源文件的名称和数据。

下载附件/文档

此操作模块从记录中下载文档或附件。

您可以指定记录的ID以及所需的下载类型。

模块会返回附件或文档的ID以及任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
下载类型

指定要从Salesforce下载的文件类型。

  • 附件
  • 文档
  • ContentDocument(此文档已在Saleforce CRM Content或Salesforce Files中上载到库。)

ID /

附件ID /

内容文档ID

输入或映射您希望模块下载的记录的唯一Salesforce ID。

要获取ID,请在浏览器中打开Salesforce对象,并复制URL末尾处最后一个正斜杠(/)后面的文本。 例如: https://eu5.salesforce.com/<object ID>

更新记录

此操作模块编辑对象中的记录。

利用模块,可选择模块中可用的对象字段。 这减少了设置模块时必须滚动的字段数。

该模块返回记录ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
ID
输入或映射要更新的记录ID。
记录类型
选择要更新模块的Salesforce记录的类型。 根据在“记录类型”字段中选择的记录类型,字段变为可用。 这些字段基于Salesforce API。
选择要映射的字段

选择您希望模块在创建新记录时配置的字段。 必填字段位于列表顶部。

您选择的字段在此字段下打开。 您现在可以在这些字段中输入值。

搜索

使用查询搜索

此搜索模块在Salesforce中查找与您指定的搜索查询匹配的对象中的记录。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
搜索类型

选择您希望模块执行的搜索类型:

  • Simple

  • 使用SOSL(Salesforce对象搜索语言)

  • 使用SOQL(Salesforce对象查询语言)

类型
如果您选择了简单搜索类型,请选择您希望模块搜索的Salesforce记录的类型。
查询 / SOSL查询 / SOQL查询

输入要作为搜索依据的查询。

有关SOSL的详细信息,请参阅Salesforce文档中的Salesforce对象搜索语言(SOSL)

有关SOQL的详细信息,请参阅Salesforce文档中的Salesforce对象查询语言(SOQL)

注意:请注意,参数RETURNING 的值会影响模块的输出。 如果您使用LIMIT,Fusion将忽略最大记录计数字段中的设置。 如果不设置任何限制,Fusion将插入值LIMIT = Maximum count of records。

最大记录数
输入或映射您希望模块在每个方案执行周期内返回的最大记录数。

搜索

此操作模块可检索符合给定条件的所有记录。

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与​ Adobe Workfront Fusion的连接 — 基本说明
类型
选择要搜索的对象类型。
搜索条件
选择要搜索的字段、要在查询中使用的运算符以及要在字段中搜索的值。 您可以使用AND或OR连接查询。
输出
选择要包含在模块输出中的字段。
结果集
选择您希望模块返回所有匹配记录,还是仅返回第一个匹配记录。
最大
输入或映射您希望模块在每个方案执行周期中检索的最大记录数。
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43