什么是层级过滤器？
层级过滤器是一种动态筛选控件，用于处理具有明确父子关系的层级数据。通过将父级字段和子级字段关联在一起，层级过滤器能以多级结构的形式呈现数据，并允许用户逐级选择所需的数据项。这种控件能显著提升用户在处理多层次数据场景下的效率和体验。
层级过滤器的使用场景
组织架构筛选： 用于选择公司、部门、团队或个人的层级结构。
分类目录筛选： 产品大类、子类及具体型号的筛选。
地理位置选择： 国家、省份、城市等多级地理区域选择。
任务管理： 从项目到子任务再到执行人的层级选择。
流程分类： 业务流程中的分类和子流程筛选。
在易企办中，层级过滤器控件可以在审批表单、列表表单、自定义页面中使用。
如何使用层级过滤器？
首先在表单设计器页面中，点击+按钮，在控件面板—数据筛选器—层级过滤器，点击并拖动层级过滤器控件到右侧画布中，下方是层级过滤器控件的详细设置
一.、基础
标题： 设置层级过滤器的标题，用于描述控件的用途，例如“组织架构选择”。
过滤变量： 选择或输入一个变量名称，用于存储用户的选择值，便于后续处理，例如
filter_variable。应用方式： 设置用户操作后触发的动作类型，通常选择“值变更”。
二、选择选项
层级过滤器控件支持三种数据来源：部门、元数据 和 动态。每种来源的配置方式和适用场景各有特点。以下是具体的设置说明。
1、来源：部门
部门来源用于基于企业组织架构的数据筛选，如公司、部门、团队等。通过选择指定的父节点，可以快速限定数据的起始范围，便于用户层级筛选。
指定父节点：
固定： 手动输入父节点名称以确定数据加载的起点。例如选择“产品团队”，则从“产品团队”及其下属部门开始加载。
变量： 根据动态条件筛选父节点，适合与业务规则结合使用。
最大选项数： 限制用户可选择的最大项目数量（默认 20）。
多选： 是否允许用户选择多个选项。
开启层级： 是否启用多级结构展示。
可折叠： 是否允许用户展开或折叠层级节点。
默认折叠： 控件加载时是否默认折叠所有层级。
适用场景
部门筛选，如审批流程中选择目标部门。
用于组织架构管理。
2、来源：元数据
元数据来源用于选择通用分类数据，例如假期类型、产品分类、地区分类等。这些元数据需要预先在系统中进行定义，并可供层级过滤器调用。
如何预定义元数据
路径： 管理中心 > 数据管理 > 元数据。
操作步骤：
在元数据管理页面，用户可以创建新的元数据分类并维护数据项。
新增分类： 点击右侧“新建记录”，输入分类名称（如“假期类型”）。
扩展字段和排序： 配置每个数据项的扩展信息和展示顺序。
关键配置项
选择范围：
当前应用： 限定元数据的使用范围为当前应用。
全局元数据： 如果支持，用户可以选择其他应用内的元数据（在系统中预先定义的元数据）。
元数据分类： 必须从已有元数据分类中选择，例如“假期类型”。
指定父节点：
固定： 手动输入父节点名称以确定数据加载的起点。例如选择“无薪假”，则从“无薪假”及其下属节点开始加载。
变量： 根据动态条件筛选父节点。
层级设置： 与部门一致，支持最大选项数、多选和开启层级。
适用场景
按照标准分类（如假期类型）筛选数据。
用于多业务场景下的统一数据管理。
3、来源：动态
动态来源适合实时加载数据库中的业务数据，能够根据用户的操作和权限展示不同的内容。配置过程中需要绑定具体的应用和数据源。
应用： 选择包含目标数据源的应用程序。
数据源： 选择应用中的具体数据列表、表单报表、文档库、数据报表。
数据过滤： 设置过滤条件，确保加载符合业务规则的数据。
首要排序和次要排序：首要排序用于确定数据的主要排序规则，次要排序在首要排序的基础上进一步细化排序，用于处理同级数据的排列优先级。
显示列： 显示列用于确定控件中展示给用户的内容，通常是数据表中的一个字段。控件会根据显示列加载当前层级的节点名称。
值字段： 值字段决定控件在用户选择某个节点时实际存储的字段值。它通常是每个节点的唯一标识，用于后续的数据处理或交互。
关系字段（父级）： 关系字段（父级）用于指定数据项的上一级节点关系。控件根据父级字段查找并加载每个节点的父节点，从而动态生成树状层级关系。
关系字段（子级）： 关系字段（子级）用于标识每个节点自身的值，并与父级字段关联。控件通过对子级字段的递归查询，动态加载每个父节点的所有直接子节点，完成层级结构的逐级展开。
层级设置： 支持设置最大选项数、多选和开启层级。
适用场景
实时筛选动态数据，如项目任务、流程节点等。
结合权限动态加载数据。
三、显示
启用搜索：开启后，用户可以通过搜索框快速定位需要的数据项，适用于数据量较大的场景。默认关闭。
启用下拉框：开启后，控件会以下拉列表的形式展示层级数据。默认关闭。
显示标题：控制是否在控件上方显示标题。默认开启。
标题布局：定义标题在控件中的位置。
垂直对齐：设置标题在控件垂直方向的对齐方式。选项包括默认、顶部对齐、中部对齐、底部对齐。
标题宽度：用于调整标题的宽度，可以调整宽度单位。
动态显示规则：设置控件的动态显示条件，例如根据其他控件的值或状态动态控制层级过滤器的显示/隐藏。
四、验证
只读： 设置控件是否仅用于展示数据，不允许用户操作。
自定义验证： 根据业务需求配置控件的验证规则，并设置规则内容和提示消息。
五、动作
值变更：配置用户更改值时的触发动作，例如触发表单刷新、加载其他控件数据等。
注意事项
确保数据的完整性： 数据表必须包含清晰的父级和子级字段关系，且数据之间的层级关系无错误。
字段选择的正确性： 在显示列、值字段、父级字段、子级字段中，确保字段的含义和用法与实际业务需求一致。
优化用户体验： 根据场景合理设置排序、层级展开和搜索功能，提升控件的可用性。
通过以上设置和操作，层级过滤器控件可以轻松应对复杂的多级数据筛选需求，提升用户操作的效率和准确性。