查询控件
通过查询控件可以对仪表板中的图表进行查询操作，从而展示用户需要的图表数据，查询控件支持对日期类型、文本类型、数值类型的字段进行查询。本文为您介绍如何新建查询控件。
约束限制
- 查询控件需要与图表组件配合使用。
- 查询控件支持配置级联控件实现二次过滤查询，但不建议配置二级以上的级联控件。
- 如需配置二级以上的级联控件，每级控件必须有明确的层级关系，且只能逐级配置。
前提条件
已创建图表仪表板或者已在新建仪表板页面配置图表组件。
操作步骤
- 在仪表板页面导航栏单击
，新建查询控件。 - 单击查询控件
，进入查询控件设置页面，新建所需的查询条件。参数说明请参见表1、表2。以新建“产品类型”和“产品颜色”控件为例。 - 新建“产品类型”查询控件：选择需要查询的数据集和字段，并在右侧选择需要关联的图表和字段，字段选择“product_type”，如图1所示。
- 新建“产品颜色”查询控件：选择需要查询的数据集和字段，并在右侧选择需要关联的图表和字段，字段选择“product_color”，其他参数与“产品类型”查询控件一致。
- （可选）配置级联控件，实现对图表的二次过滤查询。 在“产品类型”查询控件配置级联控件，查询条件选择“产品类型”，级联控件勾选“产品颜色”，字段选择“product_type”，如图2所示。级联控件设置成功后，在“产品类型”查询控件选择“book”，“产品颜色”查询控件只会显示“book”的颜色，而不是显示所有产品的颜色。
- 在仪表板查看需要查询的数据
- 在“产品类型”查询控件选择需要查询的产品类型。
- 在“产品颜色”查询控件选择需要查询的产品颜色。
- 单击查询控件右下角的“查询”，表格将显示查询到的数据。 图3 查询结果
- 单击页面右上角的“保存”或“保存并发布”保存仪表板。
| 参数 | 说明 |
|---|---|
| 查询条件 | 命名查询条件的名称，在控件的左上侧展示名称。 |
| 条件配置 | 对条件的设置，具体请参考表2。 |
| 关联图表 | 查询条件关联仪表板上的图表内容。 |
| 级联控件 | 级联控件支持展示类型选择下拉列表、日期选择、时间条件框、时间区间选择对数据的过滤。 查询控件的级联功能使用，例如设置的查询条件A中选择了省份，查询条件B中的市列表就只有查询条件A已选定的省份下的市，即需要配置查询条件A和查询条件B的关联关系。 说明：
|
| 参数 | 说明 |
|---|---|
| 设为必填选 | 勾选 说明： 查询条件A设置为必选项，条件A前面显示*，查询条件B为非必选项，条件B前面未显示*。 当对表格进行查询时，条件A未设置条件，直接对条件B进行设置，单击控件右下角的“查询”时，条件A会显示红色，无法进行数据过滤。只有先设置条件A后，在设置条件B，单击查询控件右下角的“查询”时，不会报错，关联的相应图表展示查询结果。 |
| 展示类型 | 筛选条件支持以下几种展示类型：下拉列表、文本条件框、数字条件框、数字区间选择、日期选择、时间条件框、时间区间选择、条件单选框、列选择器。 说明： 时间区间选择增加了占位符，可以选择区间类型的参数。 |
| 选项值来源 | 支持两种方式：自动解析和手动输入。该参数仅在展示类型为下拉列表时支持。
|
| 数据集 | 展示类型为下拉列表时，需要和数据集的字段关联起来。 |
| 查询方式 | 查询方式支持两种方式：单选和多选，该参数仅在展示类型为下拉列表时支持。 |
| 查询时间 | 单击查询，该参数仅在展示类型为下拉列表时支持。 说明： 当数据集字段设置完成之后，便支持设置：设定筛选默认值、筛选、排序、增强检索等功能。 |
| 设定筛选默认值 | 下拉列表：初始化值选择“固定”并手动选择查询字段的具体数值后，查询控件初始值会默认显示该值；初始化选择“默认第一个值”，查询控件初始值显示为下拉列表的第一个值，其他关联图表也匹配该值。 文本条件框：设定默认筛选值，有以下条件可以设置：精确匹配、包含、不包含、不匹配、开头是、为空、不为空。 数字条件框：设定默认筛选值，有以下条件可以设置：＞、≥、<、≤、＝、≠。 数字区间选择：设定默认筛选值，手动输入数字区间。 日期选择、时间条件框：设定默认筛选值，支持设置相对时间、绝对时间。 时间区间选择：设定默认筛选值，手动设置时间区间。 |
| 默认提示文本 | 条件配置框的默认提示文字。 |
| 提示内容 | 支持设置每个查询条件的提示信息，设置后查询条件名称右侧出现 |
| 过滤生效 | 该参数仅在展示类型是数字条件框和数字区间选择下支持，有两种的格式的设置：聚合前和聚合后。 |
| 格式化显示 | 该参数仅在展示类型是数字条件框和数字区间下支持，默认值是自动。 |
| 日期类型 | 该参数仅在展示类型是日期选择下支持设置，支持设置：年、季度、月、周、日。 |
| 时间类型 | 该参数在展示类型是时间条件框和时间区间选择下支持设置，支持设置：年、季度、月、周、日、时、分、秒。 |
| 条件操作符 | 该参数仅在展示类型是时间条件框下支持设置，支持设置：<、≤、＞、≥、＝。 |
| 字段类别 | 该参数在展示类型是条件单选框下支持设置，支持数值和文本设置。 |
| 过滤条件 | 该参数在展示类型是条件单选框下支持设置，数值支持：<、≤、＞、≥、＝、≠。文本支持：精确匹配、包含、不包含、不匹配、开头是、为空、不为空。 |
