如何设置一个文本查询控件,用于查询文本字段_智能商业分析 Quick BI(Quick BI)-阿里云帮助中心

查询控件支持查询文本字段，本文为您介绍如何设置一个文本查询控件，用于查询文本字段。

前提条件

已创建好仪表板，并且仪表板图表中包含文本字段。
已为该仪表板添加一个空的查询控件。请参见新建查询控件。

配置查询条件

请参见新建仪表板，进入仪表板编辑页面。
在仪表板列表中，找到并单击目标仪表板。
仪表板图表中需要包含文本字段。请参见线图。
按照下图步骤，添加查询控件。
设置查询控件。
1. 设置查询条件名称为等级查询。
2. 选中关联图表线图和关联字段订单等级。
3. 设置展示类型并完成查询条件的配置。
  1. 当您选择展示类型为下拉列表时，应用示例请参见下拉列表。
  2. 当您选择展示类型为文本输入框时，应用示例请参见文本输入框。
  3. 当您选择展示类型为树形下拉时，应用示例请参见树形下拉。
单击确定。

下拉列表

下拉列表展示类型可以将报表制作者预先定义好的选项，以列表的形式清晰地展现给报表查看者，并供其选择。当展示类型为下拉列表时，选项值来源支持自动解析、单个数据集和手工输入。

自动解析

当选项值来源选择为自动解析时，Quick BI系统将自动识别所有关联字段的值，以并集的形式作为查询控件的选项。

说明

关联图表及字段区域选择的图表是同一个数据集，则选择自动解析表示系统自动获取该数据集的值。
关联图表及字段区域选择的图表是多个数据集，则选择自动解析表示系统自动获取多个数据集的值。即，下拉列表中的值是关联的多个数据集的合集。

配置项	说明	示例
查询方式	支持单选和多选。	查询方式：选择多选。查询时间：选择点击查询。设定筛选默认值：设定订单等级为高级、省份为广东省、产品类型为家具产品。
查询时间	支持点击查询和预先查询。点击查询：默认值。当触发查询按钮时，启动条件查询。预先查询：打开仪表板前预先查询下拉列表的内容值，能够按照行级权限的配置展示各个账号对应的下拉列表值，且每个人的默认值也会根据对应行级权限的配置而有所不同。预先查询适用于目标数据集已配置行级权限且数据量较小的场景，否则会影响整体报表加载时间。
设定筛选默认值	选中该选项，查询条件框中会显示为请选择，点击查询条件框，即可在字段弹窗中进行默认值的配置。您可以在此弹窗中：在搜索框输入关键字，并单击下方关键字，将左侧目标字段值添加到右侧的已添加列表中。单击添加左侧全部字段值，将左侧全部字段值添加到右侧的已添加列表中。勾选左侧字段值，将选中的字段值添加到右侧的已添加列表中。单击排除，添加到右侧的已添加列表中的字段值被排除。说明如果您配置默认值时选择排除该字段值，又将下拉列表的样式切换为平铺，则在查询控件中选择该字段值，表示排除该字段。如果您先配置的平铺样式，又在配置默认值时选择排除该字段值，则将普通平铺样式替换成平铺排除的样式。单击清空，添加到右侧的已添加列表中的字段值被清空。说明当筛选项大于1000条时，默认展示前1000条的选项值，超出此范围可直接搜索。

综上，本例：

关联图表及字段区域中选择了关联多个数据集的不同字段，即查询控件的下拉列表中将展示所有关联字段值的并集。
查询方式选择为多选，即查询控件中支持同时选中多个选项。
查询时间选择为点击查询，即报表查看者需要点击查询按钮，才能触发条件查询。
筛选默认值选择为高级、广东省、家具产品，即当报表查看者打开报表时，报表默认展示订单类型为高级、省份为广东、产品类型为家具产品的查询结果。

具体效果如下： 112

单个数据集

当选项值来源选择为单个数据集时，查询控件中的选项将取决于指定数据集中某个字段的值。

