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模块中,单击“连接”框旁边的​ Add

  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
    Connection name 输入新连接的名称。
    Environment 选择是连接到生产环境还是非生产环境。
    Type 选择您是要连接到服务帐户还是个人帐户。
    Client ID 输入您的Salesforce客户端ID。
    Client Secret 输入您的Salesforce客户端密码。
    Sandbox 如果这是沙盒环境,则启用此选项。
    API Version 输入要使用的Salesforce API的版本。 默认版本为62.0。
  3. 单击​ Continue ​保存连接并返回模块。

Salesforce模块及其字段

触发器

Watch a field

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

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

Watch for Records

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

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

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

Watch Outbound Messages

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

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

  1. 转到Salesforce设置页面。

    要访问设置页面,请找到并单击Salesforce帐户右上角标记为“Setup”的按钮。 从Salesforce设置页面中,找到左侧的“Quick Find / Search”栏。 搜索“Workflow Rules”。

  2. 单击 Workflow Rules

  3. 在显示的Workflow Rules页面上,单击​ New Rule ​并选择规则将应用到的对象类型(例如,“Opportunity”,如果您正在监视对Opportunity记录的更新)。

  4. 单击 Next

  5. 设置规则名称、评估标准和规则标准,然后单击​ Save ​和​ Next

  6. 单击 Done

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

  8. 从​ Add Workflow Action ​下拉列表中选择​ New Outbound Message

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

    Endpoint URL ​字段包含在Workfront Fusion中的Salesforce Outbound Message上提供的URL。

  10. 配置以Outbound Message事件开头的方案。

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

  12. 返回​ Workflow Rules ​页面,找到新创建的规则,然后单击​ Activate

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

Webhook

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

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

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

操作

Create a Record

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

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

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

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

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

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

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

Custom API Call

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

模块返回以下内容:

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

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

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

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

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

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

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

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

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

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

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

注意:

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

Delete a Record

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

您指定记录的ID。

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

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

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

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

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

Download Attachment/Document

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

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

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

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

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

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

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

ID /

Attachment ID /

ContentDocument ID

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

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

Read a Record

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

您指定记录的ID。

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

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

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

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

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

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

  • 方法: GET

  • 查询字符串

  • q

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

在​ Bundle> Body >records ​下的模块输出中可以找到搜索匹配项。
在我们的示例中,返回了6个用户:
搜索匹配

Update a Record

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

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

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

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

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

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

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

Upload Attachment/Document

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

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

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

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

上传文件

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

搜索

Search with Query

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

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

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

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

  • 查看器权限

    用户可以查看文件。

  • 协作者权限

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

  • 推断的权限

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

Visibility

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

  • AllUsers

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

  • InternalUsers

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

  • 共享用户

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

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

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

  • Simple

  • Using SOSL (Salesforce Object Search Language)

  • Using SOQL (Salesforce Object Query Language)

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

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

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

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

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

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

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

Connection
有关将Salesforce帐户连接到Workfront Fusion的说明,请参阅创建与​ Adobe Workfront Fusion的连接 — 基本说明
Type
选择要搜索的对象类型。
Search criteria
选择要搜索的字段、要在查询中使用的运算符以及要在字段中搜索的值。 您可以使用AND或OR连接查询。
Outputs
选择要包含在模块输出中的字段。
Result set
选择您希望模块返回所有匹配记录,还是仅返回第一个匹配记录。
Maximal
输入或映射您希望模块在每个方案执行周期中检索的最大记录数。
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3