本文主要介绍筛选器组件的默认值、备选值和被联动后取值相关功能说明。
1 筛选器默认值
通过设置筛选器默认值来控制打开仪表盘时默认筛选哪些数据，设置入口和相关功能说明如下。
1.1 设置入口及效果
1、选中筛选器组件，在组件设置的数据中点击 筛选器设置 ，在筛选器设置的弹窗中进行默认值设置。
2、打开仪表盘时，根据设置的筛选器默认值筛选数据。如下图中，今年为2023年，打开仪表盘希望默认查看3年前华南和西南的订单数据。
| 锚 | ||||
|---|---|---|---|---|
|
不同筛选器控件类型，根据绑定字段的数据类型不同，能支持的默认值类型不同，支持范围如下：
默认值类型 | 字符串字段 | 数值型字段 | 日期型字段 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
列表 | 下拉框 | 树形 | 输入框 | 日期类 | 列表 | 下拉框 | 输入框 | 列表 | 下拉框 | 输入框 | 日期类 | |
全部 | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
保存值 | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
静态值 | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | |
相对值 | Y | Y | Y | Y | Y | |||||||
从备选值中选择 | Y | Y | Y | Y | ||||||||
备选值的第一个值 | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
函数 | Y | Y | Y | Y | ||||||||
用户属性 | Y | Y | Y | Y | Y | Y | Y | Y | Y | |||
(null) | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
(非null) | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
默认值类型功能详细说明如下：
1、全部：默认值为全部时，将不带任何过滤条件地查询所有值。
2、保存值：以当前仪表盘保存时的值作为筛选器下次打开仪表盘时显示的默认值。
3、静态值：静态值指手动输入筛选器的默认值。
- 日期类筛选器的静态值为选择日期、时间
- 非日期类筛选器的静态值为输入内容。
4、从备选值中选择：支持直接点击选择字段值作为筛选器默认值。
- 从备选值中选择 仅支持 字符串 类型的筛选字段。
- 如果筛选字段的总行数超过1000行时，列表选择默认只显示前1000行的字段值。
- 筛选器组件类型为 单选列表、单选下拉和输入框筛选器时，默认值列表选择为单选；筛选器组件类型为 多选列表和多选下拉，默认值列表选择为多选。
5、备选值的第一个值：每次刷新筛选器时，根据当前备选值列表，自动选择第一个值作为默认值。常用于筛选器联动的场景，场景示例详情可参考 多个筛选器组件联动 。
6、相对值：以当前系统日期为参考点，设置按时间频度前后时间值为默认值。相对值 只支持日期类的筛选器。
设置完相对日期后，可以在右上角查看相对日期的计算结果是否符合预期。各日期频度支持的相对日期设置及结果说明如下：
不同的日期频度筛选器的相对日期计算逻辑一样，只不过计算结果截取的时间细粒度不同而已。假设系统当前日期为 2023-07-11 星期二 ，以日期筛选器为例。
| 日期频度 | 时间点 | 计算结果 |
|---|---|---|
| 年 | 当天 | 往前第3年的当天，即为2020-07-11。
|
| 年初 | 往前第3年的年初，即为2020-01-01。
| |
| 年末 | 往后第3年的年末，即为2026-12-31。
| |
| 季 | 当天 | 往后第2个季度的当天，即为2024-01-11
|
| 季初 | 往后第2个季度的季初，即为2024-01-01
| |
| 季末 | 往前第1个季度的季末，即为2023-06-30
| |
| 月 | 当天 | 往前第1个月的当天，即为2023-06-11
|
| 月初 | 往前第1个月的月初，即为2023-06-01
| |
| 月末 | 往后第3个月的月末，即为2023-10-31
| |
| 周 | 当天 | 往后第3个周的星期二，即为2023-08-01
|
| 周初 | ||
| 周末 | 往前第1个周的周末（星期日），即为2023-07-09； 根据周初和每周7天计算周末为星期几，当前示例系统设置每周起始为星期一。
| |
| 天 | 往后的第8天即为2023-07-19
| |
场景示例详情可参考 默认获取相对日期 。
7、函数：利用函数设置筛选器默认值。
（1）只支持绑定字符串字段的列表筛选器、下拉筛选器和输入框筛选器。
（2）系统支持定义筛选器默认值的函数有如下表所示：
函数 | 说明 |
|---|---|
登录用户别名 | 当前登录用户的别名 |
登录用户组别名 | 当前登录用户所属组的别名 |
登录用户组编码 | 当前登录用户所属组的编码 |
登录用户组名称 | 当前登录用户所属组的名称 |
登录用户 | 当前登录用户名称 |
场景示例详情可参考 筛选器场景示例 ⬝ 函数 。
8、用户属性：将用户属性查询的结果作为筛选器默认值。一般适用于较复杂的筛选器默认值的场景，比如需要通过SQL才能获取查询结果。
用户属性不支持绑定数值型字段的筛选器。
场景示例详情可参考 筛选器场景示例 ⬝ 用户属性 。
9、(null)：默认值为(null)时，则表示默认选择(null)值过滤数据。
10、非(null)：默认值为(null)时，则表示默认选择除(null)外的其他值过滤数据。
| 注意 |
|---|
默认值为非(null)时，单选列表、多选列表和单选下拉筛选器会默认不勾选任何值，但筛选数据的结果是正确的。不勾选任何值是因为单选筛选器无法选择多个备选值，而多选列表只会列出前100行的数据。 |
| 锚 | ||||
|---|---|---|---|---|
|
对于列表筛选器和下拉筛选器，支持设置筛选器备选值有哪些项。
设置入口：选中筛选器组件，在组件设置的数据中点击 筛选器设置 ，在筛选器设置的弹窗中进行备选值设置。
2.1 全部
1、单选列表、单选下拉和多选下拉筛选器，支持设置是否在备选值列表中显示 全部 选项。选择 全部 时，将不带任何过滤条件地查询所有值。
2、多选列表筛选器支持设置是否在备选值列表中显示 全选 选项。由于列表筛选器备选值最多只能显示前100行备选值，点击选择 全选 时，因只勾选了前100行的值，所以只查询前100行的值去过滤数据。
2.2 选择null筛选数据
列表筛选器和下拉筛选器，如果字段的值中含null、空串时，筛选器备选值列表中将显示 (null) 、 ，并支持选中过滤对应数据。
| 数据库的数据 | 下拉筛选器 | 列表筛选器 |
|---|---|---|
|
|
|
2.3 列表过滤
筛选数据时，筛选器备选值列表中只希望固定展示某些项，此时可以通过备选值列表过滤功能实现。下面通过一个简单的示例演示如何使用备选值列表过滤功能。
| 注意 |
|---|
当 列表过滤 中，没有选择任何的具体值，就代表该过滤没有生效，前端返回所有的备选值 |
1、区域 筛选器原始效果是展示发货区域字段所有值，现在希望能只展示 东北、华北和西北。
2、在筛选器设置弹窗中点击 备选值过滤 ，选择 列表过滤 ，勾选 东北、华北和西北 ，点击 确定 ，操作步骤如下图所示：
3、再点击筛选器设置弹窗的 确定 ，此时 区域 筛选器的备选值会自动变成只有 东北、华北和西北三个值。
2.4 条件过滤
筛选数据时，筛选器备选值列表中希望按照复杂的条件过滤掉某些项，此时可以通过备选值条件过滤功能实现。下面通过一个简单的示例演示如何使用备选值条件过滤功能。
1、区域 筛选器原始效果是展示发货区域字段所有值，现在希望只展示销售额大于20000的区域。
2、在筛选器设置弹窗中点击 备选值过滤 ，选择 条件过滤 ，选择 销售额 字段，并设置 大于 200000 ，点击 确定 ，操作步骤如下图所示：
| 信息 |
|---|
可选择的字段包括：业务数据集中所有维度、层次字段、分组字段、计算列、原始度量和计算度量； 不支持选择数据模型中定义的命名集、参数，以及在仪表盘上定义分组字段、计算列、计算度量和自定义命名集。 |
3、再点击筛选器设置弹窗的 确定 ，此时 区域 筛选器的备选值会自动变成只有 华东和华北 两个值。
3 被联动后取值
筛选器被其他筛选器联动时，可自定义配置筛选器被联动后选择什么值进行过滤数据，如下图所示：
下面以 区域 联动 省份 作为示例，详细说明每种类型取值结果的区别：
1、默认值：被联动后，将原来的默认值作为新的选中值。
省份设置默认值为山东省，被联动后取值设置为 默认值，此时无论切换哪个区域，省份被联动后总是将默认值 山东省 作为新的选中值。
2、当前选中值：被联动后，保持当前选中值不变，将其作为新的选中值。
省份设置被联动后取值设置为 当前选中值，勾选省份的值，如北京市和四川省，此时无论切换哪个区域，省份被联动后总是保持当前选中值不变，如总是选中北京市和四川省。
3、默认值与备选值交集：被联动后，将原来的默认值与备选值交集作为新的选中值。不在备选值中的默认值则排除掉。
省份设置默认值为云南省和山东省，被联动后取值设置为 默认值与备选值交集，此时切换选中的区域时，会拿区域选中值取过滤省份的备选值，且只会将默认值与备选值交集作为新的选中值，如区域勾选西南后，山东省不属于西南，则山东省将被排除，只保留四川省作为新的选中值。
- 若被联动后，若默认值与备选值的交集为空，则联动后将不选中任何一项。
4、选中值与备选值交集：被联动后，将当前选中值与备选值交集作为新的选中值。不在备选值中的选中值则排除掉。
省份设置被联动后取值设置为 选中值与备选值交集，勾选省份的值，如北京市和四川省，此时切换选中的区域时，会拿区域选中值取过滤省份的备选值，且只会将当前选中值与备选值交集作为新的选中值，如区域勾选西南后，北京市不属于西南，则北京市将被排除，只保留四川省作为新的选中值。
- 相对于 当前选中值，选中值与备选值交集 更能保证联动后能取一个确定有效的选中值。
- 若被联动后，若当前选中值与备选值的交集为空，则联动后将不选中任何一项。
5、系统自动选择选中值或默认值：被联动后，当前选中值在备选值中时，则取选中值与备选值交集；当前选中值不在备选值中时，则取默认值。
- 此项相当于将 选中值与备选值交集 和 默认值 结合起来使用，且优先取选中值与备选值交集。
