传统集成活动

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

快速入门 - 记录

概述

本指南旨在帮助您创建使用以下 Microsoft Dynamics 365 活动的工作示例：

此工作示例使您能够快速验证与 Microsoft Dynamics 365 应用程序的连接，并熟悉活动的输入/输出数据类型。

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

与 Microsoft Dynamics 365 应用程序建立连接（获取凭据和Microsoft Dynamics 应用程序作用域）。
插入新的客户记录 (插入记录)。
搜索插入的客户记录 (搜索记录)。
更新客户记录的网站字段 (更新记录)。
验证帐户记录是否已成功更新 (获取记录)。
删除插入的客户记录 (删除记录)。

注意：虽然可能有更有效的方法可以实现相同的结果，但此序列的目标是演示所有记录活动。

先决条件

在开始之前：

完成 Microsoft Dynamics 365 安装步骤。
使用包管理器安装 Microsoft.Activities.Extensions 包（用于“ 搜索记录” 活动）。

注意： 本指南在 Microsoft Dynamics 应用程序作用域活动中使用客户端凭据作为身份验证类型。如果您更喜欢使用 PasswordCredentials，则可以跳过步骤 1（添加 “获取凭据” 活动），并按照步骤 2 中的项目符号步骤操作（添加 “ Microsoft Dynamics 应用程序作用域 ”活动）。

步骤

构建项目

添加“获取凭据”活动。
输入您（在安装过程中）为应用程序 客户端密码 创建的凭据资产的资产名称（例如， “MicrosoftDynamics365ClientCredentials”）。
为“ 密码 ” 属性创建并输入 SecureString 变量（例如， clientSecret）。
为“ 用户名” 属性创建并输入 String 变量（例如， clientId）。
在获取凭据活动之后添加Microsoft Dynamics 365 应用程序作用域活动。
单击“ 配置 ”按钮（这将打开“ 连接向导”），选择您的 身份验证类型，输入您的凭据，然后单击“ 测试连接 ”按钮。有关此向导的用途和行为的更多信息，请参阅参考资料部分。
- 此步骤仅用于设计时。要填充 Microsoft Dynamics 应用程序作用域 属性，请继续完成以下步骤。
在“ 身份验证类型” 属性中，选择您的首选身份验证类型。
- 如果选择 PasswordCredentials，请为 ClientId 创建一个 String 变量（例如， Name: clientId Default: "56X9aXXX-b5d9-4a90-XXXX-13XX9643XXXX"）
在“ 客户端 ID ”属性中，输入您为上述“ 获取凭据” 活动或子步骤创建的 String 变量（例如，客户端 ID）。
在“客户端密码 ”属性中，输入您为“ 获取凭据” 活动创建的 SecureString 变量（例如， 客户端密码）。
- 如果选择了“密码凭据”，则将“客户端密码 ”属性留空。
在“ 端点 URL” 属性中，创建并输入一个 String 变量，其中包含要连接到的 CRM 实例的 URL（例如，名称： endpointURL 默认值： “https://uipath.crm4.dynamics.com/” )
在“ 租户 ID” 属性中，为分配给 Azure Active Directory (ADD) 租户的目录（租户） ID 创建并输入一个 String 变量（例如，名称： tenantId 默认值： “d8353d2a-b153-4d17-8827-902cXXXXXXX”） .
- 如果选择了 密码凭据，请选择密码提示首选项（选项）。
在“ Microsoft Dynamics 应用程序作用域”活动中添加“ 插入记录 ”活动。
1. 单击“ 插入记录” 活动中的“配置”按钮（这将打开“ 对象向导”）。
  1. 在“ 选择实体 ” 下拉列表中，选择“ 帐户”。
  2. 在 accountId 字段中，创建并输入 String 变量（例如 accountId）。
  3. 在“ 添加单个字段 ” 文本框中，输入名称，然后单击“Enter”。
  4. 在“ 名称 ” 字段中，输入帐户名称（例如， “Quickstart_Account”）。
  5. 单击“ 完成” 按钮。
