查询控件的条件级联是用于建立多个查询条件之间关联逻辑的功能。通过级联配置，不同查询控件之间的选项值能够根据彼此的选择状态进行动态更新，例如：控件A中选择了某一地区，控件B中的省份选项列表就只有控件A已选定地区下的省份。本文将为您介绍如何配置查询控件间的条件级联。
前提条件
功能入口
您可以按需选择以下任一入口进入条件级联配置页面。
入口一：在仪表板编辑页面，按照下图指引进入。
入口二：在查询条件设置界面，单击条件级联配置按钮进入。
在条件级联配置页面中支持单向级联、双向级联两种级联模式。
单向级联：查询控件之间存在上下级别关系，遵循“上层决定下层”的传递逻辑，且不可反向级联。即当用户在上级控件中选择某个条件时，下级控件的选项列表会自动过滤，仅展示符合该条件的值。而当下级控件条件变更时，不会反向影响上级控件。
该模式适用于具有明确层级关系的维度筛选，例如：在“省份 > 城市”的地区筛选场景中，当用户在“省份”控件中选择了“浙江省”后，“城市”控件的下拉列表将自动更新，仅显示属于浙江省的城市；反之，选择城市无法反向改变省份的选项。
双向级联：在来源于同一数据集的多个查询条件之间，建立无上下级区别的联动关系。当任一查询条件的选中值发生变化时，其他所有查询条件的可选范围都会根据当前已选值进行动态过滤。
该模式适用于平级维度之间需要动态过滤的场景。例如：在同时筛选“产品类型”和“销售区域”时，无论用户先选择哪种产品类型，销售区域控件都只会展示有该产品销售的区域；反之，先选择销售区域，产品类型也只会展示该销售区域有的产品。
注意事项
层级限制
查询控件由上到下分为三个层级：全局控件 > Tab内查询控件 > 图表内查询控件。
单向级联只能从上往下传递，不可反向级联。即：全局控件可以级联全局控件、Tab内查询控件和图表内查询控件；Tab内查询控可以级联Tab内查询控件、图表内查询控件，不能反向级联全局控件；图表内查询控件可以级联图表内查询控件，不能反向级联全局控件和Tab内查询控件。
双向级联仅限全局控件层级使用，不支持Tab内查询控件和图表内查询控件使用。
个数上限：支持创建多组级联配置项，且单组最多可配置30个级联条件。但若某字段已参与某条双向级联，则不可再参与其他任何级联配置。
控件类型支持情况
关于不同级联配置项，与其对应支持的查询控件类型如下。
级联配置项
支持的查询控件类型
单向级联
同源级联
下拉列表且来源于单个数据集
树形下拉
日期选择且来源于数据集字段
非同源级联
下拉列表且来源于单个数据集
日期选择且来源于数据集字段
日期级联
日期选择
双向级联
下拉列表且来源于单个数据集
树形下拉
日期选择且来源于数据集字段
说明在配置同源级联和非同源级联的场景下，若将日期选择控件作为触发条件级联的第一层，那么即使该日期控件的选项值不来源于数据集字段，使用的是默认日期选择框，也能作为级联的起点。且不同情况下，日期控件的可选日期范围会有所区别：
当第一层日期条件为默认日期选项框，不来源于数据集，则日期可选的范围不受数据集范围影响。
当第一层日期条件来源于数据集字段，则日期可选的范围来源于数据集中有日期的数据范围。
其余事项
若某字段已参与某条双向级联，则不可再参与其他任何级联配置。
条件级联功能对下拉列表中的排除暂不生效。
双向级联配置与动态函数默认值功能互斥。
不同控件下可能存在相同的字段，为了便于区分，您可以选中显示标题并编辑控件名称。
创建单向级联
鼠标悬浮至条件级联配置页面下的创建单向级联按钮，在下拉列表中进一步选择需要创建的级联配置项类型。
在单向级联模式下，支持创建同源级联、非同源级联以及日期级联。
当多个查询控件的选项值均来源于同一个数据集时，推荐配置同源级联。
当多个查询控件的查询条件中，只要存在一个查询条件的数据集与其他数据集不同，您在关联条件级联时，需要选择非同源级联。
当查询控件的类型为日期选择时：
如果存在多个日期控件，且都未选择日期来源的数据集，您可以直接配置这多个日期条件间的级联，请参见日期级联。
如果存在单个日期控件和下拉列表等文本型控件，支持同源或者非同源级联。
同源级联
假设仪表板中查询控件A，包含的字段为区域和省份，仪表板中查询控件B，包含的字段为城市和产品类别。此时，查询控件A和B的数据均来自同一数据集。您通过关联控件A中的区域和控件B中的城市字段，实现在控件A选中某区域，则控件B中只会出现该区域下的城市。
选择条件级联配置页面下的创建单向级联 > 同源级联。
选择查询控件A中的目标字段区域，并单击右侧的
图标。选择需要与目标字段级联的条件字段城市。
单击确定。
此时当您在查询控件A中选择区域为西北，在查询控件B中选择城市时，可以看到查询控件B中仅出现西北区域下的城市。
图标。
非同源级联
假设仪表板中控件A，包含的字段为地域和产品类型，仪表板中控件B，包含的字段为省份和产品小类。此时，控件A和B的数据来自不同数据集。您通过关联控件A中的地域和控件B中的省份字段，实现在控件A选中某区域，则控件B中只会出现该区域下的省份。
选择条件级联配置页面下的创建单向级联 > 非同源级联。
选择查询控件A中的目标字段区域，并单击右侧的
图标。在新增的级联配置框中，进行以下配置。
选择B查询控件中，需要与目标字段级联的条件字段省份。
选择关联字段。
此处所选的关联字段必须为省份这个查询条件来源的数据集中接收上层条件传值的字段。例如，此处上层级为区域，下层级为省份，选择的area字段就是接收区域传值的字段。
关联字段支持选择维度、表达式值占位符和值占位符。其中，占位符的传值逻辑如下：
查询控件类型
查询方式
值占位符
表达式占位符
日期筛选
单时间：
如2024-05-28
2024-05-28
>=2024-05-28,<=2024-05-28
时间区间：
2024.05.28~2024.05.28
2024-05-28
>=2024-05-28,<=2024-05-28
时间区间：
2024.05.21~2024.05.28
2024-05-21
>=2024-05-21， <=2024-05-28
文本筛选
单选：华东
华东
in华东
多选：华东，华南，东北
华东，华南，东北
in华东，华南，东北
说明在时间区间筛选中，当筛选框的开始时间和结束时间不同时（例如：2024.05.28~2024.05.28），值占位符默认传开始时间2024-05-21；若需要选择结束时间2024.05.28，可以在数据集中进行指定,例如：report_date < '$val{report_date_ph.get(1)}' 。
占位符的具体使用方法请参见占位符。
配置完成后，单击确定。
此时当您在控件A中选择区域为东北，在控件B中选择省份时，可以看到控件B中仅出现东北区域下的省份。
日期级联
日期控件间的级联
假设仪表板中控件-日期包含的字段为季度、月，您可以通过关联这两个日期字段，实现日期级联效果，比如季度选择23年第一季度，则月的日期控件中可选择的筛选月份就只有第一季度的3个月份。
选择条件级联配置页面下的创建单向级联 > 日期级联。
说明日期级联的配置项中，可选的条件范围只有日期类型的查询控件（单时间和时间区间都可以），时间粒度仅支持年、年季、年月、年周，年月日、年月日时分秒，不包含时、时分、时分秒。
选择控件-日期中的目标字段季度，并单击右侧的
图标。选择需要与目标字段级联的条件字段月。
单击确定。
此时，当您选择季度为2023年第一季度时，在月中只能筛选2023年1~3月份。
日期控件和其他控件互相级联
仅日期查询控件数据来源选择数据集字段时，支持与其他类型的查询控件（下拉、树形下拉）互相级联。
以同源配置为例，实现日期控件级联其他控件。
选择条件级联配置页面下的创建单向级联 > 同源级联。
选择目标字段运输日期，并单击右侧的
图标。选择需要与目标字段级联的条件字段区域。
单击确定。
此时当您选择日期为2023-04-01，再选择区域时，可以筛选2023年4月1日对应的区域。
以非同源配置为例，实现其他控件级联日期控件。
选择条件级联配置页面下的创建单向级联 > 非同源级联。
选择查询控件B中的目标字段促销活动，并单击右侧的
图标。在新增的级联配置框中，进行以下配置。
选择需要与目标字段级联的条件字段日期。
选择关联字段。
说明此处所选的关联字段，必须为日期这个查询条件的来源数据集中，接收上层条件传值的字段。例如，此处上层级为促销活动，下层级为日期，选择的促销活动字段就是接收促销活动传值的字段。
配置完成后，单击确定。
此时当您在选择促销活动为春节活动，可以筛选春节活动对应的日期。
说明其他控件级联日期控件时，日期控件中可选的范围是数据集中有春节活动这个值的所有日期。
比如春节活动有3条数据，分别是春节活动，2024-02-05；春节活动，2024-02-10；春节活动，2024-02-17，那这个可选的范围是2024-02-05~2024-02-17这一整个连续的范围。
创建双向级联
假设仪表板的查询控件中包含产品类型和区域两个查询条件，且两者皆来自于同一个数据集。通过创建双向级联，实现选择某一产品类型时，区域的选项列表中只会展示有该产品销售的区域；反之选择某一区域时，产品类型的选项列表中只会展示该区域下有的产品类型。
选择条件级联配置页面下的创建双向级联 > 双向联动。
选择需要进行级联的字段产品类型，并单击右侧的
图标。选择需要进行级联的另一条件字段区域。
单击确定。
此时当您在查询控件中选择产品类型为办公用品，可以看到区域条件下只能选到有办公用品销售的区域；选择区域为西南，可以看到产品类型条件下只能选到西南区域下有的产品类型。
相关操作
您可以参考以下说明，对已配置的条件级联关系进行增删改操作。
增加级联配置项
当您需要配置多个级联配置项时，可点击页面右上角创建单向级联/创建双向级联按钮，按需选择配置项类型，即可新增一组级联配置项。
删除级联配置项
您可以在已添加的条件上方单击删除图标（①），删除该条件。也可以单击级联配置项右侧的删除图标（②），删除整个配置项。
级联配置项重命名
新增级联配置时，默认命名为级联配置项，您可以单击标题区域进行重命名。
