Salesforce 命令

要作为链的一部分与 Salesforce® 内的数据交互，请添加一个带有 Salesforce 连接命令的步骤。例如

通过 SOQL 和批量操作加载、提取和删除数据
创建和管理 Salesforce 对象
更新和创建记录

要启用这些命令，IT 管理员首先要创建一个 Salesforce 连接器。该连接器通过 REST API 与所有版本的 Salesforce Sales Cloud--Salesforce Essentials®、Lightning® Professional、Lightning Enterprise 和 Lightning Unlimited 进行交互。

批量删除

要根据逗号分隔值 (CSV) 文件删除大量记录，请使用 批量删除 命令。

注：如果删除记录失败，命令将返回 CSV，列出失败记录的行号以及失败原因。您可以使用分支功能在命令失败时执行操作，或将失败信息加载到 Google® Drive 供以后分析。

属性

摘要信息	详细信息
并发模式	选择是同时还是按顺序处理记录。要同时处理记录，请选择并行。要按顺序处理记录，请选择串行。注意：对于非常大的作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。
对象名称	输入要执行操作的 SObject 类型。
输入文件	输入包含要删除记录的文件。
文件格式	选择输入文件是 CSV、JSON 还是 XML。
批量大小	输入每批要处理的记录数。我们建议您保留默认值。
等待完成	要轮询 Salesforce 并仅在处理完所有记录后才转到下一条命令，请选中此复选框。要触发命令并立即进入下一步，请取消选中该复选框。

输出

输出	输出类型
批量删除错误日志	文件

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

批量插入

要根据 CSV 文件插入大量记录，请使用 Bulk insert 命令。

注意：如果记录插入失败，命令会返回 CSV，列出失败记录的行号以及失败原因。您可以使用分支功能在命令失败时执行操作，或将失败信息加载到 Google® Drive 供以后分析。

属性

摘要信息	详细信息
并发模式	选择是同时还是按顺序处理记录。要同时处理记录，请选择并行。要按顺序处理记录，请选择串行。注意：对于非常大的作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。
对象名称	输入要执行操作的 SObject 类型。
输入文件	输入包含要插入记录的文件。
文件格式	选择输入文件是 CSV、JSON 还是 XML。
批量大小	输入每批要处理的记录数。我们建议您保留默认值。
等待完成	要轮询 Salesforce 并仅在处理完所有记录后才转到下一条命令，请选中此复选框。要触发命令并立即进入下一步，请取消选中该复选框。

输出

输出	输出类型
批量插入错误日志	文件

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

批量查询

要查询大量记录，请使用 批量查询 命令。

属性

摘要信息

详细信息

并发模式

选择是同时还是按顺序处理记录。

要同时处理记录，请选择并行。
要按顺序处理记录，请选择串行。

注意：对于超大作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。

对象名称

输入要执行操作的 SObject 类型。

SOQL 查询

输入要执行的 SOQL 查询。

输出

输出	输出类型
批量查询结果 CSV	文件

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

批量更新

要更新大量记录，请使用 批量更新 命令。

注：如果记录更新失败，命令会返回 CSV，列出失败记录的行号以及失败原因。您可以使用分支功能在命令失败时执行操作，或将失败信息加载到 Google® Drive 供以后分析。

属性

摘要信息	详细信息
并发模式	选择是同时还是按顺序处理记录。要同时处理记录，请选择并行。要按顺序处理记录，请选择串行。注意：对于超大作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。
对象名称	输入要执行操作的 SObject 类型。
输入文件	输入包含要更新记录的文件。
文件格式	选择输入文件是 CSV、JSON 还是 XML。
批量大小	输入每批要处理的记录数。我们建议您保留默认值。
等待完成	要轮询 Salesforce 并仅在处理完所有记录后才转到下一条命令，请选中此复选框。要触发命令并立即进入下一步，请取消选中该复选框。

输出

输出	输出类型
批量更新错误日志	文件

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

批量插入

要根据外部 ID 对大量记录执行 upsert（更新现有记录或创建新记录），请使用 Bulk upsert 命令。