配置项	说明	示例
选择数据集	支持选择当前仪表板所在空间内的所有数据集，推荐选择的数据集，为图表数据来源。	选择数据集：本例选择作为数据来源的数据集：company_sales_record。查询值字段：订单等级。显示名称字段：订单等级。排序字段：订单日期。查询方式：选择多选。查询时间：选择点击查询。设定筛选默认值：选中该选项，并设置默认值为高级。
查询值字段	所选数据集中要与关联字段匹配的字段。该字段用于进行实际查询，报表查看者可以从该字段的值中选择一个或多个选项，来查询数据。
显示名称字段	查询控件中展示为选项值的字段。该字段通常用于改善查询控件的使用体验，帮助报表查看者更好地理解选项值意义。与查询值字段一致：当查询值字段的值已足够清晰且易于理解，那么您可以将显示名称字段设置为与查询字段相同。此时，选择查询值字段后，系统将自动填入显示名称字段，您无需另外操作。与查询值字段不一致：当查询值字段的值为数字编码或不易于理解的代码，那么您可以在数据表中设置一个易于理解的显示名称字段，来作为查询控件中的显示选项值（实际查询依然以查询值字段为准）。此时，在选择查询值字段后，您需要手动修改显示名称字段。
排序字段	支持按照选定字段进行排序。可选项，不填写则默认按照数据集中顺序排序。如果需要设置按照某一个字段排序，可以在下拉选择排序字段（例如按照度量排序，或按照日期的先后顺序进行排序）。设置生效后，可以影响查询控件的下拉列表的排序，不影响图表内的维值排序，图表内的维值排序仍然通过数据集或者各个图表内的数据面板来实现。
查询方式	支持单选和多选。
查询时间	支持点击查询和预先查询。点击查询：默认值。当触发查询按钮时，启动条件查询。预先查询：打开仪表板前预先查询下拉列表的内容值，能够按照行级权限的配置展示各个账号对应的下拉列表值，且每个人的默认值也会根据对应行级权限的配置而有所不同。说明预先查询适用于目标数据集已配置行级权限且数据量较小的场景，否则会影响整体报表加载时间。
设定筛选默认值	选中该选项，查询条件中会显示预设值。说明当筛选项大于1000条时，默认展示前1000条的选项值，超出此范围可直接搜索。当查询时间为点击查询时，支持设定筛选默认值。当查询时间为预先查询时，支持手动设置和动态函数（查询值字段和显示名称字段相同时才支持动态函数）。预先查询适合需要提前取数，如根据每个访问者的行级权限显示不同筛选项的场景。动态函数支持设置查询字段最大值、查询值字段最小值和查询值字段第一项。说明查询值字段第一项取的是数据集中该查询值字段的第一个值，如果在数据集中该字段有排序（升降序、自定义排序等），则按照这个排序的第一个取，不受到上方选项值来源排序字段的影响。

综上，本例：

数据集为系统推荐数据集company_sales_record，即作为当前图表数据来源的数据集。
查询值字段与关联字段相同，即选择订单等级作为实际查询时的选项值。
显示名称字段与查询值字段相同，即都为订单等级。
排序字段选择订单日期来作为控件选项值的排序依据。
查询方式选择多选，即报表查看者可以在查询控件中选择多个选项值。
查询时间选择点击查询，即报表查看者需要点击查询按钮，才能触发条件查询。
设定筛选默认值设置为高级，即当报表查看者打开报表时，报表默认展示订单类型为高级的查询结果。

具体效果如下：

112

手工输入

当选项值来源选择为手工输入时，查询控件中的选项将由报表制作者根据图表选入字段值自定义输入。

配置项	说明	示例
手工录入	单击手工录入，在手工录入弹窗中输入查询值和显示名称。查询值：即图表选入字段的值。例如本例中的选入字段为订单等级，对应的值为高级、中级、低级、其他。显示名称：即查询值在下拉列表中对应展示的文本。说明当第一次进行手工录入且查询值与显示名称一致时，只需输入查询值并单击确定后，系统会自动输入显示名称。当第一次进行手工录入且查询值与显示名称不一致时，需要手工输入查询值和显示名称，且需确保查询值和显示名称的行数一致，能够一一对应。当非第一次进行手工录入时，新增查询值和显示名称均需要手工输入。只输入查询值会收到以下提示。	手工录入：本例中，字段值与其对应显示名称如下：高级-A级；中级-B级；低级-C级；其他-D级。查询方式：多选设定筛选默认值：选中该选项，并设置默认值为A级（即高级）。
查询方式	支持单选和多选。
设定筛选默认值	选中该选项，查询条件中会显示预设值。

综上，本例：

手工录入与订单等级字段值及对应的展示值，即高级对应A级、中级对应B级、低级对应C级、其他对应D级。
查询方式选择多选，即报表查看者需要点击查询按钮，才能触发条件查询。
设定筛选默认值设置为高级，即当报表查看者打开报表时，报表默认展示订单类型为高级的查询结果。

具体效果如下：

112

文本输入框

