前提條件

已創(chuàng)建好儀表板。請(qǐng)參見新建儀表板和可視化圖表概述。

背景信息

查詢條件生效模式包含以下兩種：

• 拖拽字段并自動(dòng)生成查詢條件。

  通過拖拽某個(gè)字段至查詢控件，可以快捷生成查詢條件。請(qǐng)參見快捷添加查詢條件。

  

• 為字段設(shè)置自定義查詢條件。

  自動(dòng)查詢條件不滿足您當(dāng)前訴求時(shí)，您可以選擇自定義設(shè)置查詢條件配置項(xiàng)。請(qǐng)參見自定義設(shè)置查詢條件。

  

快捷添加查詢條件

通過拖拽某個(gè)字段至查詢控件，可以快捷生成查詢條件。

1. 在儀表板編輯區(qū)域，單擊頂部菜單欄的添加查詢控件，下拉框中選擇查詢控件。

   

2. 在右側(cè)的數(shù)據(jù)區(qū)域， 拖拽目標(biāo)字段至查詢控件中。

   系統(tǒng)會(huì)基于字段類型生成合適展示類型的查詢控件。

   

   • 若儀表板的圖表和查詢控件歸屬同一數(shù)據(jù)集，則拖拽目標(biāo)字段至查詢控件后，會(huì)自動(dòng)關(guān)聯(lián)同數(shù)據(jù)集的所有圖表。創(chuàng)建條件后如果繼續(xù)新增同數(shù)據(jù)集下的圖表，也會(huì)自動(dòng)關(guān)聯(lián)上。

     

   • 若儀表板的圖表和查詢控件歸屬不同數(shù)據(jù)集，則拖拽目標(biāo)字段至查詢控件后，不會(huì)自動(dòng)關(guān)聯(lián)不同數(shù)據(jù)集的圖表。

     

     此時(shí)，若您需要關(guān)聯(lián)非同數(shù)據(jù)集的圖表，可以切換到自定義模式。

     

     配置查詢條件的操作請(qǐng)參見配置查詢控件樣式。

3. 選擇查詢目標(biāo)值并單擊查詢。

   

   配置完成后，您可以修改查詢控件的樣式，請(qǐng)參見配置查詢控件樣式。

自定義設(shè)置查詢條件

下面以添加自定義查詢條件（即生效模式為自定義）為例介紹。

1. 在儀表板編輯區(qū)域，在頂部菜單欄單擊查詢控件圖標(biāo)，并配置查詢控件。

   • 入口一：

     

   • 入口二：

     

   • 入口三：

     

2. 在查詢條件設(shè)置頁面，完成以下三部分內(nèi)容的設(shè)置。

   1. 查詢條件

      當(dāng)您在查詢條件區(qū)域單擊圖標(biāo)，新增查詢條件時(shí)，默認(rèn)名稱為未命名，您可以輸入查詢條件名稱。

      

      說明

      • 輸入查詢條件名稱后離開該區(qū)域命名即生效。

      • 查詢條件可通過圖標(biāo)隱藏，隱藏后配置內(nèi)容保留，在儀表板中不再顯示。

      • 單擊圖標(biāo)，重命名或刪除查詢條件。

   2. 關(guān)聯(lián)圖表及字段

      選中要關(guān)聯(lián)的圖表并選擇關(guān)聯(lián)的字段，可開啟字段智能選入功能，同數(shù)據(jù)集下所選圖表的關(guān)聯(lián)字段將被自動(dòng)填入。如果圖表過多，可通過篩選功能選擇需要的圖表。

      

      不支持不同類型的字段同時(shí)關(guān)聯(lián)，如下圖中同時(shí)關(guān)聯(lián)日期類型和數(shù)值類型字段，會(huì)有以下提示。

      

   3. 查詢條件配置

      查詢條件配置因選擇關(guān)聯(lián)字段的類型不同而不同，以下為時(shí)間類型字段年粒度的查詢條件配置，更多類型配置詳情請(qǐng)參見查詢類型配置展示。

      當(dāng)開啟日期前后快捷切換功能時(shí)，則報(bào)表頁面對(duì)應(yīng)的日期控件處會(huì)新增一個(gè)快捷箭頭，單擊可以快速切換年份，效果圖如下。

      

   4. 條件級(jí)聯(lián)配置

      請(qǐng)參見配置查詢控件級(jí)聯(lián)。

配置查詢條件組

