传统集成活动

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

快速入门

概述

本指南旨在帮助您创建工作示例，以快速验证与 Salesforce 组织的连接，并熟悉所包含的活动输入/输出数据类型。

完成本指南中的步骤后，您将获得一个自动化序列，该连接器将执行以下操作：

为您的 Salesforce 凭据和调用方法创建 SecureString 变量。
使用您的 SecureString 凭据（Salesforce 应用程序作用域）建立与 Salesforce 组织的连接
创建新的 Salesforce 帐户记录 (插入记录)。
将文件上传到 Salesforce 组织（上传文件）。
将上传的文件分配给新的 Salesforce 帐户记录 (分配文件)。
通过输出每个Salesforce 状态对象()，验证 插入记录、 上传文件和 分配文件 活动的结果。

先决条件

在开始之前：

完成 Salesforce 设置步骤。
创建一个新的自动化项目。
1. 打开 UiPath Studio。
2. 在“ 新建项目”下，单击“ 流程 ”（这将打开 “新建空白流程” 窗口）。
3. 输入项目名称、位置和说明。
4. 单击“创建”。
安装 UiPath.Salesforce.Activities 包。
1. 在“ 设计 ”功能区中，单击“ 管理包 ”（这将打开“ 管理包 ”窗口）。
2. 在“ 所有包”下，单击 “官方”。
3. 在搜索栏中，输入 Salesforce。
4. 单击，安装并接受 UiPath.Salesforce.Activities的许可证。
  - 有关 Uipath Studio 包的更多信息，请参阅 Studio 指南中的管理包。

步骤

构建项目

Salesforce 应用程序作用域 活动的 使用者密码、密码和 安全令牌 输入属性需要 SecureString 数据类型。要获取这些 SecureString 数据类型，请在完成设置指南中的获取凭据步骤时转换为这些属性存储的 String 值。

备注：

以下步骤旨在演示如何将 String 转换为 SecureString。为简单起见并帮助您快速创建工作示例，转换在项目序列中完成，并要求您输入凭据值作为变量。创建可共享项目或非示例项目时，不建议这样做。

创建可共享项目或非示例项目时，您可以创建并引用从本地来源（例如 .txt 、 .xlsx 文件）并使用 <in> 和 <out> 参数执行转换。

将字符串转换为安全字符串

创建以下三个变量：
1. String ，并将您的 Salesforce 登录密码作为默认值（例如，名称： textPassword， 默认值： “UiPath123”）
2. SecureString ，将 New SecureString() 作为默认值（例如，名称： securePassword， 默认值：New SecureString()）
3. SecureString （例如，名称：密码）
  - 对于所有 SecureString 变量，选择 System.Security.SecurityString 类型。
4. 向流程中添加新语句。
- 建议：将 显示名称 更改为 “创建安全字符串 - 密码” 或其他内容，以便于识别其用途。
在“ 序列”中添加活动。
1. 在“类型参数” 属性中，选择 “System.Char” 。
2. 在“ 值 ” 属性中，输入 String 变量（例如， textPassword）。
在“ 遍历循环”活动中，添加“ 调用方法” 活动（“编程”>“执行”>“调用方法”）。
1. 在“目标对象” 属性中，输入第一个 SecureString 变量（例如， securePassword ）
  - 确保 TargetType 属性为 (null) （允许使用 TargetObject 或 TargetType ，但不能同时使用两者）。
2. 在“ 方法名称 ” 属性中，输入“ 附加字符”。
  - AppendChar 方法用于在字符串后添加 UTF-16 代码单元。
3. 在“ 参数 ” 属性中，使用以下值添加一个新参数： “方向: 输入”、“ 类型: System.Char”、“ 值: 项目”。
在“ 调用方法 ”活动之后添加该活动。
1. 在“ 收件人” 属性中，输入第二个 SecureString 变量（例如， password）。
2. 在“ 值 ” 属性中，输入第一个 SecureString 变量（例如，_securePassword）。
创建以下三个变量：
1. String ，并将您的使用者密码作为默认值（例如，名称： textPassword， 默认值： “4FA94...”）
2. SecureString ，将 New SecureString() 作为默认值（例如，名称： secureConsumerSeret， 默认值：New SecureString()）
3. SecureString （例如，名称: consumerSecret）
  - 对于所有 SecureString 变量，选择 System.Security.SecurityString 类型。
4. 重复步骤 2-5，将 使用者密码 String 转换为 SecureString。
创建以下 3 个变量：
1. String ，并将您的安全令牌作为默认值（例如，名称: textPassword， 默认值: ""MUc2B..."）
2. SecureString ，将 New SecureString() 作为默认值（例如，名称： secureSecurityToken， 默认值：New SecureString()）
3. SecureString （例如，名称: securityToken）
  - 对于所有 SecureString 变量，选择 System.Security.SecurityString 类型。
4. 重复步骤 2-5，将 安全令牌 String 转换为 SecureString。

现在，您的流程中应该有三个“ 创建安全字符串 ”序列，如下图所示。

现在，您已拥有 SecureString 变量，可以添加“ Salesforce 应用程序作用域 ”活动以及其他 Salesforce 活动。

添加 Salesforce 活动

