查询实体记录

“查询实体记录”节点，用于从流程中的 Data Fabric 实体中读取一条或多条记录，无需连接 Integration Service。

从 Data Fabric 实体中读取一条或多条记录。这是一个原生流节点，不需要 Integration Service (IS) 连接。它适用于 Data Fabric 平台中的现有实体（租户实体和文件夹实体），以及 VS Code 解决方案中定义的实体。请参阅VS Code 中的实体。

配置

字段	必填	描述
Data Fabric 实体	是	要查询的实体。如果实体的字段自添加节点后发生了更改，请选择“刷新架构” 。
要返回的记录	是	单个记录将返回一条记录，如果筛选器匹配多个记录，则单个记录将失败。多个记录将返回匹配记录的数组。
筛选条件	否	一个或多个字段/运算符/值条件，与All (AND)或Any (OR)配合使用。
排序方式（仅限多条记录）	否	对结果进行排序的字段和方向（升序或降序）。如果不排序，查询每次都会返回不同的记录集。
要跳过的记录（仅限多个记录）	否	返回结果之前要跳过的匹配记录数。默认 0。
记录限制（仅限多条记录）	否	要返回的最大记录数。默认 100，最大 1000。

在筛选条件中，选择“添加条件”以在同一级别创建另一个条件，或选择“添加组” ，以使用其自己的 AND/OR 逻辑嵌套条件组。

此节点不支持“错误处理”选项卡。

输出

对于“单个记录” ，输出字段直接镜像实体的架构。对于多个记录，输出为results数组，其中每个项目都镜像实体的架构。在下游作为 $vars.<nodeId>.output.<fieldName>（单个记录）或 $vars.<nodeId>.output.results[<index>].<fieldName>（多个记录）访问它们。

实时参考行为

输出是对查询的实时引用，而不是结果的存储副本。读取它的每个表达式、条件或脚本都会在该时刻重新运行查询，因此它始终会查看实体的当前数据。架构树中的“实时查询”芯片会标记具有这种行为的输出。

例如，如果名为“查找工单”的节点的“查询实体记录”返回状态为Open的工单，而流程中稍后的节点将该工单设置为Closed ，则该点之后的$vars.Find ticket.output.Status表达式将返回Closed — 不是查询首次看到的Open值。存储的副本仍会显示 Open。

“将实体记录设置为实体引用更新”和“删除实体记录设置为实体引用”在此基础上构建：它们处理此查询找到的记录，而无需重新指定实体和筛选器。

循环和数据转换集合是例外。它们会读取节点运行时所获取结果的快照，而不是重新运行查询。