1 概述

树筛选组件指以展示树形结构过滤数据的组件。通过树筛选组件可以展示有层级关系的字段，例如”国家-省份-城市“的层级关系。

1、目前树筛选组件只支持拖入：字符串字段，时间层次，不支持 日期字段、数值字段、度量、命名集。

2、树筛选组件需要开启数据模型引擎V2.0才能正常使用。


1.1 功能简介

树筛选组件包含：单选下拉树、多选下拉树、单选列表树、多选列表树。

1.2 整体逻辑说明

传值规则：

传值只传主动选择的节点值（如果选择子节点，会包含父节点相关信息），不区分父子节点，但区分包含和排除：

1、主动选择的节点值，当没有直接的上下级关系时：默认都直接传值。
2、主动选择的节点值，如果有直接的上下级关系，并且如果是先选父节点，再取消子节点，则需要传选择的父节点，以及排除选择的子节点。
3、实际传值不区分父子节点，但会包含路径信息。
4、全部：是特殊处理的节点，直接选它，表示不用传值（实际可使用不用传值的字符串作为它的真实值）。
5、如果只想查询父节点，需要选择：空白/null 的子节点。

6、不满足的场景：只传子节点的值，不包括父节点信息（目前能满足的场景是只要选择了子节点的值，查询时一定会同步过滤父节点的值）。

1.3展示效果

筛选器类型说明示例效果
单选下拉树

1、如果选择父节点，会查询该目录下所有子节点的数据。

2、如果选单个子节点，则是查询该该父节点下子节点的数据（一条路径上）。



多选下拉树

三态：全选、半选、不选

1、如果选择父节点，会查询该目录下所有子节点的数据。

2、如果选单个子节点，则是查询该父节点下子节点的数据（一条路径上）。


  • 选父节点：会自动选择全部的子节点。
  • 选子节点：只会半选父节点，就算选择了全部的子节点，也不会自动全选父节点。



单选列表树同单选下拉树逻辑一致。


多选列表树

同多选下拉树逻辑一致。


2 示例说明

2.1 区域-省份-城市树结构

介绍如何添加树筛选组件。例如，添加树筛选组件，实现对仪表板上的其他组件的数据进行过滤。

以产品内置的订单模型为示例，具体操作如下：

1、打开仪表盘，这里选择“多选下拉树组件，如下图所示：

2、给多选下拉树组件选择数据字段：发货区域、省份、发货城市

拖入多个字符串类型的字段，多选下拉树会自动构建多层结构的关系树。

可以直接勾选树上的父节点或子节点信息，进行查询；也可以通过输入关键字进行搜索，下面是针对下拉树的一些操作、设置项说明：

  • 操作说明(单选/多选下拉树、单选/多选列表树操作都是一致的，这里仅以多选下拉树进行说明)

1、直接选父节点、子节点进行查询
2、如果树上的节点、层级很多，没办法一次性看清楚选择了哪些节点，可以点击“查看已选”，可以显示全部已选择的节点信息。
3、点击“搜索”，可以通过关键字进行搜索出对应的节点，这里是模糊匹配。

4、显示的是已勾选的节点，多个时，显示+1、2、3.....

5、组件设置，下拉框的设置基本一致。

  •  筛选器设置

1、名称：默认是拖入的第一个字段名称。

2、控件类型：可以切换成其他的筛选器。

3、筛选字段：显示所有拖入的字段，只支持拖入：字符串字段，时间层次，不支持 日期字段、数值字段、度量、命名集。

4、操作符：包含、不包含。

5、默认值：支持类型包括 (全部)、保存值、从备选值中选择、备选值的第一个值、函数、用户属性、(null)、非(null)。

6、备选值：只支持设置是否显示“全部”：默认勾选，勾选的话，在组件中会显示“全部”，不勾选就不显示出来，与其他筛选组件逻辑一致。


3、再拖入一个汇总表并且设置多选下拉树组件应用于它，筛选数据如下图：

目前类似示例这种平铺数据的，无法单独查看父节点的数据。


2.2 机构树

前置条件

1、由于示例使用了 机构交易汇总表 进行分析，在复现示例时，可以把数据先导入到模型中，详细请参考：导入文件数据。

2、示例下载数据：机构交易汇总表.xls

数据概览：


现在想要通过构造一个机构列表树查询各个分行/支行的存款、贷款情况，最终效果如下图：

具体操作步骤如下：

1、新建数据模型，并把机构交易汇总表.xls导入到数据模型中，并且抽取以及保存数据模型，创建好的数据模型如下图：

2、去创建仪表盘，在画布中，拖入 多选列表树筛选器 ，并且拖入对应的层次字段：机构名称、一级分行、二级分行、一级支行、二级支行。

选项说明
层级字段
  • 拖入字段之后，会自动构建层次机构，排在前面的默认就是最大级或上级。只支持拖入：字符串字段，时间层次，不支持 日期字段、数值字段、度量、命名集。
(null)
  • 可以详细看到每个上级都显示了一个(null), 这个(null)非产品加的，是由于数据本身就存在的，产品根据  筛选器null值的显示名 (该设置项在运维设置/系统设置/公共设置中)默认展示对应的值。
(null)值的显示名
  • 如果不想显示(null),还可以在组件中的” (null)值得显示名 “中设置其他显示名，比如设置成“空白”。
(null)值节点展开
  • 如果有很多级，可能会存在多个(null)级，不想显示这么多级，可以在”(null)值节点展开“设置"关闭"选项，那么只会显示1级(null)。

3、拖入汇总表，现在仅想要查看：广州分行汇总 的数据? 只需要勾选 广州分行汇总 的(null) 即可查询 只有广州分行的数据。如果只想查询父节点，需要选择：空白/(null） 的子节点。

4、如果只想查询某个子节点数据,目前还不支持，传值的时候一定会带上父节点。


2.3 树筛选组件跳转规则传值


树筛选组件跳转传值规则： 在页面看到啥就传啥，即只传递树组件当前选中的值。

下面我们以一个示例进行说明：

1、以产品内置的订单模型为例，创建仪表盘，命名为“原始表”，如下图，有一个”单选下拉树“筛选器，联动汇总表：

2、再基于这个模型创建一个报表，命名为“跳转目标表”，目标报表上有3个下拉筛选器：区域、省份、城市：

3、在“原始表”的表格上创建跳转规则,“跳转目标表”的筛选器映射“原始表”下拉树字段：

4、当“原始表”的下拉树筛选器选中“只选中“区域’，跳转传递时，只会传递“区域”的值，”省份“、”城市“是不传递值:

目标表显示效果:

5、把”原始表“单选下拉树改成多选下拉树，选择值如下：

点击跳转到目标中，可以看到，只传递了已勾选的值：

2.4 父子结构机构树

如下图所示的父子结构数据(有ParentID、ID)，用树筛选组件无法实现，需要使用数据模型中的下拉参数实现。例子参考：父子结构数据实现下拉树参数。