复合查询控件
功能概述
复合查询控件是 Quick BI 仪表板中一种高级的查询工具，它允许用户通过构建多层嵌套的“与” 和“或”逻辑关系，来实现对同源数据集下图表组件的多条件动态筛选和查询。与常规的单个查询控件相比，复合查询控件提供了更强大的条件组合能力，能够满足更复杂的业务查询需求，例如查询“某个地区”并且“某个产品类型”的销量情况，或者查询“A产品”或“B产品”在“特定时间段内”的销售数据。
主要优势:
复杂条件组合: 支持构建具有层级结构的“与”和“或”逻辑查询，满足精细化的数据筛选要求。
多字段联合查询: 可以在一个控件内同时对多个不同的字段（文本、数值、日期类型）设置筛选条件。
提升分析灵活性: 使得用户能够根据非常具体的、多维度的条件来探索数据，发现更深层次的洞察。
统一查询入口: 将多个潜在的单一查询条件整合到一个控件中，简化了仪表板的布局和用户操作。
应用场景:
需要同时满足多个不同维度或度量条件的查询，例如：“查询华东地区，并且订单等级为高级，同时订单金额大于5000元的客户数据”。
需要满足多个条件中的任意一个或几个的查询，例如：“查询产品类型为‘家具’或‘家电’，并且在2023年第一季度或第二季度有销售记录的数据”。
需要构建具有层级逻辑的查询，例如：“查询（A条件 且 B条件）或 C条件”。
前提条件：
在配置复合查询控件前，请确保您已在仪表板编辑页面。
操作步骤：
以下是配置和使用复合查询控件的主要步骤和核心配置项说明：
1. 添加与数据源设置
在仪表板编辑页面的顶部导航栏中，单击“添加查询控件”，然后选择“复合式查询控件”。
选中新添加的复合查询控件，在页面右侧的“数据”标签页中进行以下设置：
选择数据集: 从下拉列表中选择该复合查询控件将要作用的数据集。非常重要的一点是，复合查询控件只支持对来源于同一个数据集的图表组件进行筛选。
您可以单击数据集名称旁边的图标（通常是编辑或跳转图标），直接跳转到该数据集的编辑页面，方便对维度、度量进行检查或修改。
2. 配置查询字段与筛选条件
单击“配置查询字段”按钮，进入“查询条件设置”页面。
a. 关联图表
在“查询条件设置”页面的顶部或相应区域，选择需要被此复合查询控件影响的图表。
重要限制: 复合查询控件只支持关联同源数据集的图表。也就是说，这里列出的可选图表必须与您在第一步中为该控件选择的数据集是同一个。
不支持级联查询: 复合查询控件通常不直接参与或作为级联查询的源头或目标（级联查询是指一个查询控件的选择结果会动态影响另一个查询控件的选项范围）。
b. 设置筛选条件
这是复合查询控件的核心配置区域，您将在这里构建查询逻辑：
添加条件:
单击“添加条件”按钮，在当前关系层级下新增一个筛选条件行。
选择筛选字段: 从所选数据集中搜索或下拉选择一个需要设置筛选条件的字段
选择筛选方式: 根据字段类型（文本、数值、日期）选择合适的筛选方式。
文本类型: 支持“枚举筛选-单选”、“枚举筛选-多选”、“条件筛选”（包含、不包含、等于、不等于等）。
数值类型: 通常是条件筛选（大于、小于、等于、介于等）。
日期类型: 支持“快捷区间”（如昨日、近7天）和“日期粒度”（选择具体日期或日期范围）。
填写默认值 : 为该筛选条件设置一个默认的选中值或输入值。
删除条件: 单击筛选条件行尾部的删除图标，可以移除该条筛选条件。
添加关系 :
单击“添加关系”按钮，会在当前关系层级的内层添加一个新的关系节点（“与”或“或”）。可以用于构建嵌套的查询逻辑。
修改关系类型
单击已有的关系节点（例如，最外层的关系节点或内层添加的关系节点），可以选择其逻辑关系类型是“且”还是“或 ”。
嵌套逻辑: 遵循一个交替的逻辑关系：
如果外层关系是“且”，那么通过“添加关系”在其内层创建的新关系节点默认为“或”。
如果外层关系是“或”，那么内层新关系节点默认为“且”。
即形成如：且-或、或-且、且-或-且、或-且-或 这样的交替嵌套结构。
删除关系节点: 单击关系节点旁边的删除图标，可以删除该节点及其下包含的所有筛选条件和子关系。
层级限制: 一条查询逻辑链路上最多支持添加三层关系节点。
完成所有筛选条件和逻辑关系的配置后，单击“确定”按钮。
3. 控件样式配置
配置项 | 配置说明 |
标题与卡片 | 可设置控件的标题和组件内容。
在标题里，设置控件是否显示标题及标题的样式. 支持设置分割线。
支持设置自定义背景填充（①）、圆角（②）和卡片内间距（③）。 |
基础设置 | 可设置是否隐藏查询按钮，开启后每次操作都将发起筛选。
|
控件样式 | 可设置控件高度、字段标签显示方式。
|
字段样式 | 可设置字段的显示宽度。
|
复合查询示例
1. 文本查询示例
文本类型数据支持枚举筛选-单选、枚举筛选-多选、条件筛选三种筛选方式。
单击复合查询控件，在数据标签页为复合查询控件选择数据集。
单击配置查询字段，选择需要关联的图表。
在设置筛选条件页签，设置筛选条件。
单击添加条件，筛选字段选择区域 ，字段名称默认为区域，筛选方式选择枚举筛选-单选，默认值选择东北。
单击添加条件，筛选字段选择订单等级，字段名称默认为订单等级，筛选方式选择条件筛选，默认值选择精确匹配，高级。
单击确定。
在复合查询中单击查询，控件所作用的图表会自动更新。
2. 数值查询示例
单击复合查询控件，在数据标签页为复合查询控件选择数据集。
单击配置查询字段，选择需要关联的图表。
在设置筛选条件页签，设置筛选条件。
单击添加条件，筛选字段选择订单金额，默认字段名称为订单金额，默认值选择大于，500。
单击添加条件，筛选字段选择利润金额，默认字段名称为利润金额，默认值选择大于，1000。
单击确定。
在复合查询中单击查询，控件所作用的图表会自动更新。
说明
筛选条件目前只支持筛选数值型字段的数值，根据图表中度量选择的聚合方式展示数据。例如交叉表中订单数量字段聚合方式为sum，复合查询控件中筛选订单数量大于30的数据，则交叉表中展示所有订单数量大于30且聚合方式为sum的数据。
3. 日期查询示例
日期类型数据支持快捷区间和日期粒度两种筛选方式。
单击复合查询控件，在数据标签页为复合查询控件选择数据集。
单击配置查询字段，选择需要关联的图表。
单击添加条件，设置筛选条件。
说明
筛选一段时间范围时，需先添加一个筛选字段设置默认值为大于或大于等于，再添加相同日期筛选字段设置默认值为小于等于或小于。
单击添加条件，筛选字段选择订单日期(year)，字段名称默认为订单日期(year)，默认值选择大于，2011。
单击添加条件，筛选字段选择report_date(year)，修改标签名为日期，默认值选择小于等于，2016。
单击确定。
在复合查询中单击查询，控件所作用的图表会自动更新。
常见问题 (FAQ)
问：复合查询控件可以关联不同数据源的图表吗？答：不可以。复合查询控件的一个核心限制是只支持对来源于同一个数据集的图表组件进行筛选。如果您需要筛选不同数据源的图表，需要为每个数据源单独配置查询控件，或者考虑使用Quick BI的其他跨数据源查询或参数传递功能（如果支持）。
问：我最多可以设置多少层嵌套的“与”或“或”关系？答：根据文档说明，一条查询逻辑链路上最多支持添加三层关系节点。这意味着您可以构建例如 “A 且 (B 或 (C 且 D))” 这样的三层逻辑。
问：如果我设置了外层是“且”，内层一定是“或”吗？可以改成“且”吗？答：Quick BI的复合查询控件在添加内层关系时，其类型通常与外层相反且固定。即外层是“且”，内层默认生成“或”；外层是“或”，内层默认生成“且”。您不能手动将内层自动生成的“或”再改成“且”（如果外层是“且”的话）。这种设计是为了简化复杂逻辑的构建并保证一定的结构性。
问：复合查询控件支持像普通查询控件那样的级联功能吗？答：根据文档说明，复合查询控件不支持级联查询。级联查询通常指一个查询控件的选择会影响另一个查询控件的选项。
后续步骤
保存与预览: 完成复合查询控件配置后，务必保存仪表板，并在预览模式下充分测试所有逻辑分支和条件组合，确保其筛选结果符合预期。
用户培训与引导: 由于复合查询控件的逻辑可能相对复杂，如果最终用户需要自行修改查询条件，建议提供简单的使用说明或培训。
分享与反馈: 将配置好的仪表板分享给最终用户，并收集他们关于复合查询控件易用性和功能满足度的反馈，以便持续优化。