1 概述
树筛选组件指以展示树形结构过滤数据的组件。通过树筛选组件组件可以展示有层级关系的字段，例如”国家通过树筛选组件可以展示有层级关系的字段，例如”国家-省份-城市“的层级关系。
| 信息 |
|---|
1、目前树筛选组件只支持拖入：字符串字段，时间层次，不支持 日期字段、数值字段、度量、命名集。 2、树筛选组件需要开启数据模型引擎V2.0才能正常使用。 |
1.1 功能简介
树筛选组件包含：单选下拉树、多选下拉树、单选列表树、多选列表树。
1.2 整体逻辑说明
传值规则：
| 信息 |
|---|
传值只传主动选择的节点值，不区分父子节点，但区分包含和排除：传值只传主动选择的节点值，不区分父子节点，但区分包含和排除： 1、主动选择的节点值，当没有直接的上下级关系时：默认都直接传值。 6、不满足的场景：只传子节点的值，不包括父节点信息（目前能满足的场景是只要选择了子节点的值，查询时一定会同步过滤父节点的值）。 |
1.3展示效果
| 筛选器类型 | 说明 | 示例效果 | |||
|---|---|---|---|---|---|
| 单选下拉树 | 1、如果选择父节点，会查询该目录下所有子节点的数据。 2、如果选单个子节点，则是查询该该父节点下子节点的数据（一条路径上）。 |
| |||
| 多选下拉树 | 三态：全选、半选、不选 1、如果选择父节点，会查询该目录下所有子节点的数据。 2、如果选单个子节点，则是查询该父节点下子节点的数据（一条路径上）。
|
| |||
| 单选列表树 | 同单选下拉树逻辑一致。 |
| |||
| 多选列表树 | 同多选下拉树逻辑一致。 |
| |||
2 示例说明
2.1
...
区域-省份-城市树结构
介绍如何添加树筛选组件。例如，添加树筛选组件，实现对仪表板上的其他组件的数据进行过滤。
...
| |
| 1、直接选父节点、子节点进行查询 |
|---|---|
| 2、如果树上的节点、层级很多，没办法一次性看清楚选择了哪些节点，可以点击“查看已选”，可以显示全部已选择的节点信息。 | |
| 3、点击“搜索”，可以通过关键字进行搜索出对应的节点，这里是模糊匹配。 | |
4、显示的是已勾选的节点，多个时，显示+1、2、3..... 5、组件设置，下拉框的设置基本一致。 | |
| |
| 1、名称：默认是拖入的第一个字段名称。 2、控件类型：可以切换成其他的筛选器。 3、筛选字段：显示所有拖入的字段。 4、操作符：包含、不包含。2、控件类型：可以切换成其他的筛选器。 3、筛选字段：显示所有拖入的字段，只支持拖入：字符串字段，时间层次，不支持 日期字段、数值字段、度量、命名集。 4、操作符：包含、不包含。 5、默认值：只有列表选择、保存值、特殊值 6、备选值：不支持。 7、显示“全部”：默认勾选，勾选的话，在组件中会显示“全部”，不勾选就不显示出来，与其他筛选组件逻辑一致。 |
...
3、再拖入一个汇总表并且设置多选下拉树组件应用于它，筛选数据如下图：
| 信息 |
|---|
...
目前类似示例这种平铺数据的，无法单独查看父节点的数据。 |
2.2
...
机构树
| 信息 |
|---|
前置条件 1、由于示例使用了 机构信息汇总表 机构交易汇总表 进行分析，在复现示例时，可以把数据先导入到模型中，详细请参考：导入文件数据。 2、示例下载数据：机构交易汇总表.xls 数据概览：是一个父子结构数据列表：数据概览：
|
现在想要通过构造一个机构列表树查询各个分行/支行的存款、贷款情况，最终效果如下图：
...
2、去创建仪表盘，在画布中，拖入 多选列表树筛选器 ，并且拖入对应对的层次字段：机构名称、一级分行、二级分行、一级支行、二级支行。并且拖入对应的层次字段：机构名称、一级分行、二级分行、一级支行、二级支行。
| 选项 | 说明 |
|---|---|
| 层级字段 |
|
| (null) |
|
| (null)值的显示名 |
|
| (null)值节点展开 |
|
3、拖入汇总表，现在仅想要查看：广州分行汇总 的数据? 只需要勾选 广州分行汇总 的(null) 即可查询 只有广州分行的数据。如果只想查询父节点，需要选择：空白/(null） 的子节点。
...
4、如果只想查询某个子节点数据,目前还不支持，传值的时候一定会带上父节点。
2.3 父子结构机构树
如下图所示的父子结构数据(有ParentID、ID)，用树筛选组件无法实现，需要使用数据模型中的下拉参数实现。例子参考：父子结构数据实现下拉树参数。
