Salesforce 命令

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

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

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

批量删除

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

注意：如果删除记录失败，该命令将返回一个 CSV 文件，其中列出了失败记录的行号以及失败原因。您可以使用分支来在命令失败时执行操作，或者将失败的情况加载到 Google® 云端硬盘以供稍后分析。

属性

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

输出

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

退出代码

代码	类型	细节
0	成功	成功
1	错误	普遍失败

散装插页

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

注意：如果插入记录失败，该命令将返回一个 CSV 文件，其中列出了失败记录的行号以及失败原因。您可以使用分支来在命令失败时执行操作，或者将失败的情况加载到 Google® 云端硬盘以供稍后分析。

属性

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

输出

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

退出代码

代码	类型	细节
0	成功	成功
1	错误	普遍失败

批量查询

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

属性

摘要信息

细节

并发模式

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

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

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

SObject 名称

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

SOQL 查询

输入要执行的 SOQL 查询语句。

输出

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

退出代码

代码	类型	细节
0	成功	成功
1	错误	普遍失败

批量更新

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

注意：如果记录更新失败，该命令将返回一个 CSV 文件，其中列出了失败记录的行号以及失败的原因。您可以使用分支来在命令失败时执行操作，或者将失败的情况加载到 Google® 云端硬盘以供稍后分析。

属性

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

输出

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

退出代码

代码	类型	细节
0	成功	成功
1	错误	普遍失败

散装插入

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

注意：如果更新插入记录失败，该命令将返回一个 CSV 文件，其中列出了失败记录的行号以及失败的原因。您可以使用分支来在命令失败时执行操作，或者将失败的情况加载到 Google® 云端硬盘以供稍后分析。

属性

摘要信息	细节
并发模式	选择是同时处理记录还是按顺序处理记录。要同时处理记录，请选择“并行”。要按顺序处理记录，请选择“序列”。注意：对于非常大的作业，请选择串行模式，因为数据库连接数过多可能会导致并行模式下的作业失败。但是，串行模式可能会导致处理时间大大延长。
SObject 名称	请输入要对其执行操作的 SObject 类型。
输入文件	输入包含要更新或插入记录的文件。
文件格式	选择输入文件的类型，即 CSV、JSON 或 XML。
批量大小	请输入每批次要处理的记录数。我们建议您保留默认设置。
等待完成	要轮询 Salesforce 并仅在处理完所有记录后才执行下一个命令，请选中此框。要触发命令并立即进入下一步，请取消选中此框。
外部标识	要确定记录是否已存在或需要创建，请输入 upsert 操作所涉及的对象所需的外部 ID 字段。

输出

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

退出代码

代码	类型	细节
0	成功	成功
1	错误	普遍失败

创建记录

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

属性

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

输出

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

退出代码

代码	类型	细节
0	成功	成功
1	错误	普遍失败

删除记录

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

属性

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

输出

没有任何

退出代码

代码	类型	细节
0	成功	成功
1	错误	普遍失败

下载报告

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

属性

摘要信息	细节
报告 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 中的 SObject，请使用 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 命令。

属性

摘要信息	细节
姓名	输入要创建的 SObject 的名称。

输出

没有任何

退出代码

代码	类型	细节
0	成功	成功
1	错误	普遍失败

更新记录

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

属性

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

输出

没有任何

退出代码

代码	类型	细节
0	成功	成功
1	错误	普遍失败

Workiva支持中心

批量删除

注意： 如果删除记录失败，该命令将返回一个 CSV 文件，其中列出了失败记录的行号以及失败原因。您可以使用分支来在命令失败时执行操作，或者将失败的情况加载到 Google® 云端硬盘以供稍后分析。

属性

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

输出

退出代码

散装插页

注意： 如果插入记录失败，该命令将返回一个 CSV 文件，其中列出了失败记录的行号以及失败原因。您可以使用分支来在命令失败时执行操作，或者将失败的情况加载到 Google® 云端硬盘以供稍后分析。

属性

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

输出

退出代码

批量查询

属性

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

输出

退出代码

批量更新

注意： 如果记录更新失败，该命令将返回一个 CSV 文件，其中列出了失败记录的行号以及失败的原因。您可以使用分支来在命令失败时执行操作，或者将失败的情况加载到 Google® 云端硬盘以供稍后分析。

属性

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

输出

退出代码

散装插入

注意： 如果更新插入记录失败，该命令将返回一个 CSV 文件，其中列出了失败记录的行号以及失败的原因。您可以使用分支来在命令失败时执行操作，或者将失败的情况加载到 Google® 云端硬盘以供稍后分析。

属性

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

输出

退出代码

创建记录

属性

输出

退出代码

删除记录

属性

输出

退出代码

下载报告

属性

输出

退出代码

获取对象元数据

属性

输出

退出代码

获取记录

属性

输出

退出代码

列出登录信息

属性

输出

退出代码

列表对象

属性

输出

退出代码

列表报告

属性

输出

退出代码

SOQL 查询

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

属性

输出

退出代码

SObject - 创建

属性

输出

退出代码

SObject - 删除

属性

输出

退出代码

更新记录

属性

输出

退出代码

注意：如果删除记录失败，该命令将返回一个 CSV 文件，其中列出了失败记录的行号以及失败原因。您可以使用分支来在命令失败时执行操作，或者将失败的情况加载到 Google® 云端硬盘以供稍后分析。

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

注意：如果插入记录失败，该命令将返回一个 CSV 文件，其中列出了失败记录的行号以及失败原因。您可以使用分支来在命令失败时执行操作，或者将失败的情况加载到 Google® 云端硬盘以供稍后分析。

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

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

注意：如果记录更新失败，该命令将返回一个 CSV 文件，其中列出了失败记录的行号以及失败的原因。您可以使用分支来在命令失败时执行操作，或者将失败的情况加载到 Google® 云端硬盘以供稍后分析。

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

注意：如果更新插入记录失败，该命令将返回一个 CSV 文件，其中列出了失败记录的行号以及失败的原因。您可以使用分支来在命令失败时执行操作，或者将失败的情况加载到 Google® 云端硬盘以供稍后分析。

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

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