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 Workflow 包以及任意 Adobe Workfront 自动化和集成包

Workfront Ultimate

Workfront Prime 和 Select 包,且需额外购买 Workfront Fusion。

Adobe Workfront 许可证

标准

工作版或更高版本

Adobe Workfront Fusion 许可证

基于操作:不需要 Workfront Fusion 许可证

基于连接器(旧版):Workfront Fusion for Work Automation and Integration

产品 如果您的组织使用的 Workfront Select 或 Prime 包不包含 Workfront 自动化和集成,则必须单独购买 Adobe Workfront Fusion。

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

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

先决条件

要使用 Salesforce 模块,您必须拥有一个 Salesforce 帐户。

Salesforce API信息

Salesforce连接器使用以下对象:

基本 URL
code language-none
{{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中更新字段时启动方案。

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

观看记录

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

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

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

观看出站消息

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

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

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

Webhook

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

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

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

操作

创建记录

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

该模块允许您选择对象的哪些字段可在模块中使用。 这减少了设置模块时必须滚动的字段数。

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

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

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

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

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

自定义 API 调用

此操作模块允许您向 Salesforce API 发起自定义的已经过身份认证的调用。 通过这种方式,您可以构建其他 Salesforce 模块无法实现的数据流自动化。

模块返回以下内容:

  • 状态代码(数字):指示 HTTP 请求是成功还是失败。 这些是标准状态码,您可以在网上查阅其含义。

  • 标头(对象):提供与输出正文无关的响应/状态码的详细上下文信息。 并非所有出现在响应标头中的字段都是有用的响应标头,因此部分信息可能对您不重要。

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

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

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

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

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

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

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

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

注意:

在 JSON 中使用 if 等条件语句时,需将引号置于条件语句外部。

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

  • URLquery

  • 方法: GET

  • 查询字符串

  • q

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

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

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

搜索匹配

删除记录

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

您需要指定记录的 ID。

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

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

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

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

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

下载附件/文档

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

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

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

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

连接
有关将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 及其关联字段,以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。

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

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

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

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

更新记录

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

该模块允许您选择对象的哪些字段可在模块中使用。 这减少了设置模块时必须滚动的字段数。

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

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

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

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

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

上载附件/文档

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

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

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

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

上传文件

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

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

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

  • 查看器权限

    用户可以查看文件。

  • 协作者权限

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

  • 推断的权限

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

可见性

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

  • AllUsers

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

  • InternalUsers

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

  • 共享用户

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

搜索

搜索

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

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

使用查询搜索

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

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

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

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

  • 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。

最大记录数
输入或映射每次场景执行周期中该模块允许返回的最大记录数量。
recommendation-more-help
workfront-fusion-help-workfront-fusion