查询实体记录

UiPath.DataService.Activities.QueryEntityRecords<UiPath.DataService.Definition.IEntity>

描述

根据指定的筛选条件，从 UiPath 数据服务中检索选定实体的记录列表。

项目兼容性

Windows | 跨平台

设计器面板

• “实体 ” - 选择要用于活动的实体。 该属性仅支持从 Data Service 导入的实体。

• 查询 - 选择实体后，向导会要求您配置查询。

  在“ 筛选器构建器 ”向导中：

  1. 单击“ 添加条件” 或 “添加组”。 从第一个下拉菜单中，为所选实体类型选择要作为筛选依据的字段。 您也可以为任何相关实体选择字段。

  2. 从第二个下拉菜单中，选择用于评估所选字段的运算符。 运算符列表将根据第一个下拉菜单中所选字段的类型而变化。

  3. 对于第三个表达式字段，为所选字段提供值或输入表达式。 支持的值将根据第一个下拉菜单中所选字段的类型而变化。

  4. 如果要添加其他条件或组，请单击“ 添加条件 ”，然后选择是否应使用“ 全部” 或“ 任何 条件”进行筛选。

属性面板

选项

• “按字段排序” - 要对检索到的记录进行排序的字段的名称。 名称必须与所选实体类型中的有效字段相同，并且大小写相同。 默认情况下，此字段设置为 Id。

• “升序排序 ” - 根据“排序依据” 属性中指定的字段，按升序对记录进行 排序。 该字段仅支持布尔值（True、False）。 默认值为 True。

• “前” - 指定在总记录中检索到的最大记录数。 此属性支持 1 到 1000 之间的值。 此字段的默认值为 100。

• 跳过 - 帮助您跳过指定数量的记录。 如果指定的值大于总记录数，则不检索任何记录。 此属性支持大于或等于 0 的值。默认情况下，此属性设置为 0。

• “超时（以毫秒为单位）”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 30000 毫秒（30 秒）。

• “相关记录深度” - 指定要从服务中检索的相关记录的深度。 此属性支持 1 到 3 之间的值。默认值为 2。

输出

• “记录总数” - 与指定查询筛选器匹配的记录总数，存储在 Int64 变量中。 此字段仅支持 Int64 变量。

• “输出记录” - 从 Data Service 检索到的记录列表。 此字段仅支持从 Data Service 导入的类型的 列表 对象，并且必须与所选实体类型具有相同类型。