筛选器组件基础功能

1 概述

本文主要介绍各类筛选器组件的通用基础功能。

2 名称

用于为筛选器添加标签。选中筛选器组件，在组件设置的数据中点击 筛选器设置 ，在筛选器设置的弹窗中进行名称设置，效果如下图所示：

3 筛选字段

在组件查询数据时，使用筛选字段与组件进行联动。比如下图中城市筛选器绑定的筛选字段是 发货城市 ，表格查询数据的结果，受发货城市字段筛选影响。

4 操作符

选择不同的操作符，会生成不同的筛选条件，进而影响最终的查询结果。

1、选中筛选器组件，在组件设置的数据中点击 筛选器设置 ，在筛选器设置的弹窗中进行操作符设置，如下图所示：

2、根据筛选器类型和绑定的字段类型的不同，可选择的操作符类型也不同。操作符的类型与筛选器类型、字段类型存在对应关系，如下表所示：

5 筛选器默认值

通过设置筛选器默认值来控制打开仪表盘时默认筛选哪些数据，默认值设置类型包括列表选择、静态值、保存值、相对值和特殊值。

5.1 设置入口及效果

1、选中筛选器组件，在组件设置的数据中点击 筛选器设置 ，在筛选器设置的弹窗中进行默认值设置。

2、打开仪表盘时，根据设置的筛选器默认值筛选数据。如下图中，今年为2023年，打开仪表盘希望默认查看3年前华南和西南的订单数据。

5.2 列表选择

列表选择支持直接点击选择字段值作为筛选器默认值。

1、列表选择仅支持 字符串 类型的筛选字段。

2、如果筛选字段的总行数超过1000行时，列表选择默认只显示前1000行的字段值。

3、筛选器组件类型为 单选列表、单选下拉和输入框筛选器时，默认值列表选择为单选；筛选器组件类型为  多选列表和多选下拉，默认值列表选择为多选。

5.3 静态值

静态值指手动输入筛选器的默认值。

• 日期类筛选器的静态值为选择日期、时间
• 非日期类筛选器的静态值为输入内容。

5.4 保存值

以当前仪表盘保存时的值作为筛选器下次打开仪表盘时显示的默认值。

5.5 相对值

以当前系统日期为参考点，设置按时间频度前后时间值为默认值。相对值 只支持日期类的筛选器。

设置完相对日期后，可以在右上角查看相对日期的计算结果是否符合预期。各日期频度支持的相对日期设置及结果说明如下：

不同的日期频度筛选器的相对日期计算逻辑一样，只不过计算结果截取的时间细粒度不同而已。假设系统当前日期为 2023-07-11 星期二 ，以日期筛选器为例。

场景示例详情可参考 默认获取相对日期 。

5.6 特殊值

用于设置一些复杂的筛选器默认值的场景，包括：全部、列表第一个值、(null)、非(null)、函数和用户属性。

1、全部：默认值为全部时，将不带任何过滤条件地查询所有值。

2、列表第一个值：每次刷新筛选器时，根据当前备选值列表，自动选择第一个值作为默认值。常用于筛选器联动的场景，场景示例详情可参考 多个筛选器组件联动 。

3、(null)：默认值为(null)时，则表示默认选择(null)值过滤数据。

4、非(null)：默认值为(null)时，则表示默认选择除(null)外的其他值过滤数据。

5、函数：利用函数设置筛选器默认值。

（1）只支持绑定字符串字段的列表筛选器、下拉筛选器和输入框筛选器。

（2）系统支持定义筛选器默认值的函数有如下表所示：

场景示例详情可参考 筛选器场景示例 ⬝ 函数 。

6、用户属性：将用户属性查询的结果作为筛选器默认值。一般适用于较复杂的筛选器默认值的场景，比如需要通过SQL才能获取查询结果。

用户属性不支持绑定数值型字段的筛选器。

场景示例详情可参考 筛选器场景示例 ⬝ 用户属性 。

6 筛选器备选值

对于列表筛选器和下拉筛选器，支持设置筛选器备选值有哪些项。

设置入口：选中筛选器组件，在组件设置的数据中点击 筛选器设置 ，在筛选器设置的弹窗中进行备选值设置。

6.1 全部

1、单选列表、单选下拉和多选下拉筛选器，支持设置是否在备选值列表中显示 全部 选项。选择 全部 时，将不带任何过滤条件地查询所有值。

2、多选列表筛选器支持设置是否在备选值列表中显示 全选 选项。由于列表筛选器备选值最多只能显示前100行备选值，点击选择 全选 时，因只勾选了前100行的值，所以只查询前100行的值去过滤数据。

