10-Decisions Datastructures数据结构：数据查询Fetch Entity步骤全解析

Ne0inhk

23 Mar 2026 — 9 min read

Decisions Datastructures数据结构：数据查询Fetch Entity步骤全解析

前言

在前两篇内容中，我们了解了Decisions自定义数据结构的创建方法，以及数据结构与数据库的映射关系、基础增删改操作。而在实际的业务流程中，数据查询是使用频率最高的操作——从数据库中精准获取所需数据，才能支撑流程的分支判断、数据展示、业务逻辑处理等核心场景。

Decisions V9中封装了专门的查询步骤Fetch Entity，它相当于平台内置的基础SELECT查询，无需手动编写SQL，通过可视化配置就能实现数据的筛选、限制、排序。本文将从Fetch Entity的核心作用讲起，详细解析步骤的属性配置、筛选条件的设置方法。

一、Fetch Entity步骤概述

Fetch Entity是Decisions中用于获取数据记录的基础且核心步骤，适用于用户自定义数据结构和平台内部数据类型，是实现所有数据查询场景的基础，其设计贴合低代码的可视化特点，无需掌握SQL语法即可上手。

1. 核心作用

作为Decisions的基础「查询器」，实现对自定义数据结构/平台内部数据类型的记录查询；
支持条件筛选、结果数量限制、字段排序，覆盖日常业务中90%以上的基础查询场景；
输出查询结果供下游流程使用（如表单展示、流程分支判断、数据修改）。

2. 两大默认输出路径

Fetch Entity步骤设计了分支化的输出逻辑，根据查询结果自动走不同的流程路径，方便开发者做后续的异常处理和逻辑分支，这是Decisions流程设计的核心特点之一：

Results（结果路径）：当查询到符合条件的数据时，流程沿此路径执行，会输出查询到的数据集；
No Results（无结果路径）：当未查询到任何数据时，流程沿此路径执行，无任何数据输出，仅用于流程分支控制（如添加「无数据提示」「终止流程」等逻辑）。

重要提示：No Results路径仅做流程分支，无法输出「空数据」相关内容，若需对无数据场景做处理，需在该路径下单独配置步骤。

二、Fetch Entity步骤属性配置

Fetch Entity的所有查询逻辑均通过步骤属性面板可视化配置，核心配置项分为「必配项」和「选配项」，必配项用于指定查询的数据源，选配项用于实现精准的查询规则，配置界面简洁且逻辑清晰。

1. 必配项：Type Name（类型名称）

Type Name是Fetch Entity步骤唯一的必配项，用于指定「要查询哪个数据结构的记录」，配置规则和特点如下：

配置方式：通过下拉列表选择，支持检索，可快速找到目标数据类型；
支持类型：既可以是用户自定义数据结构（如之前创建的Employment Information），也可以是Decisions内部数据类型（如Account、User等）；
配置后效果：选定Type Name后，步骤的输出会自动变为该类型的列表（List of [Type Name]），无需手动配置输出类型，平台会自动适配。

核心原则：Type Name必须与要查询的数据源一致，否则会出现查询无结果或流程报错的情况。

2. 选配项：数据筛选、限制与排序

完成Type Name配置后，即可通过三个选配项实现精准的查询规则，三个配置项可单独使用，也可组合使用，满足不同的查询需求。

配置项	核心作用	配置细节
Fetch Criteria（获取条件）	为查询添加筛选规则，仅返回符合条件的记录	可添加多个条件，支持按数据结构的任意字段筛选
Limit（限制）	限制查询返回的结果数量	输入数字即可，如填「10」则仅返回前10条记录
Sort（排序）	对查询结果按指定字段排序	包含两个子项：Sort Field（排序字段）、Sort Order Field（排序方式：升序Ascending/降序Descending）

三、Fetch Criteria（获取条件）深度解析

Fetch Criteria是Fetch Entity步骤中最核心的选配项，也是实现「精准查询」的关键，其支持按数据结构的任意字段配置筛选条件，且支持多条件组合，以下详细讲解配置方法、逻辑规则和注意事项。

1. 单个筛选条件的添加与配置

添加单个条件的操作步骤简单，且条件的配置项会根据字段数据类型动态适配（如数字类型支持「大于/小于」，文本类型支持「包含/等于」），无需手动选择适配的比较逻辑：