當(dāng)您添加了多個(gè)同個(gè)類型的查詢控件時(shí)，如添加了日期類型的控件統(tǒng)計(jì)時(shí)間和新建時(shí)間，您可以通過配置查詢條件組進(jìn)行關(guān)聯(lián)，通過切換方式選擇當(dāng)前需要生效的控件。

操作步驟

1. 您已按照上述說明配置完成日期選擇類型控件統(tǒng)計(jì)時(shí)間和新建時(shí)間，如下。

   

2. 單擊左側(cè)新建查詢條件右側(cè)的圖標(biāo)，下拉列表中選擇條件組。

   

   說明

   1. 添加條件組后，可直接拖拽單個(gè)條件至條件組內(nèi)。

   2. 條件組內(nèi)的條件只有一個(gè)會(huì)生效，默認(rèn)為第一個(gè)條件，可在報(bào)表內(nèi)切換選擇組內(nèi)生效的條件。不生效的條件即使有默認(rèn)值或者全局參數(shù)傳入也不生效。

3. 您可以自定義命名條件組為時(shí)間查詢，命名完成后拖拽條件統(tǒng)計(jì)時(shí)間和新建時(shí)間至時(shí)間查詢條件組內(nèi)，即完成條件組的配置，如下。

   

配置效果

配置完成后，您可以看到時(shí)間查詢條件組中默認(rèn)生效第一個(gè)條件新建時(shí)間，支持切換操作生效條件統(tǒng)計(jì)時(shí)間進(jìn)行查詢。

查詢類型配置展示

查詢控件可同時(shí)作用于同類型參數(shù)、占位符和普通字段。

下面主要為您介紹以下展示類型所進(jìn)行的配置。

• 日期選擇

  一旦關(guān)聯(lián)了日期類型的字段，查詢控件會(huì)自動(dòng)推薦日期選擇作為展示類型，同時(shí)根據(jù)所關(guān)聯(lián)的不同粒度的日期字段來推薦時(shí)間粒度。目前支持多種時(shí)間粒度，例如年、年-季度、年-月、年-周、年-月-日、年-月-日-時(shí)-分-秒、時(shí)、時(shí)-分和時(shí)-分-秒。

  本例中，選擇的時(shí)間粒度為年。當(dāng)篩選方式為年區(qū)間時(shí)，區(qū)間類型包含開始于、結(jié)束于、時(shí)間區(qū)間和快捷區(qū)間。

  在區(qū)間范圍的篩選方式中，開始于、結(jié)束于兩種區(qū)間類型選項(xiàng)，不需要填寫完整的起止時(shí)間也能發(fā)起查詢。

  您可以給不同的時(shí)間粒度定制快捷區(qū)間，對(duì)應(yīng)關(guān)系如下。

  時(shí)間粒度	快捷區(qū)間
  年	去年 今年 基于昨日（不含今天） 本年（基于昨日）
  年-季度	本季度 上個(gè)季度 基于昨日（不含今天） 本季度（基于昨日） 本年（基于昨日）
  年-月	本月 上個(gè)月 最近3個(gè)月 最近6個(gè)月 最近12個(gè)月 今年上半年 今年下半年 年初至上月 年初至本月 基于昨日（不含今天） 本月（基于昨日） 本季度（基于昨日） 本年（基于昨日）
  年-周	本周 上周 基于昨日（不含今天） 本周（基于昨日） 本月（基于昨日） 本季度（基于昨日） 本年（基于昨日）
  年-月-日	今天 昨天 前天 年初至今 月初至今 最近7天 最近15天 最近30天 最近60天 上周 上個(gè)月 最近（不包含今天） 最近7天 最近15天 最近30天 最近60天 基于昨日（不含今天） 本周 本月 本季度 本年 最近星期幾 最近星期一 最近星期二 最近星期三 最近星期四 最近星期五 最近星期六 最近星期日 其他 本月就一天 上個(gè)月第一天 上個(gè)月最后一天
  時(shí)、時(shí)-分、時(shí)-分-秒	不支持快捷區(qū)間功能

  日期查詢字段更多應(yīng)用請(qǐng)參見日期查詢。

