通过查询控件可以对仪表板中的图表进行查询操作，从而展示用户需要的图表数据。

查询控件支持对日期类型、文本类型、数值类型字段的查询，可以通过以下步骤使用查询控件。

1. 在仪表板中新建查询控件。

1）在仪表板编辑区域，在顶部菜单栏单击查询控件图标，并新建筛选项。

2) 在查询条件设置页面，完成以下三部分内容的设置。

1. 在查询条件区域单击图标签新增查询条件时，默认名称为未命名，此处可以自定义输入查询条件名称。

说明：

• 输入查询条件名称后离开该区域命名即生效。

• 查询条件可通过 图标隐藏，隐藏后配置内容保留，在仪表板中不再显示。

• 单击图标，重命名或删除查询条件。

b. 选中要关联的图表并选择关联的字段，可开启字段智能选入功能，同数据集下所选图表的关联字段将被自动填入。如果图表过多，可通过筛选功能选择需要的图表。

注意：不支持不同类型的字段同时关联，如下图中同时关联日期类型和数值类型字段，会有以下提示。

c. 查询条件配置因选择关联字段的类型不同而不同，以下为时间类型字段年粒度的查询条件配置。

当开启日期前后快捷切换功能时，则报表页面对应的日期控件处会新增一个快捷箭头，单击可以快速切换月份，效果图如下。

配置样式

查询条件设置完成后，在样式中对查询控件展示样式进行设置。

1. 在基础设置中，设置显示标题、是否全局置顶、是否隐藏查询按钮、显示清空按钮、显示重置按钮和控件类型。

说明： 仅当选中显示清空按钮或显示重置按钮时，才会出现重置或清空按钮。

• 重置：表示查询条件恢复到设置的默认值。

• 清空：表示清除查询条件中显示的值。

假设控件A级联控件B，则表示控件A是控件B的上层关系。若重置或清空的控件A，则控件B也会被重置或清空；反之，若重置或清空的控件B，则控件A不会被影响。

2. 在控件样式中，设置控件高度、内容排版和显示字段标签，以下为各设置样式举例。

3. 在字段样式中，设置字段的取值样式和筛选器宽度。

日期字段和数值字段只能设置筛选器宽度，文本字段还支持设置取值样式，包含下拉和平铺两种样式。

查询类型配置展示

下面主要介绍下列展示类型所进行的配置。

• 日期选择

一旦关联了日期类型的字段，查询控件会自动推荐日期选择作为展示类型，同时根据所关联的不同粒度的日期字段来推荐时间粒度。

目前支持多种时间粒度，例如：年、年-季度、年-月、年-周、年-月-日、年-月-日-时-分-秒、时、时-分和时-分-秒。

本例中，选择的时间粒度为年。当筛选方式为年区间时，区间类型包含开始于、结束于、时间区间和快捷区间。

在区间范围的筛选方式中，开始于、结束于两种区间类型选项，不需要填写完整的起止时间也能发起查询。

可以根据实际需求给不同的时间粒度定制快捷区间，对应关系如下。

• 数值输入框

当关联字段为度量时，可以在查询控件中选择聚合方式，默认为求和，也可以选择无聚合或其他聚合方式。

说明： 聚合查询控件无法查询明细数据。在条件形式中，您可以选择不同的展现形式，可以选择单个条件和且或条件。如果想让报表的预览者只能使用固定的条件形式如只可以使用等于的条件，则需要选中锁定筛选条件。

• 文本输入框

与数值输入框类似，文本框可以选择条件形式为单条件、或条件、且条件。

为product_sub_type字段设定默认值时，规则及对应SQL语法关系如下：

• 下拉列表（原枚举筛选）

当展示类型为下拉列表（原枚举筛选）时，选项值来源为查询条件字段可供选择的筛选值，支持自动解析、单个数据集、手工输入三种方式。

1. 当选项值来源为自动解析时，自动解析左侧关联图表区域选中的字段值的合集，界面仅展示1000条；

2. 当选择查询方式为多选、查询时间为点击查询时，选中设定筛选默认值并配置默认值，例如下图操作

1）在搜索框输入关键字，并单击下方关键字，将左侧目标字段值添加到右侧的已添加列表中。

2）单击添加左侧全部字段值，将左侧全部字段值添加到右侧的已添加列表中。

3）勾选左侧字段值，将选中的字段值添加到右侧的已添加列表中。

4）单击排除，添加到右侧的已添加列表中的字段值被排除。

说明：

• 如果配置默认值时选择排除该字段值，又将下拉列表的样式切换为平铺，则在查询控件中选择该字段值，表示排除该字段。

• 如果先配置的平铺样式，又在配置默认值时选择排除该字段值，则将普通平铺样式替换成平铺排除的样式。

5）单击清空，添加到右侧的已添加列表中的字段值被清空。

