搜索记录

UiPath.MicrosoftDynamics.Activities.SearchRecords

借助您的搜索参数（ “查询选项”和“对象”），“搜索记录”活动将使用网页 API GET操作来检索记录。

检索记录后，该活动在 DataTable 对象 (Result) 中输出结果，并在 ResponseStatus 对象 (MicrosoftDynamicsStatus) 中输出请求的状态（成功/失败信息），您可以在后续活动中使用这两者（例如，条件逻辑、 更新记录、 下载活动附件等）。

工作方式

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

1. 完成 设置 步骤。
2. 将“ Microsoft Dynamics 应用程序作用域 ” 活动添加到您的项目中。
3. 在“ Microsoft Dynamics 应用程序作用域 ”活动中添加“搜索记录”活动。
4. 选择要检索的 对象 ，然后在 选项 属性中输入搜索参数。
5. 为“ 输出 ” 属性创建并输入 DataTable 和 ResponseStatus 变量。
   • 您的输入属性值在GET操作请求中发送。
   • 此操作会将 DataTable 和 ResponseStatus 值返回到您的输出属性变量。
     
     

     

     
     

在活动正文中

• “ 对象 ” - 使用“ 对象向导 ” 选择 对象 。

属性

常见

• “显示名称 ” - 活动的显示名称。 此字段仅支持字符串或 String 变量。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

选项

• “查询选项” - 要用于检索记录的搜索参数。 输入Dictionary<String, String>或Dictionary<String, String>变量。 有关查询值的更多信息，请参阅 Microsoft 文档中的“查询元数据”和/或“查询数据”页面。 请参阅以下步骤，了解创建和填充Dictionary<String, String>变量的一种方法。
  备注：

  以下是填充 Dictionary<String, String> 变量的一种方法：

  • 安装 Microsoft.Activities.Extensions 包。
  • 创建新的 Dictionary<String, String> 变量（例如， queryOption）。
  • 添加“ 添加到字典” 活动。
  • 输入您的 字典 变量（例如， queryOption）
  • 在“ 键 ”属性中输入单个查询方法（例如， “$filter”、 “$select”等）

  • 输入要应用于查询方法的 值 （例如， “name eq 'Quickstart_Account'”）

    • 重复步骤 3 以应用其他 查询选项。

输出

• “响应 状态” - 请求的状态（成功/失败信息）。 输入 ResponseStatus 变量 (UiPath.BAF.Models.ResponseStatus)。 ResponseStatus 对象包含三个可在其他活动中使用的属性。
  • “成功” - Boolean - 指定 API 请求是否成功。
  • 错误代码 - String - API 请求不成功 (Success=False) 时的响应错误。
  • 消息 - String - 错误消息。
• “结果 ” - 与搜索参数匹配的记录。 输入 DataTable 变量。

示例

下图显示了活动依赖关系和输入/输出属性值的示例。

有关分步说明和示例，请参阅 快速入门 指南。