全部產品
Search
文件中心

Quick BI:配置查詢控制項級聯

更新時間:Jan 21, 2025

查詢控制項的關聯時,例如控制項A中選擇了地區,控制項B中的省份列表就只有控制項A已選定的地區下的省份,則需要配置控制項A和控制項B的關聯關係。您也可以配置同一控制項中幾個條件的關聯關係。本文主要為您介紹如何通過配置條件級聯來關聯查詢控制項。

前提條件

背景資訊

條件級聯用於關聯一個或多個查詢控制項,查詢控制項中的條件支援查詢來源於同一個資料集或不同資料集。

  • 當多個查詢控制項,只要有一個查詢條件的資料集與其他資料集不同,您在關聯條件級聯時,必須選擇非同源配置。

  • 當多個查詢控制項的查詢條件中,選項值來源均為同一個資料集,您在關聯條件級聯時,可以選擇同源配置或非同源配置。

    說明

    同一個資料來源時,選擇同源配置更簡單,並且條件級聯的效果與非同源配置相同。

  • 當需要進行多個日期查詢控制項之間級聯時,您在關聯條件級聯時,可以選擇日期級聯配置。

使用限制

  • 條件級聯配置支援同源配置和非同源配置:

    級聯配置項

    支援的篩選類型

    同源級聯配置

    下拉式清單且來源於單個資料集

    樹形下拉

    日期選擇且來源於資料集欄位

    非同源級聯配置

    下拉式清單且來源於單個資料集

    日期選擇且來源於資料集欄位

    日期級聯配置

    日期選擇

  • 單個級聯配置項最多可配置5個級聯條件,當超過5個條件時,您可以配置多條級聯。

注意事項

  • 上層關係能級聯下層關係,同一層級的條件之間可以建立級聯,不可反向級聯。

    說明
    • 層級關係:全域控制項>Tab內查詢控制項>圖表內查詢控制項,即全域控制項可以級聯全域控制項、Tab內查詢控制項和圖表內查詢控制項;Tab內查詢控可以級聯Tab內查詢控制項、圖表內查詢控制項,不能反向級聯全域控制項;圖表內查詢控制項可以級聯圖表內查詢控制項,不能反向級聯全域控制項和Tab內查詢控制項。

    • 不可反向級聯:假設控制項A包含的欄位為地區和產品類型,設定了地區級聯產品類型後,產品類型不能反向級聯地區。

  • 不同控制項下可能存在相同的欄位,為了便於區分,您可以選中顯示標題並編輯控制項名稱。

    image

  • 當隱藏級聯條件中的查詢條件時,除了隱藏第一層級時級聯配置會保留,其餘情況級聯配置都會清空。

  • 設定級聯條件後,如果隱藏查詢條件中的第一層級,則:

    • 第一層級設定了預設值,按照預設值生效,子層級中的可選項來源於預設值的下一層。

      例如,級聯條件為地區省份城市區縣地區的預設值為華東,則城市區縣的可選項來源於預設值華東下的省份

    • 第一層級沒有設定預設值,可選項來源於全域參數傳過來的值,則按照全域參數的值生效。

    • 第一層級沒有設定預設值也沒有全域參數傳值,隱藏後也無法選擇第一層級的值,那麼相當於沒有設定這個條件,子層級中是全部的值。

      46.gif

    • 第一層級中設定了預設值,同時儀表板也配置了全域參數,則全域參數透傳過來的值會覆蓋所設的預設值,按照全域參數的值生效。

關聯查詢控制項

  • 查詢條件展示類型為下拉式清單,且來源於單個資料集時,支援同源級聯非同源級聯

    image

  • 查詢條件展示類型為日期選擇,且資料來源於資料集欄位支援同源級聯非同源級聯

    說明

    可配置日期條件與其他類型(下拉、樹形下拉)的同源或非同源級聯。

    image

  • 查詢條件展示類型為樹形下拉時,支援同源級聯,可配置與該樹形下拉同資料集的級聯關係。

    image

  • 查詢條件展示類型為日期選擇時,支援日期級聯,配置日期控制項的級聯關係。

    說明

    如果是多個日期控制項,且未選擇日期來源的資料集,可以直接配置這多個日期條件間的級聯,但不能和下拉式清單等文本類型控制項進行級聯。

    image

