Salesforce 模块
在Adobe Workfront Fusion场景中,您可以自动使用Salesforce的工作流,并将其连接到多个第三方应用程序和服务。
有关Salesforce连接器的视频介绍,请参阅:
有关创建场景的说明,请参阅创建场景:文章索引中的相关文章。
有关模块的详细信息,请参阅模块:文章索引下的相关文章。
- 并非所有版本的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连接器使用以下对象:
关于搜索Salesforce对象
在搜索对象时,您可以输入单个搜索词,也可以使用通配符和运算符创建更复杂的查询:
- 使用星号通配符(*)代替零个或多个字符。 例如,搜索Ca*会查找以Ca开头的项目
- 使用问号通配符(?) 作为单个字符的替代。 例如,搜索Jo?n将查找词为John或Joan但不包含Jon的项目
- 使用引号运算符(“ ”)查找精确匹配的短语。 例如:“星期一会议”
有关搜索可能性的更多信息,请参阅有关SOQL和SOSL的Salesforce开发人员文档。
创建与 Salesforce 的连接
要为您的 Salesforce 模块创建连接:
-
在任意 Salesforce 模块中,点击“连接”框旁的添加。
-
填写以下字段:
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。 -
点击 继续 保存连接并返回模块。
Salesforce 模块及其字段
触发器
观看字段
此触发器模块在Salesforce中更新字段时启动方案。
观看记录
此触发器模块在创建或更新对象中的记录时执行场景。 该模块会返回与记录关联的所有标准字段,以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时,会显示以下字段。
观看出站消息
此触发器模块会在有人发送消息时执行场景。 该模块会返回与记录关联的所有标准字段,以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
此模块需要一些额外的设置。 必须为出站消息配置流。
- 有关Salesforce中的流的说明,请参阅Salesforce文档中的使用流自动执行任务。
- 有关在Salesforce中配置出站消息的信息,请参阅Salesforce文档中的从记录触发的流发送出站消息
在配置此模块时,会显示以下字段。
操作
创建记录
此操作模块在对象中创建新记录。
该模块允许您选择对象的哪些字段可在模块中使用。 这减少了设置模块时必须滚动的字段数。
该模块会返回记录的 ID 及其关联字段,以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时,会显示以下字段。
自定义 API 调用
此操作模块允许您向 Salesforce API 发起自定义的已经过身份认证的调用。 通过这种方式,您可以构建其他 Salesforce 模块无法实现的数据流自动化。
模块返回以下内容:
-
状态代码(数字):指示 HTTP 请求是成功还是失败。 这些是标准状态码,您可以在网上查阅其含义。
-
标头(对象):提供与输出正文无关的响应/状态码的详细上下文信息。 并非所有出现在响应标头中的字段都是有用的响应标头,因此部分信息可能对您不重要。
响应标头的内容取决于您在配置模块时选择的 HTTP 请求类型。
-
正文(对象):根据您在配置模块时选择的 HTTP 请求类型,您可能会收到返回的数据。 该数据(如来自GET请求的数据)包含在此对象中。
在配置此模块时,会显示以下字段。
示例:以下API调用返回您Salesforce帐户中所有用户的列表:
-
URL:
query -
方法: GET
-
查询字符串:
-
键:
q -
值:
SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10
在 包 > 正文 > 记录 下的模块输出中可以找到搜索匹配项。
在我们的示例中,返回了6个用户:
删除记录
此操作模块删除对象中的现有记录。
您需要指定记录的 ID。
该模块会返回记录的 ID 及其关联字段,以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时,会显示以下字段。
下载附件/文档
此操作模块从记录中下载文档或附件。
您可以指定记录的ID以及所需的下载类型。
模块会返回附件或文档的ID以及任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时,会显示以下字段。
读取记录
此操作模块从Salesforce中的单个对象读取数据。
您需要指定记录的 ID。
该模块会返回记录的 ID 及其关联字段,以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时,会显示以下字段。
更新记录
此操作模块编辑对象中的记录。
该模块允许您选择对象的哪些字段可在模块中使用。 这减少了设置模块时必须滚动的字段数。
该模块会返回记录的 ID 及其关联字段,以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时,会显示以下字段。
上载附件/文档
此操作模块上传文件并将其附加到您指定的记录,或上传文档。
模块会返回附件或文档的ID以及任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时,会显示以下字段。
上传文件
此操作模块会将单个文件上传到Salesforce。
搜索
搜索
此操作模块可检索符合给定条件的所有记录。
使用查询搜索
此搜索模块在Salesforce中查找与您指定的搜索查询匹配的对象中的记录。 您可以在场景后续的模块中映射这些信息。
在配置此模块时,会显示以下字段。