活动

快速入门 - 记录

概述

本指南旨在帮助您创建使用以下 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。
单击 “运行” 并验证“ 输出 ”窗口是否包含预期的写入行值。