操作步驟

  1. 在儀表板編輯頁面,按照下圖指引,進入條件級聯頁面。

    image

    您也可以在查詢條件設定介面,單擊條件級聯配置,進入條件級聯頁面。

    image

    進入條件級聯配置頁面。

    image

  2. 配置條件級聯。

    • 當多個查詢控制項的查詢條件中,選項值來源均為同一個資料集,您在關聯條件級聯時,推薦選擇同源配置

    • 當多個查詢控制項,只要有一個查詢條件的資料集與其他資料集不同,您在關聯條件級聯時,需要選擇非同源配置

    • 當查詢條件展示類型為日期選擇時:

      • 如果是多個日期控制項,且未選擇日期來源的資料集,您可以直接配置這多個日期條件間的級聯,請參見本文日期查詢控制項級聯配置日期級聯部分的內容。

      • 如果是單個日期和下拉式清單等文本型控制項,支援同源或者非同源級聯。

配置條件級聯關係(同源配置)

假設儀表板中查詢控制項A,包含的欄位為地區和省份,儀表板中查詢控制項B,包含的欄位為城市和產品類別。此時,查詢控制項A和B的資料均來自同一資料集。您通過關聯控制項A中的地區和控制項B中的城市欄位,實現在控制項A選中某地區,則控制項B中只會出現該地區下的城市。

  1. 條件級聯配置頁面,單擊新增級聯配置->同源級聯或選中切換至同源級聯

    image

    • 選擇新增同源級聯配置後,您可以在不改變源級聯關係的情況下,新增級聯關係。

    • 選擇切換至同源級聯後,原級聯關係被改變,且操作無法復原。

  2. 選取查詢控制項A中的目標欄位地區,並單擊右側的添加表徵圖。

    image

  3. 選擇需要與目標欄位級聯的條件欄位城市

    image

  4. 單擊確定

    此時當您在查詢控制項A中選擇地區西北,在查詢控制項B中選擇城市時,可以看到查詢控制項B中僅出現西北地區下的城市。

    Untitled.gif

配置條件級聯關係(非同源配置)

假設儀表板中控制項A,包含的欄位為地區和產品類型,儀表板中控制項B,包含的欄位為省份和產品小類。此時,控制項A和B的資料來自不同資料集。您通過關聯控制項A中的地區和控制項B中的省份欄位,實現在控制項A選中某地區,則控制項B中只會出現該地區下的省份。

  1. 條件級聯配置頁面的級聯配置項地區,選擇目標欄位地區,並單擊右側的添加表徵圖。

    image

  2. 在添加的級聯配置項對應的配置框中,進行以下配置。

    1. 選擇需要與目標欄位級聯的條件欄位地區

      此時您選擇條件欄位時,在下拉框中可能會出現多個省份,您需要選擇與之關聯的控制項下的條件欄位。

      image

    2. 選擇關聯欄位。

      • 此處所選的關聯欄位必須為省份這個查詢條件來源的資料集中接收上層條件傳值的欄位。例如,此處上層級為地區,下層級為省份,選擇的area欄位就是接收地區傳值的欄位。

        image

      • 關聯欄位支援選擇維度運算式值預留位置值預留位置。其中,預留位置的傳值邏輯如下:

        查詢控制項類型

        查詢方式

        值預留位置

        運算式預留位置

        日期篩選

        單時間:

        如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)}' 。

        預留位置的具體使用方法請參見預留位置

  3. (可選)

    如果控制項A和B中有多個查詢條件需要關聯,請單擊新增級聯配置,並重複步驟1~2,完成多個條件之間的關聯。

    image

  4. 配置完成後,單擊確定

    此時當您在控制項A中選擇地區東北,在控制項B中選擇省份時,可以看到控制項B中僅出現東北地區下的省份。

    image

