更新时间：2023-04-01 15:52
通过查询控件可以对仪表盘中的图表进行查询，展示出用户需要的图表数据。查询控件支持根据文本、日期、数值字段查询。
1. 仪表盘编辑页单击「筛选」，即可新增查询控件。
方式一：
在查询控件中，单击「添加」
在弹窗中，单击「查询条件」左上角+图标，新增查询条件，并对其命名
方式二：
鼠标上浮至已有查询控件中，单击+图标，新增查询条件，并对其命名
1. 选择要编辑的查询条件
2. 选择查询条件所关联的图表
3. 选择需要在关联图表中筛选的字段。
4. 不支持不同类型的字段同时关联，如下图中同时关联文本类型和日期类型的字段，会有以下提示。
5. 配置筛选条件。字段类型，所能配置的筛选条件不同，具体配置见下表：
字段类型 |
筛选器类型 |
配置项说明 |
文本 |
文本输入框 |
● 条件形式：支持单条件、或条件、且条件查询 ● 必填项：支持设置查询条件为必填项 ● 默认值：支持设置筛选默认值 配置单条件查询后，见下图示例： |
下拉列表 |
● 查询方式：支持单选和多选 ● 选项值来源：支持选择单个数据集或手工输入。 ○ 若选择单个数据集输入，则需选择选项值的来源数据集、查询值字段、显示名称字段，也可配置排序字段。 ○ ○ 若选择手工输入，则需要输入查询值与显示名称。 ○ ● 必填项：支持设置查询条件为必填项 ● 选择全部：支持设置选择全部 ● url参数：支持接收url参数为过滤条件 ● 默认值：支持设置筛选默认值。可设置默认筛选全部。 下图为示例： |
|
树形下拉 |
● 选择方式：支持单选或多选 ● 数据集：即选项的来源数据集 ● 层级配置：配置树形不同层级的查询字段和显示字段。最多可配置4个层级。 ● 必填项：支持设置查询条件为必填项 ● 默认值：支持设置筛选默认值 下图为示例： |
|
日期查询 |
日期查询 |
● 筛选时间范围：可设置开始时间和结束时间 ● 筛选方式：不同日期颗粒度的筛选方式不同 ○ 年：单年，或年区间 ○ 季：单季，或季区间 ○ 月：单月，或月区间 ○ 周：单周，或周区间 ○ 日：单日，或日区间 ○ 当选择日期区间时，可选区间类型为【开始于、结束于、时间区间、快捷区间】 ● 必填项：支持设置查询条件为必填项 ● url参数：支持接收url参数为过滤条件 ● 默认值：支持设置筛选默认值。可设置默认筛选全部。 下图为示例： |
数值查询 |
数值输入框 |
● 聚合方式：可选择【求和、计数、去重计数、最小值、最大值、平均值、无聚合】 ● 必填项：支持设置查询条件为必填项 ● 默认值：支持设置筛选默认值。可设置默认筛选全部。 下图为示例： |
维度替换，即当筛选条件被触发时，目标图表中的维度将被替换。例如，在部分以日期轴建模的图表中，期望当以【日】粒度查询时，轴粒度是日粒度；当以【周】粒度查询时，周粒度是轴粒度；当以【月】粒度查询时，轴粒度是月粒度；
步骤1：点击【维度替换配置】，弹出设置框
步骤2：指定图表，点击【替换】，进行设置
举例：
日筛选器，进行【日期（day）】替换为【日期（day）】;
周筛选器，进行【日期（day）】替换为【日期（week）】;
月筛选器，进行【日期（day）】替换为【日期（month）】
您可设置当筛选被触发时，筛选生效的图表触发额外的过滤条件。例如，当筛选折线图中【日期=2022年】的数据时，额外触发【城市=上海】的过滤条件。
您可将某些查询条件归类于同一分组内，从而实现查询条件的快速切换。步骤如下：
点击「分组标签」，您可修改默认标签名称，也可以删除标签。
将已有查询条件拖拽至标签组内。或在已有查询条件旁点击按钮，选择「添加到标签分组」
标签分组后，即可在仪表盘中查看标签组内的查询条件。
单击查询控件，在页面左侧可配置控件。
筛选配置-基础设置中，支持配置标题、备注、背景、清空按钮和查询按钮。
筛选配置-空间样式中，支持配置筛选字段是否可见、样式、宽度；支持配置标签位置、控件排列、对齐方式。
筛选器级联功能指的是筛选器之间的联动，例如：控件A中选择了省份，控件B中的省份列表仅有控件A已选定的省份下的城市，则需要配置控件A和控件B的联动。
（1）当筛选器类型为【下拉列表】且选项值来源为【单个数据集】，才能配置级联关系，如下图：
（2）筛选器规则选择，如下
● 当多个筛选器，只要有一个筛选器的数据集与其他数据集不同时，必须选择非同数据集级联
● 当多个筛选器的查询条件中，选项值来源均为同一个数据集，可以选择同数据集级联或非同数据集级联
（3）单个级联规则最多可配置5个级联层级，当超过5个时，可配置多条级联规则
（4）级联规则中，上级可级联下级（包括默认值），不可反向级联
（5）级联规则配置完成后，筛选器被删除、修改等导致级联规则无法生效，则该级联规则将被系统删除
入口1：仪表盘编辑页面右上角
入口2：筛选器弹窗左下角
1）同数据集级联
（步骤1.1）配置「区域、省份、城市」3个筛选器，3个筛选器选项值来源必须为相同数据集，然后关闭弹窗
（步骤1.2）打开筛选器级联配置弹窗。
入口1：仪表盘编辑页面右上角
入口2：筛选器弹窗左下角
（步骤1.3）在弹窗中，选择「添加级联规则——同数据集级联」
（步骤1.4）选择层级规则中每一级的筛选器，点击「确定」。
例如下图，3级分别为“区域——省份——城市”，则表示“区域”筛选器中选了“华东”，则“省份”筛选器中只能选择“华东”下的省份；且“省份”筛选器中选了“浙江”，“城市“筛选器中只能选择“华东”区域与“浙江”省份下的城市。
（步骤1.5）查看筛选器的级联关系。如下图所示，区域选了华东，省份只能选华东下的省份；省份选了浙江，城市只能选择华东区域、浙江省份下的城市。
2）非同数据集级联
（步骤2.1）配置「国家、区域」2个筛选器，2个筛选器选项值来源为不同数据集，然后关闭弹窗
（步骤2.2）打开筛选器级联配置弹窗。
入口1：仪表盘编辑页面右上角
入口2：筛选器弹窗左下角
（步骤2.3）在弹窗中，选择「添加级联规则——非同数据集级联」
（步骤2.4）选择层级规则中每一级的筛选器。第一级选择「国家」筛选器。
第二级选择「区域」筛选器，关联字段选择【国家】。此处指的是令【区域】筛选器关联数据集的【国家】字段等于【国家】筛选器关联数据集的【国家】字段。
注：第一级不需要选择关联字段，第2-5级需要选择关联字段
（步骤2.5）查看筛选器的级联关系。如下图所示，国家选了中国，省份只能选中国下的省份。