将“ Salesforce 应用程序作用域 ” 活动添加到您的项目中。
1. 在输入属性值之前，我们来测试您的连接。
  1. 单击“ 配置 ” 按钮（这将打开连接向导）。
  2. 选择您的 服务器 （如果连接到开发者组织或非开发者生产组织 - 选择“实时”，沙盒/测试组织 - 选择“测试”）。
  3. 输入您的 使用者密钥、 使用者密码、用户名、密码和 安全令牌 （开发者登录时需要）。
  4. 单击“ 测试连接 ” 按钮，然后等待“ 连接成功 ” 窗口。
    - 如果您收到错误，请确保选择了正确的 服务器。接下来，按照设置指南中获取凭据的最后一步尝试重置您的安全令牌，并输入通过电子邮件发送给您的新值。
  5. 连接成功后，您现在可以添加属性值，包括在上述步骤中创建的 SecureString 变量（在连接向导中输入的值独立于属性值，也不共享）。
2. 输入在完成“ 获取凭据 ”步骤时复制的“使用者密钥”值 (String)。
3. 在 ConsumerSecret 属性中，输入您在上述步骤 6 中创建的第二个 SecureString 变量（例如， consumerSecret）。
4. 在“ 密码 ” 属性中，输入您在上述步骤 1 中创建的第二个 SecureString 变量（例如，密码）。
5. 输入“ 服务器 ”值（“实时” 或 “测试”）。
6. 输入您的 Salesforce 登录用户名（例如， “name@company.com”）
7. 对于 SalesforceConnection 属性，创建并输入 IConnectionService 变量（例如， salesforceConnection）。
  - 完成本指南中的步骤时，您不会使用此变量，但最好创建输出变量以在后续活动中使用。
8. 在“ Salesforce 应用程序作用域” 活动中添加“ 插入记录 ” 活动。
9. 为此活动的输出属性创建一个新的 String 变量（例如， newAccountID）。
10. 单击“ 配置 ” 按钮（这将打开 Salesforce 对象向导）。
  - 要了解有关该向导工作原理的更多信息，请参阅关于 Salesforce 活动页面中的 Salesforce 对象向导 部分。
11. 在“ Salesforce 对象 ” 下拉列表中，选择“ 客户 ”（应显示“ 客户 ID ” 和 “名称” 字段）。
12. 在“ 添加单个字段 ” 文本框中，输入“ 类型 ”，然后单击“Enter”（您现在应该有 3 个字段）。
13. 在“ 帐户 ID ” 字段中，输入您在步骤 1 中创建的 String 变量（例如， newAcountID）。
14. 输入帐户的名称（例如， “Salesforce 快速入门”）。
15. 输入有效的类型 String （例如， “Prospect”）。
  - 具有 picklist 数据类型 的所有字段都需要与列表中的项目匹配的 String 值，如 Salesforce 用户界面中所示。
    - 以“ 类型 ” 字段为例，默认情况下，选取列表包含下图所示的值（来自“Salesforce 帐户”屏幕）。您可以使用“ 设置标签和值格式” 活动来预览有效的 String 值（请参阅下面的示例）。
  - 单击“完成”。
16. 在 SalesforceOutput 属性中，创建并输入 SalesforceStatus 变量（例如， insertRecordStatus）。
在“插入记录”活动之后添加“ 上传文件 ”活动。
1. 输入文件 “说明”、“文件路径”和 “标题”。
2. 在“ 输出 ID” 属性中，创建并输入新的 String 变量（例如， newFileID）。
3. 在 SalesforceStatus 属性中，创建并输入新的 SalesforceStatus 变量（例如， uploadFileStatus）。
在获取记录活动之后添加分配文件活动。
1. 在“ ID ” 属性中，输入您为“ 上传文件 ” 活动创建的 String 变量（例如， newFileID）。
2. 在“ 记录 ID” 属性中，输入您为“ 插入活动 ” 活动创建的 String 变量（例如， newAccountID）。
3. 输入“ 共享类型 ”值（例如， “I” 表示“推断”）。
4. 输入“ 可见性 ”值（例如， “AllUsers”）。
5. 在 SalesforceStatus 属性中，创建并输入新的 SalesforceStatus 变量（例如， assignFileStatus）。

测试您的项目

要验证是否已插入记录、已上传文件并将其分配给插入的记录，请在“ 分配文件 ”活动之后添加 3 个活动。
1. 在第一个“ 写入行 ”活动中，输入以下文本： “插入记录成功：”+insertRecordStatus.Success.ToString。
  - insertRecordStatus 是您为“ 插入记录” 活动创建的 SalesforceStatus 变量。
2. 在第二个“ 写入行 ”活动中，输入以下文本： “上传文件成功：”+uploadFileSuccess.Success.ToString。
  - uploadFileStatus 是您为“ 上传文件 ”活动创建的 SalesforceStatus 变量。
3. 在第三个“ 写入行 ”活动中，输入以下文本： “上传文件成功：”+assignFileSuccess.Success.ToString。
  - assignFileStatus 是您为“ 分配文件 ”活动创建的 SalesforceStatus 变量。
4. 单击“ 开始 ”，然后在输出窗口中验证结果。
要进一步验证您的结果，请登录您的 Salesforce 组织，然后转到您的帐户和文件以查看新添加的内容。

操作完毕！您现在拥有一个包含 Salesforce 活动的自动化项目。要了解有关 Salesforce 活动的更多信息，请参阅活动以获取活动详细信息页面的链接。

要进一步实现 Salesforce 自动化，请参阅 UiPath Connector for Salesforce 文档。适用于 Salesforce 的 UiPath 连接器在 Salesforce 和 UiPath Orchestrator（内部部署或云实例）之间创建“服务器 - 服务器”连接。它使您能够通过流程构建器、流程构建器或工作流从 Salesforce 提交 UiPath 作业或添加队列项目。

在此页面上