日期查詢控制項級聯配置

日期級聯

假設儀表板中控制項-日期包含的欄位為季度、月,您可以通過關聯這兩個日期欄位,實現日期級聯效果,比如季度選擇23年第一季度,則月的日期控制項中可選擇的篩選月份就只有第一季度的3個月份。

  1. 條件級聯配置頁面上,單擊新增級聯配置,選擇日期級聯

    image

    說明

    日期級聯的配置項中,可選的條件範圍只有日期類型的查詢控制項(單時間和時間區間都可以),時間粒紋僅支援年、年季、年月、年周,年月日、年月日時分秒,不包含時、時分、時分秒。

  2. 選擇控制項-日期中的目標欄位季度,並單擊右側的添加表徵圖。

    image

  3. 選擇需要與目標欄位級聯的條件欄位

    image

  4. 單擊確定

    此時,當您選擇季度為2023年第一季度時,在月中只能篩選2023年1~3月份。

    image

日期控制項和其他控制項互相級聯

僅日期查詢控制項資料來源選擇資料集欄位時,支援和下拉式清單互相級聯。

  • 以同源配置為例,實現日期控制項級聯其他控制項。

    1. 條件級聯配置頁面,單擊新增級聯配置->同源級聯或選中切換至同源級聯

      image

      • 選擇新增同源級聯配置後,您可以在不改變源級聯關係的情況下,新增級聯關係。

      • 選擇切換至同源級聯後,原級聯關係被改變,且操作無法復原。

    2. 選擇控制項C中的目標欄位運輸日期,並單擊右側的添加表徵圖。

      image

    3. 選擇需要與目標欄位級聯的條件欄位地區

      image

    4. 單擊確定

      此時當您選擇日期2023-04-01,再選擇地區時,可以篩選2023年4月1日對應的地區。

      image

  • 以非同源配置為例,實現其他控制項級聯日期控制項。

    1. 條件級聯配置頁面,單擊新增級聯配置->非同源級聯。

      image

    2. 條件級聯配置頁面的級聯配置項地區,選擇控制項D中的目標欄位促銷活動,並單擊右側的添加表徵圖。

      image

    3. 在添加的級聯配置項對應的配置框中,進行以下配置。

      1. 選擇需要與目標欄位級聯的條件欄位日期

        此時您選擇條件欄位時,在下拉框中可能會出現多個日期,您需要選擇與之關聯的控制項下的條件欄位。

        image

      2. 選擇關聯欄位。

        說明

        此處所選的關聯欄位必須為省份這個查詢條件來源的資料集中接收上層條件傳值的欄位。例如,此處上層級為促銷活動,下層級為日期,選擇的促銷活動欄位就是接收促銷活動傳值的欄位。

        image

    4. 配置完成後,單擊確定

      此時當您在選擇促銷活動春節活動,可以篩選春節活動對應的日期。

      image

      說明

      其他控制項級聯日期控制項時,日期控制項中可選的範圍是資料集中有春節活動這個值的所有日期。

      比如春節活動有3條資料,分別是春節活動,2024-02-05;春節活動,2024-02-10;春節活動,2024-02-17,那這個可選的範圍是2024-02-05~2024-02-17這一整個連續的範圍。

修改條件級聯配置

您可以通過以下操作,修改已配置的條件級聯關係。

  • 級聯配置項重新命名。

    新增級聯配置時,預設命名為級聯配置項,您可以單擊標題區進行重新命名。

    image

  • 刪除級聯配置項

    你可以在已添加的條件上方單擊刪除表徵圖,刪除該條件。也可以單擊級聯配置項右側的刪除表徵圖,刪除該配置項。

    image