点击Fetch Criteria旁的添加按钮，弹出条件配置面板；
配置第一个子项Field Name：选择要筛选的数据结构字段（如Age、FirstName、HireDate）；
配置第二个子项Comparison Logic：选择比较逻辑（平台会根据Field Name的类型自动筛选适配的逻辑，无无效选项）；
配置第三个子项Input Mapping：传入筛选值，支持常量、流程数据、空值、转换器等多种方式，适配不同的业务场景。

2. 多条件的组合逻辑

在实际业务中，经常需要多条件组合查询（如「年龄≥25 且姓名包含R」），Fetch Criteria对多条件的处理有固定规则，需严格遵循：

默认逻辑：多个筛选条件之间默认使用AND（与）逻辑组合，即只有同时满足所有条件的记录，才会被查询返回；
逻辑限制：Fetch Criteria不直接支持OR（或）逻辑（如「年龄≥25 或姓名包含R」），若需实现OR逻辑，需通过Decisions的规则（Rule） 或自定义代码实现；
多条件添加：继续点击Fetch Criteria旁的+按钮，即可添加多个条件，所有条件会按AND逻辑组合。

3. 注意事项

筛选值的类型必须与Field Name的类型一致（如数字类型字段不能传入文本常量），否则会触发流程报错；
文本类型的筛选支持大小写不敏感（选择Contains (Without Case)比较逻辑），是日常开发中最常用的文本筛选方式；
日期类型字段的比较逻辑支持「大于/小于/等于」（如HireDate > 2025-01-01），可实现时间范围的筛选。

四、实操演示：实现三类常见的查询场景

结合之前创建的Employment Information（员工信息）自定义数据结构，实现日常开发中最常见的三类查询场景。

场景1：查询某数据结构的全部记录

业务需求：获取所有员工的信息记录，无任何筛选条件，用于员工列表展示。
操作步骤：

打开Decisions流程设计器，拖拽Fetch Entity步骤到流程中；
在属性面板配置Type Name为Employment Information；
不配置Fetch Criteria、Limit、Sort（保持默认）；
运行流程调试，步骤会沿Results路径执行，输出所有员工信息的列表。

场景2：添加单条件筛选查询

业务需求：获取「入职时间≥2025-01-01」的员工信息，实现时间范围筛选。
操作步骤：

拖拽Fetch Entity步骤，配置Type Name为Employment Information；
点击Fetch Criteria旁的+按钮，添加筛选条件：
- Field Name：选择HireDate（入职时间）；
- Comparison Logic：选择Greater Than Or Equal（大于等于）；
- Input Mapping：选择「常量」，输入2025-01-01；
运行流程调试，步骤仅返回入职时间符合条件的员工记录。

场景3：添加多条件筛选+排序查询

业务需求：获取「是否为管理者（IsManager=True）且姓名包含Li（大小写不敏感）」的员工信息，并按入职时间降序排序。
操作步骤：

拖拽Fetch Entity步骤，配置Type Name为Employment Information；
添加第一个筛选条件：
- Field Name：IsManager；
- Comparison Logic：Equal；
- Input Mapping：常量True；
继续点击+按钮，添加第二个筛选条件：
- Field Name：FirstName；
- Comparison Logic：Contains (Without Case)；
- Input Mapping：常量Li；
配置排序：Sort Field选择HireDate，Sort Order Field选择Descending（降序）；
运行流程调试，步骤仅返回同时满足两个条件的员工记录，且结果按入职时间从新到旧排序。

五、总结

Fetch Entity是Decisions的核心数据查询步骤，相当于内置的基础SELECT查询，支持自定义/平台内部数据类型的记录查询；
步骤有两大输出路径：Results（有数据，输出数据集）、No Results（无数据，仅分支控制），无数据路径不输出任何内容；
Type Name是唯一必配项，选定后步骤会自动适配输出类型，必须与查询的数据源一致；
Fetch Criteria是精准查询的关键，支持按任意字段添加筛选条件，比较逻辑会根据字段类型动态适配，筛选值类型需与字段类型一致；
多条件默认使用AND逻辑组合，不直接支持OR逻辑，需通过规则/自定义代码实现；
筛选、限制、排序三个选配项可自由组合，满足日常90%以上的基础查询场景。

系列预告

本文为Decisions数据结构的第三篇，讲解了Fetch Entity步骤的配置和实操，掌握后即可实现各类基础的数据查询。下一篇将为大家讲解Decisions数据结构的进阶扩展功能——配置文件夹（Configuration Folders），包括配置文件夹的核心作用、三大功能、自定义仪表板的创建。

注意：本文仅代表个人学习记录，如需生产环境级方案，请咨询艾体宝团队。