注意：如果记录无法向上插入，命令会返回 CSV，列出失败记录的行号以及失败原因。您可以使用分支功能在命令失败时执行操作，或将失败信息加载到 Google® Drive 供以后分析。

属性

摘要信息	详细信息
并发模式	选择是同时还是按顺序处理记录。要同时处理记录，请选择并行。要按顺序处理记录，请选择串行。注意：对于超大作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。
对象名称	输入要执行操作的 SObject 类型。
输入文件	输入包含要插入的记录的文件。
文件格式	选择输入文件是 CSV、JSON 还是 XML。
批量大小	输入每批要处理的记录数。我们建议您保留默认值。
等待完成	要轮询 Salesforce 并仅在处理完所有记录后才转到下一条命令，请选中此复选框。要触发命令并立即进入下一步，请取消选中该复选框。
外部 ID	要确定记录是已经存在还是需要创建，请输入上载涉及的对象所需的外部 ID 字段。

输出

输出	输出类型
批量上载错误日志	文件

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

创建记录

要在 Salesforce 中创建新记录，请使用 Create record 命令。

属性

摘要信息	详细信息
姓名	输入要创建记录的 SObject 的名称。
栏位	输入要更新的记录字段，格式为 `FIELD_NAME:VALUE`。

输出

输出	输出类型
新记录 ID	字串

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

删除记录

要在 Salesforce 中根据 ID 删除记录，请使用 删除记录 命令。

属性

摘要信息	详细信息
ID	输入要删除记录的 ID。如果 ID 不详，请输入外部 ID，格式为 `EXTERNAL_ID_NAME:VALUE`，如 `Name:John`。
姓名	输入要删除记录的 SObject 的名称。

输出

没有任何

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

下载报告

要将自定义报告下载为逗号分隔值 (CSV) 文件，请使用 下载报告 命令。

属性

摘要信息	详细信息
报告 ID	输入要下载的自定义报告的 ID。

输出

输出	输出类型
自定义报告 CSV	文件

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

获取对象元数据

要检索与 Salesforce 对象相关的字段和元数据，请使用 Get object metadata 命令。

属性

摘要信息	详细信息
物件	输入要检索元数据的对象名称。

输出

输出	输出类型
对象元数据	文件

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

获取记录

要根据记录的 ID 从 Salesforce 中检索记录，请使用 Get record 命令。

属性

摘要信息	详细信息
ID	输入要检索记录的 ID。
姓名	输入要检索记录的 SObject 的名称。
栏位	输入要包含的报告字段（可选）。

输出

输出	输出类型
获取记录 JSON	JSON

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

登录列表

要列出 Salesforce 环境中的登录信息，请使用 List logins 命令。

属性

没有任何

输出

输出	输出类型
CSV 登录列表	文件

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

列出对象

要从 Salesforce 列出 SObjects，请使用 List objects 命令。

属性

没有任何

输出

输出	输出类型
CSV 列表对象	文件

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

清单报告

要从 Salesforce 列出报告，请使用 List reports 命令。

属性

没有任何

输出

输出	输出类型
清单报告 CSV	文件

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

SOQL 查询

要执行 SOQL 查询并将结果生成 CSV 文件，请使用 SOQL 查询 命令。

注意： SOQL 语法与 SQL 非常相似。SOQL 查询命令可以提取大量数据，并一次返回 100 万条或更多记录的数据集。如果由于查询不正确或引用了不存在的对象而导致命令失败，命令的输出结果会通知你。

属性

摘要信息	详细信息
查询	输入要执行的 SOQL 查询。
查询命令	选择是否包含已删除的记录。要排除删除的记录，请选择查询。要包括删除的记录，请选择 QueryAll。

输出

输出	输出类型
SOQL 查询输出	文件

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

SObject - 创建

要在 Salesforce 中创建一个新的 SObject，请使用 SOjbect- create 命令。

属性

摘要信息	详细信息
姓名	输入新 SObject 的名称。为了表示这是一个自定义对象，Salesforce 自动附加了 `__c`。
栏位	输入要创建的记录字段，格式为 `FIELD_NAME:TYPE`，其中 `TYPE` 对应 Salesforce 字段类型。