• 數(shù)值輸入框

  當(dāng)關(guān)聯(lián)字段為度量時(shí)，可以在查詢控件中選擇聚合方式，默認(rèn)為求和，也可以選擇無聚合或其他聚合方式。

  說明

  聚合查詢控件無法查詢明細(xì)數(shù)據(jù)。在條件形式中，您可以選擇不同的展現(xiàn)形式，可以選擇單個(gè)條件和且或條件。如果想讓報(bào)表的預(yù)覽者只能使用固定的條件形式如只可以使用等于的條件，則需要選中鎖定篩選條件。

  

  數(shù)值查詢字段更多應(yīng)用請(qǐng)參見數(shù)值查詢。

• 文本輸入框

  與數(shù)值輸入框類似，文本框可以選擇條件形式為單條件、或條件、且條件。

  為product_sub_type字段設(shè)定默認(rèn)值時(shí)，規(guī)則及對(duì)應(yīng)SQL語法關(guān)系如下：

  規(guī)則	SQL語法
  精確匹配	product_sub_type='尺子'
  不匹配	product_sub_type!='尺子'
  包含	product_sub_type like '%尺子%'
  不包含	product_sub_type not like '%尺子%'
  開頭是	product_sub_type like '尺子%'
  結(jié)尾是	product_sub_type like '%尺子'
  為空	product_sub_type is null
  不為空	product_sub_type is not null
  空文本	product_sub_type=''
  不為空文本	product_sub_type!=''

  文本類型字段更多應(yīng)用請(qǐng)參見文本查詢。

• 下拉列表（原枚舉篩選）

  當(dāng)展示類型為下拉列表（原枚舉篩選）時(shí)，選項(xiàng)值來源為查詢條件字段可供選擇的篩選值，支持自動(dòng)解析、單個(gè)數(shù)據(jù)集、手工輸入三種方式。

  • 當(dāng)選項(xiàng)值來源為自動(dòng)解析時(shí)，自動(dòng)解析左側(cè)關(guān)聯(lián)圖表區(qū)域選中的字段值的合集，界面僅展示1000條。

    當(dāng)選擇查詢方式為多選、查詢時(shí)間為點(diǎn)擊查詢時(shí)，選中設(shè)定篩選默認(rèn)值并配置默認(rèn)值。

    在字段頁面，您可以進(jìn)行以下操作：

    • 在搜索框輸入關(guān)鍵字，并單擊下方關(guān)鍵字，將左側(cè)目標(biāo)字段值添加到右側(cè)的已添加列表中。

    • 單擊添加左側(cè)全部字段值，將左側(cè)全部字段值添加到右側(cè)的已添加列表中。

    • 勾選左側(cè)字段值，將選中的字段值添加到右側(cè)的已添加列表中。

    • 單擊排除，添加到右側(cè)的已添加列表中的字段值被排除。

      說明

      • 如果您配置默認(rèn)值時(shí)選擇排除該字段值，又將下拉列表的樣式切換為平鋪，則在查詢控件中選擇該字段值，表示排除該字段。

      • 如果您先配置的平鋪樣式，又在配置默認(rèn)值時(shí)選擇排除該字段值，則將普通平鋪樣式替換成平鋪排除的樣式。

    • 單擊清空，添加到右側(cè)的已添加列表中的字段值被清空。

      

  • 當(dāng)選項(xiàng)值來源為單個(gè)數(shù)據(jù)集時(shí)，選擇當(dāng)前儀表板所在空間內(nèi)的所有數(shù)據(jù)集，推薦的數(shù)據(jù)集為關(guān)聯(lián)圖表來源的數(shù)據(jù)集。圖表中關(guān)聯(lián)字段和單個(gè)數(shù)據(jù)集中查詢值字段以及顯示名稱字段的關(guān)系如下。

    • 關(guān)聯(lián)圖表及字段為查詢條件中待關(guān)聯(lián)的圖表和字段。

    • 查詢值字段為選項(xiàng)值來源數(shù)據(jù)集中要與關(guān)聯(lián)字段匹配的字段。

    • 顯示名稱字段為選項(xiàng)值來源數(shù)據(jù)集中要進(jìn)行篩選的字段，即查詢控件中顯示的字段。

      說明

      • 當(dāng)顯示名稱字段與查詢值字段一致時(shí)，選擇查詢值字段后，系統(tǒng)將自動(dòng)填入顯示名稱字段。

      • 當(dāng)顯示名稱字段與查詢值字段不一致時(shí)，需要手動(dòng)修改顯示名稱字段。

    • 排序字段：根據(jù)選定字段進(jìn)行排序，排序方式支持升序、降序及自定義排序。當(dāng)選擇自定義排序時(shí)，您可以在自定義排序彈窗中，通過拖拽的方式組織字段值的排列順序。

      說明

      該項(xiàng)為可選項(xiàng)，不選擇排序字段時(shí)則默認(rèn)按照數(shù)據(jù)集中原有的順序排序。

      

    • 查詢時(shí)間：支持點(diǎn)擊查詢和預(yù)先查詢。

      • 點(diǎn)擊查詢：默認(rèn)值。當(dāng)觸發(fā)查詢按鈕時(shí)，啟動(dòng)條件查詢。

      • 預(yù)先查詢：Quick BI v3.12.1版本新功能。打開儀表板后預(yù)先查詢下拉列表的內(nèi)容值，能夠按照行級(jí)權(quán)限的配置展示各個(gè)賬號(hào)對(duì)應(yīng)的下拉列表值，且每個(gè)人的默認(rèn)值也會(huì)根據(jù)對(duì)應(yīng)行級(jí)權(quán)限的配置而有所不同。

        預(yù)先查詢適用于目標(biāo)數(shù)據(jù)集已配置行級(jí)權(quán)限且數(shù)據(jù)量較小的場(chǎng)景，否則會(huì)影響整體報(bào)表加載時(shí)間。

  • 當(dāng)選項(xiàng)值來源為手工輸入時(shí)，需要通過單擊圖標(biāo)，在手工錄入頁面，手工輸入查詢值字段和顯示名稱字段：

    • 當(dāng)?shù)谝淮芜M(jìn)行手工錄入且查詢值與顯示名稱一致時(shí)，需要輸入查詢值并單擊確定后，系統(tǒng)會(huì)自動(dòng)輸入顯示名稱。

    • 當(dāng)?shù)谝淮芜M(jìn)行手工錄入且查詢值與顯示名稱不一致時(shí)，需要手工輸入查詢值和顯示名稱。

    • 當(dāng)非第一次進(jìn)行手工錄入時(shí)，新增查詢值和顯示名稱均需手工輸入。只輸入查詢值會(huì)收到以下提示。

      

