查询实体记录

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

描述

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

项目兼容性

Windows | 跨平台

设计器面板

• “实体” - 选择要与活动一起使用的实体。该属性仅支持从 Data Service 中导入的实体。
• “查询” - 选择实体后，向导会要求您配置查询。在“筛选器构建器”向导中：
  1. 单击“添加条件”或“添加组” 。从第一个下拉菜单中，选择要作为选择实体类型筛选依据的字段。您也可以为任何相关实体选择字段。
  2. 从第二个下拉菜单中，选择用于评估所选字段的运算符。 运算符列表将根据第一个下拉菜单中所选字段的类型而变化。
  3. 对于第三个表达式字段，为所选字段提供值或输入表达式。 支持的值将根据第一个下拉菜单中所选字段的类型而变化。
  4. 如果要添加其他条件或组，请单击“添加条件” ，然后选择是使用“全部”还是“任何条件”进行筛选。

属性面板

选项

• “按字段排序” - 要对检索到的记录进行排序的字段的名称。名称必须与所选实体类型中的有效字段相同，且要使用相同的大小写。默认情况下，此字段设置为ID 。
• Sort Ascending - Sorts records in ascending order based on the field specified in the Sort By property This field supports only Boolean values (True, False). The default value is True.
• 置顶- 指定从总记录中检索到的记录的最大数。此属性支持从 1 到 1000 的值。此字段的默认值为100 。
• “跳过” - 帮助您跳过指定数量的记录。如果指定值大于记录总数，则不检索任何记录。此属性支持大于或等于 0 的值。默认情况下，该属性设置为0 。
• “超时(毫秒)”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 30000 毫秒（30 秒）。
• Related Record Depth - Specifies the depth of related records to be retrieved from the service. This property supports values from 1 to 3. The default value is 2.

输出

• 记录总数- 与指定查询筛选条件匹配的记录总数，存储在“Int64”变量中。此字段仅支持Int64变量。
• 输出记录- 从 Data Service 中检索到的记录列表。此字段仅支持从 Data Service 导入的“列表”类型对象，并且必须与所选实体类型相同。