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

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

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

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

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

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

2. 多条件的组合逻辑

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

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

3. 注意事项

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

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

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

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

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

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

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

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

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

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

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

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

五、总结

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

系列预告

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