...
| 字段类型 | 操作符 | 单选列表 | 多选列表 | 单选下拉 | 多选下拉 | 单选输入框 | 多选输入框 | 日期类 |
|---|---|---|---|---|---|---|---|---|
| 文本型 | 默认值 | 等于 | 包含 | 等于 | 包含 | 等于 | 包含 | 等于 |
可更改为其他操作符 | 不等于 模糊匹配 不匹配 开头为 结尾为 开头不为 结尾不为 | 不包含 模糊匹配 不匹配 开头为 结尾为 开头不为 结尾不为 | 不等于 模糊匹配 不匹配 开头为 结尾为 开头不为 结尾不为 | 不包含 模糊匹配 不匹配 开头为 结尾为 开头不为 结尾不为 | 不等于 模糊匹配 不匹配 开头为 结尾为 开头不为 结尾不为 | 不包含 模糊匹配 不匹配 开头为 结尾为 开头不为 结尾不为 | 不等于 大于 大于等于 小于 小于等于 | |
| 数值型 | 默认值 | 等于 | 包含 | 等于 | 包含 | 等于 | 包含 | 等于 |
可更改为其他操作符 | 不等于 大于 大于等于 小于 小于等于 | 不包含 | 不等于 大于 大于等于 小于 小于等于 | 不包含 | 不等于 大于 大于等于 小于 小于等于 | 不包含 | 不等于 大于 大于等于 小于 小于等于 | |
日期型/ 日期时间型 | 默认值 | 等于 | 包含 | 等于 | 包含 | 等于 | 包含 | 等于 |
可更改为其他操作符 | 不等于 模糊匹配 不匹配 大于 大于等于 小于 小于等于 | 不包含 | 不等于 模糊匹配 不匹配 大于 大于等于 小于 小于等于 | 不包含 | 不等于 模糊匹配 不匹配 大于 大于等于 小于 小于等于 | 不包含 | 不等于 大于 大于等于 小于 小于等于 |
5
...
通过设置筛选器默认值来控制打开仪表盘时默认筛选哪些数据，设置入口和相关功能说明如下。
5.1 设置入口及效果
1、选中筛选器组件，在组件设置的数据中点击 筛选器设置 ，在筛选器设置的弹窗中进行默认值设置。
2、打开仪表盘时，根据设置的筛选器默认值筛选数据。如下图中，今年为2023年，打开仪表盘希望默认查看3年前华南和西南的订单数据。
5.2 默认值类型
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行的数据。 |
...
对于列表筛选器和下拉筛选器，支持设置筛选器备选值有哪些项。
设置入口：选中筛选器组件，在组件设置的数据中点击 筛选器设置 ，在筛选器设置的弹窗中进行备选值设置。
6.1 全部
1、单选列表、单选下拉和多选下拉筛选器，支持设置是否在备选值列表中显示 全部 选项。选择 全部 时，将不带任何过滤条件地查询所有值。
2、多选列表筛选器支持设置是否在备选值列表中显示 全选 选项。由于列表筛选器备选值最多只能显示前100行备选值，点击选择 全选 时，因只勾选了前100行的值，所以只查询前100行的值去过滤数据。
6.2 选择null筛选数据
列表筛选器和下拉筛选器，如果字段的值中含null、空串时，筛选器备选值列表中将显示 (null) 、 ，并支持选中过滤对应数据。
...
...
...
6.2 列表过滤
筛选数据时，筛选器备选值列表中只希望固定展示某些项，此时可以通过备选值列表过滤功能实现。下面通过一个简单的示例演示如何使用备选值列表过滤功能。
1、区域 筛选器原始效果是展示发货区域字段所有值，现在希望能只展示 东北、华北和西北。
2、在筛选器设置弹窗中点击 
，选择 列表过滤 ，勾选 东北、华北和西北 ，点击 确定 ，操作步骤如下图所示：
3、再点击筛选器设置弹窗的 确定 ，此时 区域 筛选器的备选值会自动变成只有 东北、华北和西北三个值。
6.3 条件过滤
筛选数据时，筛选器备选值列表中希望按照复杂的条件过滤掉某些项，此时可以通过备选值条件过滤功能实现。下面通过一个简单的示例演示如何使用备选值条件过滤功能。
1、区域 筛选器原始效果是展示发货区域字段所有值，现在希望只展示销售额大于20000的区域。
2、在筛选器设置弹窗中点击 ，选择 条件过滤 ，选择 销售额 字段，并设置 大于 200000 ，点击 确定 ，操作步骤如下图所示：
| 信息 |
|---|
可选择的字段包括：业务数据集中所有维度、层次字段、分组字段、计算列、原始度量和计算度量； 不支持选择数据模型中定义的命名集、参数，以及在仪表盘上定义分组字段、计算列、计算度量和自定义命名集。 |
3、再点击筛选器设置弹窗的 确定 ，此时 区域 筛选器的备选值会自动变成只有 华东和华北 两个值。
...
默认值&备选值&被联动后取值
筛选器组件的默认值、备选值和被联动后取值功能详细说明可参考 默认值&备选值&被联动后取值。
6 应用于组件逻辑说明
1、相关数据集所有组件：基于筛选器绑定的字段在 联动设置 中寻找联动关系，所有有关系的组件都会被影响。其中联动设置功能详情可参考 联动设置 。
...
- 原本的应用范围是 相关数据集所有组件 或 此数据集所有组件，手动勾选或勾除应用的组件后，此时联动应用范围将自动切换成 自定义 。
...
7 筛选器变换类型
通过变换类型功能，可以变更筛选器组件类型，比如从多选下拉变换为多选列表，入口和效果如下图所示：
| 信息 |
|---|
变换类型时，筛选器类型和图表类型不能相互切换，筛选器组件只能选择切换成筛选器的组件类型。 |
| 锚 | ||||
|---|---|---|---|---|
|
...
8 合并筛选器
当仪表盘上存在多个绑定同一个字段的筛选器时，支持将这些筛选器合并成一个筛选器。
...
（3）合并后保留下来的筛选器默认的应用范围为：合并前所有筛选器应用范围的并集。比如合并前 区域 筛选器影响 柱图 组件，发货区域 筛选器影响 表格 组件，合并后不管保留哪个筛选器，保留下来的筛选器都会默认影响柱图和表格两个组件。
...
9 更新缓存
刷新数据时，会默认将筛选器绑定的字段值加载到系统内存中，主要是为了避免字段值很多时，导致筛选器备选值加载慢的问题。
由于默认有缓存，所以当数据库中字段值发生了变化，如果筛选器组件的数据没有及时更新，可以点击筛选器的组件工具栏上 更新缓存 ，获取最新的数据。
| 锚 | ||||
|---|---|---|---|---|
|
...
10 样式设置
在组件设置的属性中，可对筛选器组件的名称和控件样式进行设置。本章节仅介绍通用的筛选器样式设置项，各类筛选器的特殊样式设置在对应筛选器类型的文档中单独说明，详情可参考 筛选器组件类型 。
...
