Salesforce模块

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

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

有关创建方案的说明,请参阅创建方案:文章索引下的文章。

有关模块的信息,请参阅模块:文章索引下的文章。

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

访问要求

展开以查看本文中各项功能的访问要求。

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront包 任何
Adobe Workfront许可证

新增:标准

当前:工作或更高

Adobe Workfront Fusion许可证**

当前:无Workfront Fusion许可证要求

旧版:Workfront Fusion for Work Automation and Integration

产品

新:

  • 选择或Prime Workfront包:您的组织必须购买Adobe Workfront Fusion。
  • Ultimate Workfront包:其中包含Workfront Fusion。

当前:您的组织必须购买Adobe Workfront Fusion。

有关此表中信息的更多详细信息,请参阅文档中的访问要求。

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

先决条件

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

Salesforce API信息

Salesforce连接器使用以下对象:

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

关于搜索Salesforce对象

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

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

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

创建与Salesforce的连接

要为您的Salesforce模块创建连接:

  1. 在任意Salesforce模块中,单击“连接”框旁边的​ 添加

  2. 填写以下字段:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    连接名称 输入新连接的名称。
    环境 选择是连接到生产环境还是非生产环境。
    类型 选择您是要连接到服务帐户还是个人帐户。
    客户端ID 输入您的Salesforce客户端ID。
    客户端密钥 输入您的Salesforce客户端密码。
    Sandbox 如果这是沙盒环境,则启用此选项。
    API版本 输入要使用的Salesforce API的版本。 默认版本为62.0。
  3. 单击​ 继续 ​保存连接并返回模块。

Salesforce模块及其字段

触发器

观看字段

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

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

观看记录

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

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

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

观看出站消息

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

此模块需要一些额外的设置。 必须为出站消息配置流。

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

Webhook

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

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

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

操作

创建记录

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

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

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

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

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

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

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

自定义API调用

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

模块返回以下内容:

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

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

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

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

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

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

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

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

方法
选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅HTTP请求方法
Headers
以标准JSON对象的形式添加请求的标头。 例如:{"Content-type":"application/json"}。Workfront Fusion会为您添加授权标头。
查询字符串
以标准JSON对象的形式添加API调用的查询。 例如: {"name":"something-urgent"}
Body

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

注释:

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

recommendation-more-help

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

  • URLquery

  • 方法: GET

  • 查询字符串

  • q

  • SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10

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

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

搜索匹配

删除记录

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

您指定记录的ID。

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

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

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

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

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

下载附件/文档

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

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

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

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

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

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

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

ID /

附件ID /

内容文档ID

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

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

读取记录

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

您指定记录的ID。

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

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

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Salesforce的连接
记录类型
选择您希望模块读取的Salesforce记录的类型。
记录字段
选择您希望模块读取的字段。 您必须至少选择一个字段。 可用字段取决于记录类型。
ID

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

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

更新记录

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

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

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

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

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

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

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

上载附件/文档

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

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

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

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Salesforce的连接
上载类型
选择您希望模块上载附件还是文档。
ID
输入或映射要向其上载附件的对象的ID。
文件夹
选择要上载文档的文件夹。
Source File
从上一个模块中选择源文件,或映射源文件的名称和数据。

上传文件

此操作模块会将单个文件上传到Salesforce。

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与​ Adobe Workfront Fusion的连接 — 基本说明
Source file
从上一个模块中选择源文件,或映射源文件的名称和数据。
文档链接
选择是否应用内容文档链接。
linkedEntityId
如果使用文档链接,请输入或映射链接对象的ID。
ShareType

如果使用文档链接,请选择文件的权限。

  • 查看器权限

    用户可以查看文件。

  • 协作者权限

    用户可以查看和编辑文件。

  • 推断的权限

    权限基于用户对相关记录(如库)的权限。

可见性

如果使用文档链接,请输入或映射文档的可见性。

  • AllUsers

    适用于所有具有权限的用户

  • InternalUsers

    可供具有权限的内部用户使用。

  • 共享用户

    可供可以查看文件发布到的馈送的用户使用。

搜索

搜索

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

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

使用查询搜索

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

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

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

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

  • Simple

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

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

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

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

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

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

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

最大记录数
输入或映射您希望模块在每个方案执行周期内返回的最大记录数。
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3