通过查询控件可以查询单个或多个图表中的数据,一个仪表板中可以添加多个查询控件,但只支持一个查询控件置顶。

前提条件

已创建好仪表板。请参见新建仪表板概述

添加查询控件

  1. 登录Quick BI控制台
  2. 单击工作空间 > 数据集
  3. 数据集管理页面,选择company_sales_record数据集,单击数据集所在行的新建图标。
    说明 如果您使用的是专业版,需要您手动选择进入常规模式或者全屏模式。以下示例以常规模式为例。
  4. 在顶部菜单栏单击查询控件图标,添加查询控件。
  5. 在仪表板编辑区域,找到该查询控件并单击添加图标。新建
  6. 查询条件设置页面,完成以下三部分内容的设置。
    1. 查询条件
      当您在查询条件区域单击添加图标,新增查询条件时,默认名称为未命名,您可以输入查询条件名称。查询条件名称
      说明
      • 输入查询条件名称后离开该区域命名即生效。
      • 查询条件可通过隐藏图标隐藏,隐藏后配置内容保留,在仪表板中不再显示。
      • 单击更多操作图标,重命名或删除查询条件。
    2. 关联图表及字段
      选中要关联的图表并选择关联的字段,可开启字段智能选入功能,同数据集下所选图表的关联字段将被自动填入。如果图表过多,可通过筛选功能选择需要的图表。关联图表及字段
      不支持不同类型的字段同时关联,如下图中同时关联日期类型和数值类型字段,会有以下提示。错误提示
    3. 查询条件配置
      查询条件配置因选择关联字段的类型不同而不同,以下为时间类型字段年粒度的查询条件配置,更多类型配置详情请参见查询类型配置展示查询条件配置
    4. 条件级联配置
      请参见配置条件级联

样式

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

  1. 基础设置中,设置显示标题、是否全局置顶、是否隐藏查询按钮、显示清空按钮、显示重置按钮和控件类型。
    基础设置
    说明 仅当选中显示清空按钮显示重置按钮时,才会出现重置清空按钮。
    • 重置:表示查询条件恢复到设置的默认值。
    • 清空:表示清除查询条件中显示的值。

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

  2. 控件样式中,设置控件高度、内容排版和显示字段标签。控件样式
  3. 字段样式中,设置字段的取值样式和筛选器宽度。
    日期字段和数值字段只能设置筛选器宽度,文本字段还支持设置取值样式,包含下拉和平铺两种样式。字段样式
    如果您在设置过滤条件时选择勾选排除功能,则在查询控件中选中的选项即为排除的选项。23

查询类型配置展示

