活动

关于“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格式。