输出

没有任何

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

SObject - 删除

要删除 Salesforce 中的 SObject，请使用 SObject - delete 命令。

属性

摘要信息	详细信息
姓名	输入要创建的 SObjects 的名称。

输出

没有任何

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

更新记录

要更新 Salesforce 中记录的字段值，请使用 更新记录 命令。

属性

摘要信息	详细信息
ID	输入要更新记录的 ID。
姓名	输入要更新记录的 SObject 的名称。
栏位	输入要更新的记录字段，格式为 `FIELD_NAME:VALUE`。

输出

没有任何

退出代码

代码	类型	详细信息
0	成功	成功
1	错误	一般故障

Workiva 支持中心

批量删除

注： 如果删除记录失败，命令将返回 CSV，列出失败记录的行号以及失败原因。您可以使用分支功能在命令失败时执行操作，或将失败信息加载到 Google® Drive 供以后分析。

属性

注意： 对于非常大的作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。

输出

退出代码

批量插入

注意： 如果记录插入失败，命令会返回 CSV，列出失败记录的行号以及失败原因。您可以使用分支功能在命令失败时执行操作，或将失败信息加载到 Google® Drive 供以后分析。

属性

注意： 对于非常大的作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。

输出

退出代码

批量查询

属性

注意： 对于超大作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。

输出

退出代码

批量更新

注： 如果记录更新失败，命令会返回 CSV，列出失败记录的行号以及失败原因。您可以使用分支功能在命令失败时执行操作，或将失败信息加载到 Google® Drive 供以后分析。

属性

注意： 对于超大作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。

输出

退出代码

批量插入

注意： 如果记录无法向上插入，命令会返回 CSV，列出失败记录的行号以及失败原因。您可以使用分支功能在命令失败时执行操作，或将失败信息加载到 Google® Drive 供以后分析。

属性

注意： 对于超大作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。

输出

退出代码

创建记录

属性

输出

退出代码

删除记录

属性

输出

退出代码

下载报告

属性

输出

退出代码

获取对象元数据

属性

输出

退出代码

获取记录

属性

输出

退出代码

登录列表

属性

输出

退出代码

列出对象

属性

输出

退出代码

清单报告

属性

输出

退出代码

SOQL 查询

注意： SOQL 语法 与 SQL 非常相似。SOQL 查询 命令可以提取大量数据，并一次返回 100 万条或更多记录的数据集。如果由于查询不正确或引用了不存在的对象而导致命令失败，命令的输出结果会通知你。

属性

输出

退出代码

SObject - 创建

属性

输出

退出代码

SObject - 删除

属性

输出

退出代码

更新记录

属性

输出

退出代码

注：如果删除记录失败，命令将返回 CSV，列出失败记录的行号以及失败原因。您可以使用分支功能在命令失败时执行操作，或将失败信息加载到 Google® Drive 供以后分析。

注意：对于非常大的作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。

注意：如果记录插入失败，命令会返回 CSV，列出失败记录的行号以及失败原因。您可以使用分支功能在命令失败时执行操作，或将失败信息加载到 Google® Drive 供以后分析。

注意：对于非常大的作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。

注意：对于超大作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。

注：如果记录更新失败，命令会返回 CSV，列出失败记录的行号以及失败原因。您可以使用分支功能在命令失败时执行操作，或将失败信息加载到 Google® Drive 供以后分析。

注意：对于超大作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。

注意：如果记录无法向上插入，命令会返回 CSV，列出失败记录的行号以及失败原因。您可以使用分支功能在命令失败时执行操作，或将失败信息加载到 Google® Drive 供以后分析。

注意：对于超大作业，请选择串行，因为数据库连接的数量可能导致并行模式下的作业失败。不过，串行模式可能会导致更长的处理时间。

注意： SOQL 语法与 SQL 非常相似。SOQL 查询命令可以提取大量数据，并一次返回 100 万条或更多记录的数据集。如果由于查询不正确或引用了不存在的对象而导致命令失败，命令的输出结果会通知你。