查詢控件的關聯時，例如控件A中選擇了地域，控件B中的省份列表就只有控件A已選定的地域下的省份，則需要配置控件A和控件B的關聯關系。您也可以配置同一控件中幾個條件的關聯關系。本文主要為您介紹如何通過配置條件級聯來關聯查詢控件。
前提條件
背景信息
條件級聯用于關聯一個或多個查詢控件，查詢控件中的條件支持查詢來源于同一個數據集或不同數據集。
當多個查詢控件，只要有一個查詢條件的數據集與其他數據集不同，您在關聯條件級聯時，必須選擇非同源配置。
當多個查詢控件的查詢條件中，選項值來源均為同一個數據集，您在關聯條件級聯時，可以選擇同源配置或非同源配置。
說明同一個數據源時，選擇同源配置更簡單，并且條件級聯的效果與非同源配置相同。
當需要進行多個日期查詢控件之間級聯時，您在關聯條件級聯時，可以選擇日期級聯配置。
使用限制
條件級聯配置支持同源配置和非同源配置：
級聯配置項
支持的篩選類型
同源級聯配置
下拉列表且來源于單個數據集
樹形下拉
日期選擇且來源于數據集字段
非同源級聯配置
下拉列表且來源于單個數據集
日期選擇且來源于數據集字段
日期級聯配置
日期選擇
說明在同源級聯配置和非同源級聯配置中，級聯條件的第一層如果是日期類型的條件，不來源于數據集也可支持級聯。
第一層日期條件若是默認的日期控件，不來源于數據集，則日期可選的范圍不受數據集范圍影響。
第一層日期條件若來源于數據集，則日期可選的范圍來源于數據集中有日期的數據范圍。
單個級聯配置項最多可配置5個級聯條件，當超過5個條件時，您可以配置多條級聯。
注意事項
上層關系能級聯下層關系，同一層級的條件之間可以建立級聯；不可反向級聯。
說明層級關系：全局控件>Tab內查詢控件>圖表內查詢控件，即全局控件可以級聯全局控件、Tab內查詢控件和圖表內查詢控件；Tab內查詢控可以級聯Tab內查詢控件、圖表內查詢控件，不能反向級聯全局控件；圖表內查詢控件可以級聯圖表內查詢控件，不能反向級聯全局控件和Tab內查詢控件。
不可反向級聯：假設控件A包含的字段為區域和產品類型，設置了區域級聯產品類型后，產品類型不能反向級聯區域。
不同控件下可能存在相同的字段，為了便于區分，您可以選中顯示標題并編輯控件名稱。
當隱藏級聯條件中的查詢條件時，除了隱藏第一層級時級聯配置會保留，其余情況級聯配置都會清空。
設置級聯條件后，如果隱藏查詢條件中的第一層級，則：
第一層級設置了默認值，按照默認值生效，子層級中的可選項來源于默認值的下一層。
例如，級聯條件為區域省份城市區縣，區域的默認值為東北，則城市或區縣的可選項來源于默認值東北下的省份。
第一層級沒有設置默認值，可選項來源于全局參數傳過來的值，則按照全局參數的值生效。
第一層級沒有設置默認值也沒有全局參數傳值，隱藏后也無法選擇第一層級的值，那么相當于沒有設置這個條件，子層級中是全部的值。
第一層級中設置了默認值，同時儀表板也配置了全局參數，則全局參數透傳過來的值會覆蓋所設的默認值，按照全局參數的值生效。
關聯查詢控件
查詢條件展示類型為下拉列表，且來源于單個數據集時，支持同源級聯與非同源級聯。
查詢條件展示類型為日期選擇，且數據來源于數據集字段時，支持同源級聯與非同源級聯。
說明可配置日期條件與其他類型（下拉、樹形下拉）的同源或非同源級聯。
查詢條件展示類型為樹形下拉時，支持同源級聯，可配置與該樹形下拉同數據集的級聯關系。
查詢條件展示類型為日期選擇時，支持日期級聯，配置日期控件的級聯關系。
說明如果是多個日期控件，且未選擇日期來源的數據集，可以直接配置這多個日期條件間的級聯，但不能和下拉列表等文本類型控件進行級聯。
操作步驟
配置條件級聯關系（同源配置）
假設儀表板中查詢控件A，包含的字段為區域和省份，儀表板中查詢控件B，包含的字段為城市和產品類別。此時，查詢控件A和B的數據均來自同一數據集。您通過關聯控件A中的區域和控件B中的城市字段，實現在控件A選中某區域，則控件B中只會出現該區域下的城市。
在條件級聯配置頁面，單擊新增級聯配置->同源級聯或選中切換至同源級聯。
選擇新增同源級聯配置后，您可以在不改變源級聯關系的情況下，新增級聯關系。
選擇切換至同源級聯后，原級聯關系被改變，且操作不可逆。
選擇查詢控件A中的目標字段區域，并單擊右側的
圖標。
選擇需要與目標字段級聯的條件字段城市。
單擊確定。
此時當您在查詢控件A中選擇區域為西北，在查詢控件B中選擇城市時，可以看到查詢控件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中有多個查詢條件需要關聯，請單擊新增級聯配置，并重復步驟1~2，完成多個條件之間的關聯。
配置完成后，單擊確定。
此時當您在控件A中選擇區域為東北，在控件B中選擇省份時，可以看到控件B中僅出現東北區域下的省份。
日期查詢控件級聯配置
日期級聯
假設儀表板中控件-日期包含的字段為季度、月，您可以通過關聯這兩個日期字段，實現日期級聯效果，比如季度選擇23年第一季度，則月的日期控件中可選擇的篩選月份就只有第一季度的3個月份。
在條件級聯配置頁面上，單擊新增級聯配置，選擇日期級聯。
說明日期級聯的配置項中，可選的條件范圍只有日期類型的查詢控件（單時間和時間區間都可以），時間粒度僅支持年、年季、年月、年周，年月日、年月日時分秒，不包含時、時分、時分秒。
選擇控件-日期中的目標字段季度，并單擊右側的
圖標。
選擇需要與目標字段級聯的條件字段月。
單擊確定。
此時，當您選擇季度為2023年第一季度時，在月中只能篩選2023年1~3月份。
日期控件和其他控件互相級聯
僅日期查詢控件數據來源選擇數據集字段時，支持和下拉列表互相級聯。
以同源配置為例，實現日期控件級聯其他控件。
在條件級聯配置頁面，單擊新增級聯配置->同源級聯或選中切換至同源級聯。
選擇新增同源級聯配置后，您可以在不改變源級聯關系的情況下，新增級聯關系。
選擇切換至同源級聯后，原級聯關系被改變，且操作不可逆。
選擇控件C中的目標字段運輸日期，并單擊右側的
圖標。
選擇需要與目標字段級聯的條件字段區域。
單擊確定。
此時當您選擇日期為2023-04-01，再選擇區域時，可以篩選2023年4月1日對應的區域。
以非同源配置為例，實現其他控件級聯日期控件。
在條件級聯配置頁面，單擊新增級聯配置->非同源級聯。
在條件級聯配置頁面的級聯配置項區域，選擇控件D中的目標字段促銷活動，并單擊右側的
圖標。
在添加的級聯配置項對應的配置框中，進行以下配置。
選擇需要與目標字段級聯的條件字段日期。
此時您選擇條件字段時，在下拉框中可能會出現多個日期，您需要選擇與之關聯的控件下的條件字段。
選擇關聯字段。
說明此處所選的關聯字段必須為省份這個查詢條件來源的數據集中接收上層條件傳值的字段。例如，此處上層級為促銷活動，下層級為日期，選擇的促銷活動字段就是接收促銷活動傳值的字段。
配置完成后，單擊確定。
此時當您在選擇促銷活動為春節活動，可以篩選春節活動對應的日期。
說明其他控件級聯日期控件時，日期控件中可選的范圍是數據集中有春節活動這個值的所有日期。
比如春節活動有3條數據，分別是春節活動，2024-02-05；春節活動，2024-02-10；春節活動，2024-02-17，那這個可選的范圍是2024-02-05~2024-02-17這一整個連續的范圍。
修改條件級聯配置
您可以通過以下操作，修改已配置的條件級聯關系。
級聯配置項重命名。
新增級聯配置時，默認命名為級聯配置項，您可以單擊標題區域進行重命名。
刪除級聯配置項
你可以在已添加的條件上方單擊刪除圖標，刪除該條件。也可以單擊級聯配置項右側的刪除圖標，刪除該配置項。