3. 当选项值来源为单个数据集时，选择当前仪表板所在空间内的所有数据集，推荐的数据集为关联图表来源的数据集。图表中关联字段和单个数据集中查询值字段以及显示名称字段的关系如下。

• 关联图表及字段为查询条件中待关联的图表和字段。

• 查询值字段为选项值来源数据集中要与关联字段匹配的字段。

• 显示名称字段为选项值来源数据集中要进行筛选的字段，即查询控件中显示的字段。

• 排序字段：支持按照选定字段进行排序。可选项，不填写则默认按照数据集中顺序排序。

• 查询时间：支持点击查询和预先查询。

• 点击查询：默认值。当触发查询按钮时，启动条件查询。

• 预先查询：打开仪表板后预先查询下拉列表的内容值，能够按照行级权限的配置展示各个账号对应的下拉列表值，且每个人的默认值也会根据对应行级权限的配置而有所不同。

说明：

当显示名称字段与查询值字段一致时，选择查询值字段后，系统将自动填入显示名称字段。

当显示名称字段与查询值字段不一致时，需要手动修改显示名称字段。

预先查询适用于目标数据集已配置行级权限且数据量较小的场景，否则会影响整体报表加载时间。

4. 当选项来源为手工输入时，需要通过单击 图标，在手工录入页面，手工输入查询值字段和显示名称字段。

• 当第一次进行手工录入且查询值与显示名称一致时，需要输入查询值并单击确定后，系统会自动输入显示名称。

• 当第一次进行手工录入且查询值与显示名称不一致时，需要手工输入查询值和显示名称。

• 当非第一次进行手工录入时，新增查询值和显示名称均需手工输入。只输入查询值会收到以下提示。

树形下拉

当展示类型为树形下拉时，选择数据集支持同数据集和非同数据集，展示形式支持树形展示和平铺展示，查询方式支持单选和多选，查询时间支持点击查询和预先查询。

 1. 树形单选展示

2. 树形多选展示

其中，快捷关联功能默认开启，通过该功能可以为树形结构的子层级自动选入同数据集下的关联图表及字段。

单击树形结构中的关联图表，或单击左侧查询项中子层级的名称，为树形结构的子层级关联其他数据集下的图表和字段。

例如，下图中设置第二层级province进行关联图表及字段时，同数据集的图表线图和饼图的关联字段可以自动选入，非同数据集的图表指标看板的关联字段需要手动录入。

Tab内创建查询控件

通过查询控件可以查询单个或多个图表中的数据，一个Tab中可以添加多个查询控件。

效果展示图

图表数据配置

在仪表板编辑页面，可以通过以下两种方式添加Tab控件。

1. 鼠标悬浮至“订单趋势”标签页，单击标签页右侧 图标选择查询条件。

在Tab内查询条件设置页面，完成以下三部分内容的设置。

1）查询条件

查询条件区域单击图标，新增查询条件时，默认名称为未命名，可以输入查询条件名称。

说明：

• 输入查询条件名称后离开该区域命名即生效。

• 查询条件可通过 图标隐藏，隐藏后配置内容保留，在仪表板中不再显示。

• 单击图标，重命名或删除查询条件。

2）关联图表及字段

选中要关联的图表并选择关联的字段，可开启字段智能选入功能，同数据集下所选图表的关联字段将被自动填入。如果图表过多，可通过筛选功能选择需要的图表。

3）查询条件配置

查询条件配置因选择关联字段的类型不同而不同，以下为时间类型字段年粒度的查询条件配置，更多类型配置详情请参见查询类型配置展示。

4）条件级联配置

配置级联后，上层关系能级联下层关系，同一层级的条件之间可以建立级联。当配置了全局查询控件、Tab内查询控件和图表内查询控件时，则级联关系为全域查询控件>Tab内查询控件>图表内查询控件。

2. 在样式页签的标签区域，单击“订单趋势”右侧的图表。

配置样式

查询条件设置完成后，在样式中对查询控件展示样式进行设置。

• 在模板配置中，可以根据需要选择模版，快捷地完成查询条件样式的设置。

模板样式支持标题右侧查询、标题下方下拉和标题下方平铺三种。

• 在基础设置中，配置以下参数。

如果模板配置选择标题下方下拉或标题下方平铺方式时，可设置展示位置、是否展开全部筛选条件、控件类型。

如果模板配置选择标题右侧查询方式时，可设置展示位置。

• 在控件样式中，设置条件名称展示位置：

如果模板配置选择标题下方下拉或标题下方平铺方式时，条件名称支持上方和左侧两种显示。

如果模板配置选择标题右侧查询方式时，条件名称的位置支持左侧显示。

当Tab样式居右时，控件样式不支持居右显示。

• 在字段样式中，设置字段的取值样式和筛选器宽度。

日期字段和数值字段只能设置筛选器宽度，文本字段还支持设置取值样式，包含下拉和平铺两种样式。

▍返回「 智能报表 」目录页