2. 在“ 插入记录” 活动之后添加“添加到字典” 活动。
3. 在“ 字典” 属性中，相应地创建并输入 Dictionary<String,String> 变量：名称： queryOption， 默认值： new Dictionary(Of String, String) （您可以使用其他名称值，但需要使用默认值）。
4. 在“ 键 ”属性中，输入 "$filter"。
5. 在“ 值 ” 属性中，输入 “name eq 'Quickstart_Account'” （Quickstart_Account 是您在上述步骤中插入的帐户的名称。如果您输入了其他名称，请改用该值）。
  - 有关查询值的更多信息，请参阅 Microsoft 文档中的查询元数据和/或查询数据页面。
6. 在添加到字典活动之后添加搜索记录活动。
7. 在“ 对象 ” 属性中，选择“ 帐户”。
8. 在“ 查询选项 ” 属性中，输入您在上面创建的 Dictionary<String,String> 变量（例如， queryOption）。
9. 在“ 结果 ” 属性中，创建并输入 DataTable 变量（例如， searchResults）。
在“ 搜索记录” 活动之后添加“分配”活动。
1. 在“目标 ” 属性中，创建并输入 String 变量（例如， webURL）。
2. 在“ 值 ” 属性中，输入以下内容： searchResults.Rows(0).Item("websiteurl").ToString。
  - 有关每个实体的列名称的更多信息，请参阅 Microsoft 文档中的 Web API 实体类型参考。
3. 在“ 分配 ”活动后添加“条件”活动。
4. 使用 URL 的默认值创建一个 String 变量（例如，名称：网站， 默认值： “www.uipath.com”）。
5. 在“ 条件” 属性中，输入以下内容： webURL = website。
6. 在“ Then 语句” 框中，添加一个“ 写入行 ” 活动，其中包含以下文本： “Website present”。
7. 在“ Else 语句”框中，添加“ 更新记录” 活动。
  1. 单击“ 更新记录” 活动中的“配置”按钮（这将打开“ 对象向导”）。
    1. 在“ 选择实体 ” 下拉列表中，选择“ 帐户”。
    2. 在 accountId 字段中，输入您为“ 插入记录” 活动创建的 String 变量（例如 accountId）。
    3. 在“ 添加单个字段 ” 文本框中，输入 websiteurl ，然后单击“Enter”。
    4. 在名称字段中，输入您在上述步骤中创建的 String 变量（例如 website）。
    5. 单击“ 完成” 按钮。

测试您的项目

在“ 更新记录” 活动之后（在“ Else 语句”框中）添加“获取记录”。
1. 单击“ 获取记录” 活动中的“配置”按钮（这将打开“ 对象向导”）。
  1. 在“ 选择实体 ” 下拉列表中，选择“ 帐户”。
  2. 在 accountId 字段中，输入您为“ 插入记录” 活动创建的 String 变量（例如 accountId）。
  3. 在“ 添加单个字段 ” 文本框中，输入 websiteurl ，然后单击“Enter”。
  4. 在 网站 URL 字段中，创建并输入 String 变量（例如， websiteVerification）。
  5. 单击“ 完成” 按钮。
2. 在“ 获取记录” 活动之后（在“ Else 语句”框中）添加“ If条件”活动。
3. 在“ 条件” 属性中，输入以下内容： website = websiteVerification。
4. 在“ Then 语句” 框中，添加一个“ 写入行 ” 活动，其中包含以下文本： “网站更新成功！”.
5. 在“ Then 语句” 框中，添加一个“ 写入行 ” 活动，其中包含以下文本： “网站更新失败”。
在第一个“IF条件”活动之外添加“ 删除记录 ”活动。
1. 在“ 对象 ” 属性中，选择“ 帐户”。
2. 在“ ID ” 字段中，输入您为“ 插入记录” 活动创建的 String 变量（例如， accountId）。
3. 在 MicrosoftDynamicsStatus 属性中，创建并输入 ResponseStatus 变量（例如， responseStatus）。
在“ 删除记录” 活动之后添加“写入行”活动。
1. 在“ 文本 ” 属性中，输入以下内容： “已删除记录：”+responseStatus.Success.ToString。
单击 “运行” 并验证“ 输出 ”窗口是否包含预期的写入行值。