下面主要为您介绍以下展示类型所进行的配置。
  • 日期选择

    一旦关联了日期类型的字段,查询控件会自动推荐日期选择作为展示类型,同时根据所关联的不同粒度的日期字段来推荐时间粒度。目前支持多种时间粒度,例如年-季度年-月年-周年-月-日年-月-日-时-分-秒时-分时-分-秒

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

    在区间范围的筛选方式中,开始于结束于两种区间类型选项,不需要填写完整的起止时间也能发起查询。1
    您可以给不同的时间粒度定制快捷区间,对应关系如下。
    时间粒度 快捷区间
    • 去年
    • 今年
    年-季度
    • 本季度
    • 上季度
    年-月
    • 本月
    • 上个月
    • 最近3个月
    • 最近6个月
    • 最近12个月
    • 今年上半年
    • 今年下半年
    年-周
    • 本周
    • 上周
    年-月-日
    • 今天
    • 昨天
    • 前天
    • 年初至今
    • 月初至今
    • 最近7天
    • 最近15天
    • 最近30天
    • 最近60天
    • 上周
    • 上个月
    • 最近(不包含今天)
      • 最近7天
      • 最近15天
      • 最近30天
      • 最近60天
    • 最近星期几
      • 最近星期一
      • 最近星期二
      • 最近星期三
      • 最近星期四
      • 最近星期五
      • 最近星期六
      • 最近星期日
    • 其他
      • 本月就一天
      • 上月第一天
      • 上月最后一天
    时、时-分、时-分-秒 不支持快捷区间功能
  • 数值输入框
    当关联字段为度量时,可以在查询控件中选择聚合方式,默认为求和,也可以选择无聚合或其他聚合方式,本次优化将聚合方式改为了平均值。️
    说明 聚合查询控件无法查询明细数据。在条件形式中,我们可以选择不同的展现形式,可以选择单个条件和且或条件。如果想让报表的预览者只能使用固定的条件形式如只可以使用等于的条件,则需要选中锁定筛选条件
    数值输入框
  • 文本输入框
    与数值输入框类似,文本框可以选择单条件或条件且条件三种条件形式。不包含
  • 下拉列表(原枚举筛选)
    当展示类型为下拉列表(原枚举筛选)时,选项值来源为查询条件字段可供选择的筛选值,支持自动解析单个数据集手工输入三种方式。
    • 当选项值来源为自动解析时,自动解析左侧关联图表区域选中的字段值的合集,界面仅展示1000条。

      查询方式选择多选时,选中设定筛选默认值并配置默认值。

      字段页面,您可以进行以下操作:
      • 在搜索框输入关键字,并单击下方关键字,将左侧目标字段值添加到右侧的已添加列表中。
      • 单击添加左侧全部字段值,将左侧全部字段值添加到右侧的已添加列表中。
      • 勾选左侧字段值,将选中的字段值添加到右侧的已添加列表中。
      • 单击排除,添加到右侧的已添加列表中的字段值被排除。
        说明
        • 如果您配置默认值时选择排除该字段值,又将下拉列表的样式切换为平铺,则在查询控件中选择该字段值,表示排除该字段。
        • 如果您先配置的平铺样式,又在配置默认值时选择排除该字段值,则将普通平铺样式替换成平铺排除的样式。
      • 单击清空,添加到右侧的已添加列表中的字段值被清空。
      1
    • 当选项值来源为单个数据集时,选择当前仪表板所在空间内的所有数据集,推荐的数据集为关联图表来源的数据集。图表中关联字段和单个数据集中查询值字段以及显示名称字段的关系如下。23
      • 关联字段为图表中待关联字段。
      • 查询值字段为选项值来源数据集中要与关联字段匹配的字段。
      • 显示名称字段为选项值来源数据集中要进行筛选的字段,即查询控件中显示的字段。
        说明
        • 显示名称字段查询值字段一致时,选择查询值字段后,系统将自动填入显示名称字段。
        • 显示名称字段查询值字段不一致时,需要手动修改显示名称字段。
    • 当选项值来源为手工输入时,需要通过单击手工录入图标,在手工录入页面,手工输入查询值字段和显示名称字段:
      • 当第一次进行手工录入且查询值与显示名称一致时,需要输入查询值并单击确定后,系统会自动输入显示名称。
      • 当第一次进行手工录入且查询值与显示名称不一致时,需要手工输入查询值和显示名称。
      • 当非第一次进行手工录入时,新增查询值和显示名称均需手工输入。只输入查询值会收到以下提示。错误提示
  • 树形下拉
    当展示类型为树形下拉时,选择数据集支持同数据集和非同数据集,展示形式支持树形展示平铺展示,查询方式支持单选多选
    图 1. 树形单选展示
    2
    图 2. 树形多选展示
    1
    快捷关联功能默认开启,通过该功能可以为树形结构的子层级自动选入同数据集下的关联图表及字段。单击树形结构中的关联图表,或单击左侧查询项中子层级的名称,为树形结构的子层级关联其他数据集下的图表和字段。关联图表例如,下图中设置第二层级province进行关联图表及字段时,同数据集的图表线图饼图的关联字段可以自动选入,非同数据集的图表指标看板的关联字段需要手动录入。自动载入