• 樹形下拉

  當(dāng)展示類型為樹形下拉時(shí)，選擇數(shù)據(jù)集支持同數(shù)據(jù)集和非同數(shù)據(jù)集，展示形式支持樹形展示和平鋪展示，查詢方式支持單選和多選，查詢時(shí)間支持點(diǎn)擊查詢和預(yù)先查詢。

  說明

  樹形結(jié)構(gòu)最多支持10層。

  • 樹形單選展示

  • 樹形多選展示

  • 快捷關(guān)聯(lián)功能默認(rèn)開啟，通過該功能可以為樹形結(jié)構(gòu)的子層級(jí)自動(dòng)選入同數(shù)據(jù)集下的關(guān)聯(lián)圖表及字段。單擊樹形結(jié)構(gòu)中的關(guān)聯(lián)圖表，或單擊左側(cè)查詢項(xiàng)中子層級(jí)的名稱，為樹形結(jié)構(gòu)的子層級(jí)關(guān)聯(lián)其他數(shù)據(jù)集下的圖表和字段。例如，下圖中設(shè)置第二層級(jí)省份進(jìn)行關(guān)聯(lián)圖表及字段時(shí)，同數(shù)據(jù)集的圖表柱圖和餅圖的關(guān)聯(lián)字段可以自動(dòng)選入，非同數(shù)據(jù)集的圖表指標(biāo)看板的關(guān)聯(lián)字段需要手動(dòng)錄入。

  • 移動(dòng)端樹形下拉支持清空，您可以在移動(dòng)端每一層點(diǎn)擊清空按鈕清空篩選條件。

    

記住查詢條件

• 支持報(bào)表級(jí)別記住查詢條件。勾選后，系統(tǒng)默認(rèn)記住上一次查詢條件。

• 報(bào)表級(jí)別的設(shè)置受到組織級(jí)別配置的影響。

  • 當(dāng)報(bào)表配置里勾選了記住查詢條件時(shí)，頁面設(shè)置的勾選記住查詢條件置灰，不支持取消勾選。

    

  • 當(dāng)報(bào)表配置里未勾選記住查詢條件時(shí)，報(bào)表級(jí)別的頁面設(shè)置可以根據(jù)實(shí)際需要單獨(dú)設(shè)置是否記住查詢條件。