更新时间:2024-12-16 GMT+08:00
分享

查询控件

通过查询控件可以对仪表板中的图表进行查询操作,从而展示用户需要的图表数据,查询控件支持对日期类型、文本类型、数值类型的字段进行查询。本文为您介绍如何新建查询控件。

前提条件

操作步骤

  1. 在仪表板页面导航栏单击,新建查询控件。
  2. 在页面右侧的数据页签选择需要分析的数据集。
  3. 单击查询控件,进入查询控件设置页面。
  4. 设置相关参数,参数说明请参见表1表2
  5. 单击 “确定”,系统自动更新图表。
  6. 单击页面右上角的“保存”或“保存并发布”保存仪表板。

    图1 查询控件设置
表1 查询控件设置参数

参数

说明

查询条件

命名条件的名称,在控件的左上侧展示名称。

条件配置

对条件的设置,具体请参考表2

关联图表

查询条件关联仪表板上的图表内容。

级联控件

级联控件支持展示类型选择下拉列表、日期选择、时间条件框、时间区间选择对数据的过滤。

查询控件的级联功能使用,例如设置的查询条件A中选择了省份,查询条件B中的市列表就只有查询条件A已选定的省份下的市,即需要配置查询条件A和查询条件B的关联关系。

说明:
  • 时间类型组件只支持级联下拉列表控件。
  • 时间条件框、时间区间选择、日期选择级联控件的关联字段时,只能选择对应的时间类型字段。
  • 与下拉组件的级联一样,一个时间类型组件可以支持级联多个下拉组件。
表2 条件配置参数

参数

说明

设为必填选

勾选后,查询时会携带查询条件,不勾选,不会携带查询条件。

说明:

查询条件A设置为必选项,条件A前面显示*,查询条件B为非必选项,条件B前面未显示*。

当对表格进行查询时,条件A未设置条件,直接对条件B进行设置,单击控件右下角的“查询”时,条件A会显示红色,无法进行数据过滤。只有先设置条件A后,在设置条件B,单击查询控件右下角的“查询”时,不会报错,关联的相应图表展示查询结果。

展示类型

筛选条件支持以下几种展示类型:下拉列表、文本条件框、数字条件框、数字区间选择、日期选择、时间条件框、时间区间选择、条件单选框、列选择器。

说明:

时间区间选择增加了占位符,可以选择区间类型的参数。

选项值来源

支持两种方式:自动解析和手动输入。该参数仅在展示类型为下拉列表时支持。

  • 自动解析:选择数据集后支持查询字段和显示字段设置。
    说明:

    关联数据表所过滤的字段中有查询字段的值,在查询控件中查询后,关联的数据表才可显示数据,否则数据表为空。

  • 手动输入:查询值和显示名称支持手工录入。

数据集

展示类型为下拉列表时,需要和数据集的字段关联起来。

查询方式

查询方式支持两种方式:单选和多选,该参数仅在展示类型为下拉列表时支持。

查询时间

单击查询,该参数仅在展示类型为下拉列表时支持。

说明:

当数据集字段设置完成之后,便支持设置:设定筛选默认值、筛选、排序、增强检索等功能。

默认提示文本

条件配置框的默认提示文字。

设定筛选默认值

下拉列表:初始化值选择“固定”并手动选择查询字段的具体数值后,查询控件初始值会默认显示该值;初始化选择“默认第一个值”,查询控件初始值显示为下拉列表的第一个值,其他关联图表也匹配该值。

文本条件框:设定默认筛选值,有以下条件可以设置:精确匹配、包含、不包含、不匹配、开头是、为空、不为空。

数字条件框:设定默认筛选值,有以下条件可以设置:>、≥、<、≤、=、≠。

数字区间选择:设定默认筛选值,手动输入数字区间。

日期选择、时间条件框:设定默认筛选值,支持设置相对时间、绝对时间。

时间区间选择:设定默认筛选值,手动设置时间区间。

过滤生效

该参数仅在展示类型是数字条件框和数字区间选择下支持,有两种的格式的设置:聚合前和聚合后。

格式化显示

该参数仅在展示类型是数字条件框和数字区间下支持,默认值是自动。

日期类型

该参数仅在展示类型是日期选择下支持设置,支持设置:年、季度、月、周、日。

时间类型

该参数在展示类型是时间条件框和时间区间选择下支持设置,支持设置:年、季度、月、周、日、时、分、秒。

条件操作符

该参数仅在展示类型是时间条件框下支持设置,支持设置:<、≤、>、≥、=。

字段类别

该参数在展示类型是条件单选框下支持设置,支持数值和文本设置。

过滤条件

该参数在展示类型是条件单选框下支持设置,数值支持:<、≤、>、≥、=、≠。文本支持:精确匹配、包含、不包含、不匹配、开头是、为空、不为空。

场景示例

通过查询控件对仪表板里的表格进行数据查询,并使用级联控件实现二次过滤查询,便于用户快速查询数据。

  • 步骤1:新建查询控件
    1. 在仪表板导航栏单击,新建查询控件。
    2. 在新建的查询控件中,单击,新建所需的查询条件。
      • 新建“产品类型”查询控件:选择需要查询的数据集和字段,并在右侧选择需要关联的图表和字段,字段选择“product_type”,如图2所示。
      • 新建“产品颜色”查询控件:选择需要查询的数据集和字段,并在右侧选择需要关联的图表和字段,字段选择“product_color”,其他参数与“产品类型”查询控件一致。
        图2 查询控件设置

  • 步骤2:配置级联控件
    1. 单击查询控件右上角的,进入查询控件设置界面。
    2. 在“产品类型”查询控件配置级联控件,如图3所示。级联控件设置成功后,在“产品类型”查询控件选择“book”,“产品颜色”查询控件只会显示“book”的颜色,而不是显示所有产品的颜色。
      图3 级联控件设置

      图4 级联控件效果

  • 步骤3:在仪表板查看需要查询的数据
    1. 在“产品类型”查询控件选择需要查询的产品类型。
    2. 在“产品颜色”查询控件选择需要查询的产品颜色。
    3. 单击查询控件右下角的“查询”,表格将显示查询到的数据。
    图5 查询结果

相关文档