查询控件

前提条件

已创建仪表板，请参考创建仪表板。

操作步骤

1. 在仪表板导航栏单击，新建查询控件。
2. 在新建的查询控件中，单击，新建所需的查询条件。
   图1 查询控件设置
   
3. 设置查询条件的相关参数。

   表1 查询控件设置参数

   参数	说明
   查询条件	命名条件的名称，在控件的左上侧展示名称。
   条件配置	对条件的设置，具体请参考表2。
   关联图表	查询条件关联仪表板上的图表内容。
   级联控件	级联控件支持展示类型选择下拉列表、日期选择、时间条件框、时间区间选择对数据的过滤。 查询控件的级联功能使用，例如设置的查询条件A中选择了省份，查询条件B中的市列表就只有查询条件A已选定的省份下的市，即需要配置查询条件A和查询条件B的关联关系。 说明： 时间类型组件只支持级联下拉列表控件。 时间条件框、时间区间选择、日期选择级联控件的关联字段时，只能选择对应的时间类型字段。 与下拉组件的级联一样，一个时间类型组件可以支持级联多个下拉组件。

   表2 条件配置参数

   参数	说明
   设置为必填选型	勾选后，查询时会携带查询条件，不勾选，不会携带查询条件。 说明： 查询条件A设置为必选项，条件A前面显示*，查询条件B为非必选项，条件B前面未显示*。 当对表格进行查询时，条件A未设置条件，直接对条件B进行设置，单击控件右下角的“查询”时，条件A会显示红色，无法进行数据过滤。只有先设置条件A后，在设置条件B，单击查询控件右下角的“查询”时，不会报错，关联的相应图表展示查询结果。
   展示类型	筛选条件支持以下几种展示类型：下拉列表、文本条件框、数字条件框、数字区间选择、日期选择、时间条件框、时间区间选择、条件单选框、列选择器。 说明： 时间区间选择增加了占位符，可以选择区间类型的参数。
   选项值来源	支持两种方式：自动解析和手动输入。该参数仅在展示类型为下拉列表时支持。 自动解析：选择数据集后支持查询字段和显示字段设置。 说明： 关联数据表所过滤的字段中有查询字段的值，在查询控件中查询后，关联的数据表才可显示数据，否则数据表为空。 手动输入：查询值和显示名称支持手工录入。
   数据集字段	展示类型为下拉列表时，需要和数据集的字段关联起来。
   查询方式	查询方式支持两种方式：单选和多选，该参数仅在展示类型为下拉列表时支持。
   查询时间	单击查询，该参数仅在展示类型为下拉列表时支持。 说明： 当数据集字段设置完成之后，便支持设置：设定筛选默认值、筛选、排序、增强检索等功能。
   默认提示文本	条件配置框的默认提示文字。
   设定筛选默认值	设定文本的默认筛选值，有以下条件可以设置：精确匹配、包含、不包含、不匹配、开头是、为空、不为空。在展示类型是数字区间选择仅支持设置数值范围。在展示类型是日期选择支持设置绝对时间和相对时间。
   过滤生效	该参数仅在展示类型是数字条件框和数字区间选择下支持，有两种的格式的设置：聚合前和聚合后。
   格式化显示	该参数仅在展示类型是数字条件框和数字区间下支持，默认值是自动。
   日期类型	该参数仅在展示类型是日期选择下支持设置，支持设置：年、季度、月、周、日。
   时间类型	该参数在展示类型是时间条件框和时间区间选择下支持设置，支持设置：年、季度、月、周、日、时、分、秒。
   条件操作符	该参数仅在展示类型是时间条件框下支持设置，支持设置：<、≤、＞、≥、＝。
   字段类别	该参数在展示类型是条件单选框下支持设置，支持数值和文本设置。
   过滤条件	该参数在展示类型是条件单选框下支持设置，数值支持：<、≤、＞、≥、＝、≠。文本支持：精确匹配、包含、不包含、不匹配、开头是、为空、不为空。

4. 设置查询控件的样式，参考表1设置。

   表3 查询控件样式参数

   参数	说明
   卡片标题	卡片支持有和无标题的设置。设置卡片的标题，在卡片的左上角展示。 无标题：当未勾选框时，为无标题格式。 有标题：当勾选框时，为有标题格式。
   文本	设置文本字体的大小和字体颜色。可通过输入修改字体大小也可通过和修改字体的大小。
   对齐方式	支持左对齐和居中对齐方式。
   下边距	卡片标题的下边距可设置，取值范围0~32。
   分割线	卡片支持无和有分割线的设置。 无分割线：当未勾选框时，为无分割线格式。 有分割线：当勾选框时，为有分割线格式。支持对分割线的样式和下框边距进行设置。分割线样式和下边框支持输入设置，也可通过和进行设置。
   卡片背景	卡片背景支持有背景和无背景设置。 无背景：当未勾选框时，为无背景格式。 有背景：当勾选框时，为有背景格式。支持背景颜色的设置。
   状态icon	可以设置icon的显示方式和颜色，支持始终显示和悬停显示。卡片icon支持有状态icon和无状态icon设置。 无背景：当未勾选框时，为无状态icon。 有背景：当勾选框时，为有状态icon。
   按钮设置	按钮显示：按钮可以显示以下内容查询、清空、重置。通过勾选进行设置，表示显示，表示不显示。
   	按钮位置：按钮位置支持固定右下角和在控件下方。通过和进行设置，表示设置该选项，表示不设置该选项。
   	按钮间距：设置按钮间的距离，支持输入也支持通过和进行输入设置。
   	主按钮颜色：设置主按钮的颜色。
   	主按钮边框颜色：设置主按钮的边框颜色。
   	主按钮文本颜色：设置主按钮的文本颜色。
   控件外观	控件间距：设置控件间的距离，支持输入也支持通过和进行输入设置。
   	控件圆角：设置控件间的弧度，支持输入也支持通过和进行输入设置。
   	字段标签：设置字段标签的在控件的位置，支持设置为左侧和上方。
   	控件但截断是需要进行四舍五入描边：支持控件边框颜色设置，当勾选框时，用户可以自定义控件边框颜色，当不勾选时，无法进行颜色设置。
   	控件填充：控件支持有颜色和无颜色填充设置。当未勾选框时，为无颜色格式。当勾选框时，为有颜色格式。
   功能设置	显示展开/收起按钮：支持设置为默认展开和默认收起。
   	可自定义筛选项查询模板：勾选自定义筛选模板发布报表后，可在查看态查询控件添加模板。该功能可通过和进行设置，表示可进行自定义设置，表示不可进行自定义设置。
   	默认查询：勾选后，默认查询用户配置的默认值。

5. 参数设置完成后，单击右侧的“保存”或“保存并发布”，保存查询控件组成的仪表板。
   

   保存与保存发布的区别：

   • 单击右侧的“保存”，输入仪表板的名称，单击“确定”保存成功，不支持仪表板的查看功能，支持删除仪表板。
   • 单击“保存并发布”，不仅保存了仪表板也发布了仪表板。支持仪表板查看功能，如果要删除仪表板需要先将仪表进行下线操作。
6. 在弹出的仪表板页面输入仪表板名称。

场景示例

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

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

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

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