文本输入框的展现形式允许报表查看者通过在查询框中输入关键字，快速得到所需数据，帮助数据查询更精确与灵活。当展示类型为文本输入框时，条件形式支持单条件、或条件、且条件三种。以或条件为例。

配置项	说明	示例
条件形式	支持单条件、或条件和且条件单条件：即满足某个单一的条件。例如：产品类型为尺子。或条件：即满足两个条件中的任意一个条件。例如：产品类型为尺子或铅笔。且条件：即满足同时满足两个条件。例如：订单金额大于100且小于200。	条件形式：选择或条件。设定默认值：设定包含的字符为尺子，或者开头是的字符为桌。锁定筛选条件：选中该选项。
设定默认值	根据条件形式的取值而不同。以为产品类型字段设定默认值为例，规则及对应SQL语法关系如下：精确匹配：`product_sub_type=‘尺子’` 不匹配：`product_sub_type!=‘尺子’` 包含：`product_sub_type like ‘%尺子%’` 不包含：`product_sub_type not like '%尺子%'` 开头是：`product_sub_type like '尺子%'` 结尾是：`product_sub_type like '%尺子'` 为空：`product_sub_type is null` 不为空：`product_sub_type is not null` 空文本：`product_sub_type=''` 不为空文本：`product_sub_type!=''`
锁定筛选条件	开启后预览页面不可切换条件形式。说明选中设定默认值时，才会出现该选项。

综上，本例：

条件形式选择或条件，即查询数据时，满足任意一个查询条件的数据即可被展示。
设定默认值为包含字符尺子，或者开头是的字符为桌。即当报表查看者打开报表时，报表默认展示产品类型包含字符尺子，或开头字符是桌的查询结果。
锁定筛选条件：选中该选项，即报表查看者在报表页面不可切换查询控件中的条件形式。

具体效果如下：

112

树形下拉

树形下拉展示类型允许报表查看者通过下拉选择的方式，在具有父子层级关系的数据中进行筛选，例如：选择某一业务区域，及该区域下的省份、城市等。

配置项	说明		示例
选择数据集	支持选择当前仪表板所在空间内的所有数据集，推荐选择的数据集，为图表数据来源。		选择数据集：本例选择当前图表来源数据集company_sales_record。树形结构设计：层级一配置区域字段，层级二配置省份字段。展示形式：选择平铺展示。查询方式：选择多选。查询时间：选择点击查询。设定默认值：设定默认值为东北 > 辽宁。快捷关联：选中快捷关联。
树形结构设计	点击开始配置，在树形结构设计弹窗中配置查询控件中各层级的查询字段、显示字段。查询字段：该字段用于进行实际查询，报表查看者可以从该字段的值中选择一个或多个选项，来查询数据。显示名称字段：当查询字段为比较难以理解的业务ID或代码时，您可以通过设定显示名称字段，以使查询字段的选项更易于理解。说明选择查询值字段时，系统会自动填入显示名称字段。显示名称字段与查询值字段默认一致，如果不一致需要手动修改。树形下拉最多支持四级查询。
展示形式	支持选择树形展示、平铺展示。说明当数据超过1000条时，建议您选择展示形式为平铺展示。	树形单选展示树形多选展示平铺单选展示平铺多选展示
查询方式	支持选择单选、多选。
查询时间	支持点击查询和预先查询。点击查询：当点击查询按钮时，才会启动条件查询。预先查询：在打开仪表板页面时，预先查询下拉列表的内容值，能够按照行级权限的配置展示各个账号对应的下拉列表值，且每个人的默认值也会根据对应行级权限的配置而有所不同。说明预先查询适用于目标数据集已配置行级权限且数据量较小的场景，否则会影响整体报表加载时间。
设定默认值	选中该选项并设定相关值，后续报表页面载入时查询控件中会显示预设好的值。说明此处默认值为树形结构设计中的显示名称字段。
快捷关联	选中快捷关联后，树形结构中的子层级字段，会被自动选入到同数据集图表的关联图表及字段中，从而提高查询控件配置的效率和准确性。例如：下图中对第二层级省份进行关联图表及字段设置时，系统已自动将省份字段，填入到同数据集图表线图和柱图的关联字段中，而非同数据集图表饼图的关联字段，需要手动录入。说明只有在主层级的关联图表及字段中被选中的图表，才支持自动同步子层级字段。您可以单击树形结构中的关联图表，或单击左侧查询项中子层级的名称，为树形结构的子层级关联其他数据集下的图表和字段。