查询多条实体记录

向 Data Fabric API 发送请求，以查询主要实体中的记录，并可选择通过字段级筛选器扩展至次要实体。

描述

向 Data Fabric API 发送请求，以查询主要实体中的记录，并可选择通过字段级筛选器扩展至次要实体。

此活动等效于 Data Service 传统活动包中的同名活动。

项目兼容性

Windows | 跨平台

支持的工作流

Studio 桌面版和 Studio Web 中的所有工作流。

属性

• UiPath Data Fabric 连接- 选择您在 Integration Service 中建立的 Data Fabric 连接。访问下拉菜单，以选择、添加或管理连接。
• 主要实体- 指定要从中检索记录的主要实体。
• “次要实体” - 指定要与主要实体联接的相关实体。
• 联接类型- 定义在主要实体和次要实体之间执行的联接类型。
  • “内部联接” - 选择此项可仅返回在两个实体中都存在匹配值的记录。
  • “左联接” - 选择可返回来自主要实体的所有记录和来自次要实体的匹配记录。如果不存在匹配项，则次要字段将返回 null。
• 主实体联接字段- 指定主要实体中用于建立联接关系的字段。
• “次要实体联接字段” - 指定次要实体中用于建立联接关系的字段。
• 筛选条件- 为来自主要和/或次要实体的记录定义筛选条件。筛选条件生成器的工作原理与“查询实体记录”中的筛选条件生成器类似，字段名称来自主要实体和次要实体。

“筛选器生成器”提供了一组运算符，您可使用它们来根据实体字段的值筛选记录。字段可用的运算符取决于其数据类型。

下表介绍了每个受支持的运算符及其适用的数据类型。

对于“In”和“Not In”运算符，以逗号分隔的列表形式输入值。字段名称以实体名称为前缀 — 例如，Name 实体中的 Student 字段显示为 Student_Name，关系字段使用“查询实体记录”中的点符号。要仅返回 Student_Name 为 John 或 Jane 的记录，请输入 John,Jane。

运算符	描述	适用的数据类型
等于 (=)	匹配字段值精确等于指定值的记录。	“文本”、“数字”、“是/否”、“日期时间”、“选项集”
不等于 (!=)	匹配字段值不等于指定值的记录。	“文本”、“数字”、“是/否”、“日期时间”、“选项集”
小于 (<)	匹配字段值小于指定值的记录。对于日期字段，这将返回日期或时间较早的记录。	数字、日期时间
小于或等于 (<=)	匹配字段值小于或等于指定值的记录。	数字、日期时间
大于 (>)	匹配字段值大于指定值的记录。对于日期字段，这将返回日期或时间较晚的记录。	数字、日期时间
大于或等于 (>=)	匹配字段值大于或等于指定值的记录。	数字、日期时间
包含	匹配字段值包含指定文本子字符串的记录。	文本
不包含	匹配字段值不包含指定文本的记录。	文本
开头为	匹配字段值以指定文本开头的记录。	文本
结尾为	匹配字段值以指定文本结尾的记录。	文本
输入	匹配字段值等于指定列表中任何值的记录。	文本、数字、日期时间、选项集
不属于	匹配字段值不等于指定列表中的任何值的记录。	文本、数字、日期时间、选项集
为 Null	匹配字段值为 null 的记录。此运算符不需要输入值。	“文本”、“数字”、“是/否”、“日期时间”、“选项集”
不为 Null	匹配字段包含非空值的记录。此运算符不需要输入值。	“文本”、“数字”、“是/否”、“日期时间”、“选项集”
为 true	匹配是/否字段为 True 的记录。此运算符不需要输入值。	是/否
为 false	匹配是/否字段为 False 的记录。此运算符不需要输入值。	是/否

选项

• 跳过- 指定从开头开始跳过的记录数。
• 置顶- 指定最多要返回的记录数。属性支持从 1 到 1000 的值。默认值为 100。
• 升序排序- 指定是按升序 (true) 还是降序 (false) 排序。
• 按字段排序- 指定用于对返回的记录进行排序的字段。

输出

• 查询多个实体记录— 返回通过联接两个选定实体并应用提供的筛选器生成的记录列表。每条记录包含调用者有权访问两个实体的所有字段。