传统集成活动

上次更新日期 2024年12月13日

关于 Salesforce 活动包

UiPath.Salesforce.Activities 包可用于自动化 Salesforce 流程。它可以通过 Salesforce 应用程序作用域连接到 Salesforce 组织，并且与其他活动一起，使您能够执行 Actions ，例如文件操作、记录操作、报告执行和 SOQL 命令执行。

建立后，与 Salesforce 组织的连接可以存储到 IConnectionService 对象中，并可以在所有后续子作用域活动中轻松重用。连接凭据使用 Microsoft .NET 数据保护 API (DPAPI) 进行加密，并且只能由同一用户在输入凭据的同一台计算机上访问。

先决条件

使用 Salesforce 活动需要 Salesforce 帐户 和 Salesforce Connected 应用程序 。这些可以从您的 Salesforce 管理员处获取。

或者，RPA 开发者可以使用 Salesforce 开发者帐户来自动化 Salesforce 中的流程。

Salesforce 状态对象

在 Salesforce 中执行数据操作的所有活动都返回专有数据类型，称为 SalesforceStatus。此对象包含有关与 Salesforce 交互时每个活动的执行状态的详细信息。该对象的结构包含以下属性：

“成功” - 说明操作是成功还是引发了错误。
错误代码 - 如果执行时引发错误，则从 Salesforce 返回错误代码。
消息 - 如果在执行时引发错误，则从 Salesforce 返回错误消息。

Salesforce 对象向导

可以使用Salesforce 对象向导配置“ 获取记录 ”、“ 插入记录”和 “ 更新记录” 活动。单击活动主体中的“ 配置 ” 按钮即可打开此窗口。

Salesforce 对象 下拉列表可让您选择要与之交互的对象，并显示其所有详细信息。该对象中的第一条记录也将作为示例记录进行检索。 “样本值”列显示该记录的字段值。

注意: 选择 Salesforce 对象时，字段列表将填充字段列表，这些字段在 Salesforce 中对象的所有布局中标记为必填。由于 Salesforce 中可用配置详细信息的限制，可能会有更多必填字段，但默认情况下不会添加。使用“ 包含样本值 的测试”来测试活动。

通过使用“ 添加单个字段 ” 文本框，您可以向所选对象添加字段。 “ 添加多个字段” 按钮将打开向导的其他部分，您可以在其中选择要添加到对象的多个字段。为此，请选中要添加的所有字段的复选标记，然后单击 “完成”。

注意：在“ 插入记录” 活动中，只有被标识为允许由 Salesforce Lightning API 创建的字段可用。在“ 更新记录” 活动中，只有被标识为允许更新的字段可用。

再次单击 “完成” ，将保存您对正在配置的活动所做的更改。

“ 插入记录” 和 “更新记录” 活动还可以选择使用示例值测试操作。这可以通过单击“ 使用样本值进行测试 ” 按钮来完成。这将使用“示例值”列中的值执行操作，并报告成功或错误。

Salesforce 对象字段和数据类型

在“ 获取记录”、“ 插入记录”和 “ 更新记录” 活动中，所有字段值都作为 String传递。

对于数据类型为 Picklist 的字段，传递的字符串应该是有效值，而不是应用程序中显示的标签。使用“设置标签和值的格式” 活动正确设置字符串。

对于数据类型为 Multiplicklist 的字段，传递的字符串应是以分号分隔的有效值列表，而不是应用程序中显示的标签。使用“设置标签和值的格式” 活动正确设置字符串。

对于数据类型为 Boolean 的字段，传递的字符串应为 true 或 false。请注意，当 Salesforce 在“ 获取记录” 活动中返回这些值时，“示例值”列中显示的值可以是以下任一值： True、 true、 False或 false，具体取决于最初在 Salesforce 中输入数据的方式。

对于具有 Date 数据类型的字段，传递的字符串应采用 YYYY-MM-DD格式。