二、前提条件
在开始本操作前，请确保满足以下条件：
·已创建仪表盘并至少添加一份数据集，详见 配置数据源与查询。
·当前账号在该仪表盘上拥有 可编辑 或更高权限。
三、使用限制
| 限制项 | 说明 |
| 单个仪表盘全局筛选器数量 | 最多 50 个 |
| 单个数据集在筛选器中的字段绑定 | 1 个筛选器中，每个数据集最多绑定 1 个字段 |
| 支持参数的筛选器类型 | 单值、日期选择、日期范围（其他类型暂不支持参数） |
| 联动筛选作用范围 | 仅同一 Tab 内、同一数据集的图表之间联动；跨页面不联动 |
| 联动筛选支持点选的图表类型 | 柱状图、饼图（点击柱/扇区触发） |
五、步骤 1：理解三层筛选关系
| 层级 | 适用范围 | 配置位置 |
| 全局筛选器 | 整个仪表盘的所有页面与图表 | 画布顶部全局筛选器区域 |
| 页面筛选器 | 当前 Tab 内的所有图表 | 画布内的「页面筛选器」组件 |
| 图表过滤字段/参数 | 单个图表 | 选中图表，右侧「过滤条件」区域 |
三层筛选逐层叠加生效 （AND 语义）：当一个数据集的字段同时被全局筛选器和页面筛选器绑定时，两者取交集；图表最终查询数据时同时受全局、页面、图表三层条件影响。
六、步骤 2：配置全局筛选器
全局筛选器位于画布左上角，点击全局筛选器图标可显示、隐藏。
1. 点击画布顶部的 全局筛选器 将出现抽屉，点击抽屉中的 + 按需新增；单仪表盘最多支持 50 个。
2. 选中全局筛选组件后，右侧面板进行配置：
·字段 ：点击 + 选择当前仪表盘已添加数据集的字段，支持模糊搜索；同一筛选器中每个数据集最多 1 个字段，已绑定字段的数据集会置灰。
·参数 ：当数据集中存在参数时，可绑定参数。
·排序 ：同类型按字母排序、自定义。
3. 已添加的多个全局筛选器支持拖拽调整顺序 。
4. 已筛选的非「全部」值会固定显示 在画布左上角，格式为「全局筛选器标题：字段值」；如为「全部」则不显示。
5. 当存在非「全部」的筛选时，画布右上角固定显示 重置 按钮。
七、步骤 3：配置页面筛选器
页面筛选器只对当前所在 Tab 生效。
1. 在画布下方工具栏点击 页面筛选器 ，在画布上拖拽出筛选器组件区域。
2. 在右侧面板配置：
·标题、描述 。
·筛选类型 ：单值、多值、日期选择器、日期范围选择器、文本输入、范围滑块。
·字段、参数 ：选择数据集字段或参数。
·设置 ：根据类型不同提供「包含、排除」、「默认值」等选项。
八、各类型筛选器要点
| 筛选类型 | 行为说明 |
| 单值 | 下拉选择单个值；支持参数绑定 |
| 多值 | 支持「包含/排除」模式；设置为「排除」时输入框上方需标识当前为排除态 |
| 日期选择器 | 选择具体某一日；支持参数；点日历图标可使用快捷时间：「全部 / 今天 / 7 天前 / 30 天前 / 今年 / 去年」，其中「今年/去年」指当年/去年 1 月 1 日 |
| 日期范围选择器 | 选择起止日期；支持参数；快捷时间中「今年/去年」指完整年度区间 |
| 文本输入 | 输入字符串过滤；不支持参数 |
| 范围滑块 | 在数值范围内拖拽两端选择区间；不支持参数 |
九、默认值的展示规则
·当下拉中存在用户未额外勾选的项目时，统一收纳到「已筛选掉」分组。
·默认值显示项包括：全部、无、用户已设置的默认值 。
十、步骤 4：配置图表级过滤字段、参数
每个图表可在右侧 过滤条件 区独立配置：
1. 选中图表，右侧面板找到 过滤条件 区。
2. 点击 + 添加：
·过滤字段 ：可添加当前数据集下多个字段。
·过滤参数 ：当数据集存在参数时，可叠加参数过滤。
3. 参数若在数据集层设置了默认值会带入；当配置了多个参数时，仅取第一个的默认值 。
十一、步骤 5：使用图表间联动筛选
当多个图表使用 同一数据集 时，相互之间会自动联动筛选：
·点击柱状图的某一柱、饼图的某一扇区，系统识别对应的维度字段和值，自动生成筛选条件并应用到同 Tab 内所有使用该数据集的图表 （不限图表类型）。
·再次点击同一柱、扇区，取消该联动筛选。
·联动筛选生效时，画布上方会显示当前的联动筛选条件，已存在的全局、页面筛选器仍然叠加生效 （AND 语义）。
注意：说明：
注意：跨页面（跨 Tab）不联动；跨数据集不联动。如果两个图表使用了不同的数据集（即使表名相同），不会触发联动。
十三、全局筛选器配置
| 参数 | 说明 | 配置项 |
| 小组件 | 对组件的标题和描述做相关配置 | 标题描述 |
| 筛选 | 选择筛选的类型 | 支持选择单一值、多个值、日期选择器、日期范围选择器、文本输入、范围滑块 |
| 字段 | 绑定具体数据集字段或者参数 | 选择数据集字段或参数 |
| 设置 | 根据选择的筛选类型不一致，可以做条件设置 | 根据类型不同提供不同的选项。 |
十四、页面筛选器配置
| 参数 | 说明 | 是否必填 | 默认值 |
| 标题 | 筛选器显示标题 | 否 | – |
| 描述 | 标题旁说明 | 否 | – |
| 筛选类型 | 单值 / 多值 / 日期选择器 / 日期范围 / 文本输入 / 范围滑块 | 是 | 单值 |
| 字段 / 参数 | 绑定的数据集字段或参数 | 是 | – |
| 默认值 | 包含 / 排除模式 | 否 | 包含 |
十五、图表过滤条件
| 参数 | 说明 | 是否必填 | 默认值 |
| 过滤字段 | 当前图表数据集中可用于过滤的字段 | 否 | – |
| 过滤参数 | 当前图表数据集中已定义的参数 | 否 | – |
十六、验证结果
完成筛选器配置后：
1. 切换全局筛选器值，所有页面的相关图表立即按新条件刷新。
2. 切换页面筛选器值，只有当前 Tab 内的图表刷新。
3. 在柱状图、饼图中点击某一柱、扇区，画布上方出现联动筛选标签，其他同数据集图表跟随筛选；再次点击取消。
十八、Q：为什么全局筛选器中某些数据集字段下拉是灰色的？
A：当同一筛选器已经绑定了该数据集的某个字段时，该数据集会被置灰（每个数据集在单个筛选器中最多只能绑定 1 个字段）。悬停时会提示「单个数据集下仅支持一个字段或参数」。
十九、Q：参数类型为「多值」时为什么有些筛选器选不了？
A：仅 单值、日期选择、日期范围选择 三种筛选器支持绑定参数；其他类型添加按钮会禁用，悬停提示「仅单值、日期支持参数设置」。
20、Q：图表配置了多个参数时默认值怎么取？
A：图表过滤条件中配置多个参数时，仅取第一个 参数的默认值；如需所有参数都带默认值，请改用筛选器或在数据集中显式管理。
21、Q：为什么我点了图表却没有联动其他图表？
A：检查以下几点：① 是否在同一 Tab 内；② 是否使用相同的数据集；③ 触发图表是否为支持点选的类型（柱状图、饼图）。
22、Q：日期筛选器的「今年」和「去年」具体覆盖什么范围？
A：- 日期选择器 ：今年 = 当年 1 月 1 日；去年 = 去年 1 月 1 日（单个日期）。
·日期范围选择器 ：今年 = 当年全年范围；去年 = 去年全年范围。
23、相关文档
·创建仪表盘与布局
·添加图表组件
·配置数据源与查询