6.2 选择null筛选数据

列表筛选器和下拉筛选器，如果字段的值中含null、空串时，筛选器备选值列表中将显示 (null) 、 ，并支持选中过滤对应数据。

6.2 列表过滤

筛选数据时，筛选器备选值列表中只希望固定展示某些项，此时可以通过备选值列表过滤功能实现。下面通过一个简单的示例演示如何使用备选值列表过滤功能。

1、区域 筛选器原始效果是展示发货区域字段所有值，现在希望能只展示 东北、华北和西北。

2、在筛选器设置弹窗中点击  ，选择 列表过滤 ，勾选 东北、华北和西北 ，点击 确定 ，操作步骤如下图所示：

3、再点击筛选器设置弹窗的 确定 ，此时 区域 筛选器的备选值会自动变成只有 东北、华北和西北三个值。

6.3 条件过滤

筛选数据时，筛选器备选值列表中希望按照复杂的条件过滤掉某些项，此时可以通过备选值条件过滤功能实现。下面通过一个简单的示例演示如何使用备选值条件过滤功能。

1、区域 筛选器原始效果是展示发货区域字段所有值，现在希望只展示销售额大于20000的区域。

2、在筛选器设置弹窗中点击  ，选择 条件过滤 ，选择 销售额 字段，并设置 大于 200000 ，点击 确定 ，操作步骤如下图所示：

3、再点击筛选器设置弹窗的 确定 ，此时 区域 筛选器的备选值会自动变成只有 华东和华北 两个值。

7 应用于组件逻辑说明

1、相关数据集所有组件：基于筛选器绑定的字段在 联动设置 中寻找联动关系，所有有关系的组件都会被影响。其中联动设置功能详情可参考 联动设置 。

2、此数据集所有组件：所有来源同一个业务数据集的组件会被影响。

3、自定义：自定义勾选需要影响的组件。

4、清除所选组件：点击 清除所选组件，可批量清除所有已经勾选的组件。

• 原本的应用范围是 相关数据集所有组件 或 此数据集所有组件，手动勾选或勾除应用的组件后，此时联动应用范围将自动切换成 自定义 。

8 筛选器变换类型

通过变换类型功能，可以变更筛选器组件类型，比如从多选下拉变换为多选列表，入口和效果如下图所示：

9 合并筛选器

当仪表盘上存在多个绑定同一个字段的筛选器时，支持将这些筛选器合并成一个筛选器。

1、合并入口：通过框选或Ctrl点选多个筛选器组件后，点击鼠标右键选择 合并筛选器 。

只选中一个筛选器组件、选中的多个组件中包含非筛选器组件，以及选中组合时，都不支持合并筛选器，且合并筛选器菜单项置灰。

2、合并逻辑

（1）只有来源同个业务数据集且绑定同个字段的筛选器组件才支持合并。

（2）合并后默认保留哪个筛选器：

• 如果是通过框选后合并的，哪个筛选器先创建，则保留哪个筛选器。
• 如果是通过Ctrl点选合并的，哪个筛选器首先被选中，则保留哪个筛选器。

（3）合并后保留下来的筛选器默认的应用范围为：合并前所有筛选器应用范围的并集。比如合并前 区域 筛选器影响 柱图 组件，发货区域 筛选器影响 表格 组件，合并后不管保留哪个筛选器，保留下来的筛选器都会默认影响柱图和表格两个组件。

10 更新缓存

刷新数据时，会默认将筛选器绑定的字段值加载到系统内存中，主要是为了避免字段值很多时，导致筛选器备选值加载慢的问题。

由于默认有缓存，所以当数据库中字段值发生了变化，如果筛选器组件的数据没有及时更新，可以点击筛选器的组件工具栏上 更新缓存 ，获取最新的数据。

11 样式设置

在组件设置的属性中，可对筛选器组件的名称和控件样式进行设置。本章节仅介绍通用的筛选器样式设置项，各类筛选器的特殊样式设置在对应筛选器类型的文档中单独说明，详情可参考 筛选器组件类型 。

名称中各配置项说明如下：

配置项	说明
名称	设置控件左侧标签的内容，默认内容为字段别名，如没有拖拽字段，则获取组件名称。
字体样式	设置名称内容的字体样式：字体类型、大小、加粗、斜体、下划线、颜色。
边距	设置名称左右边距的大小。 名称到组件左边框的距离=组件左边距+名称左边距，组件左边距功能详情可参考 组件属性 。 名称到筛选器控件框的距离=名称右边距
位置	设置名称的位置，默认为居左。

控件中各配置项及效果如下：