元件篩選查詢

1.1 預期效果

參數最主要的應用就是結合元件，實現資料篩選過濾。如下圖所示：

那如何將參數和元件結合到一起，實現參數過濾呢？

1.2 實現思路

首先必須明確，參數和元件並非一個概念，但兩者在綁定的情況下，就可以相互傳值，參數值即為元件值，元件值即為參數值，所以就會產生參數和元件看起來是一樣的錯覺。

實現資料篩選過濾，即先將參數和元件綁定，元件選擇值後傳遞給參數，報表根據參數值過濾出資料。參數和元件各司其職，元件負責選擇值、參數負責過濾資料。

根據定義方法，參數可以分成資料集參數和範本參數，所以實現資料篩選查詢，也對應兩種方法，資料集參數方法和範本參數方法。

2.1 資料集參數

資料集參數 是定義在 SQL 語句中的參數，即在 SQL 查詢資料時，就實現了資料的過濾。如果你的資料是從資料庫查詢獲得，推薦使用此方法。

2.1.1 定義資料集參數

透過資料集參數實現資料篩選過濾時，首先要定義一個資料集參數。如：SELECT * FROM 銷量 where 地區 = '${area}' 就定義了一個資料集參數 area。如下圖所示：

2.1.2 新增過濾元件

定義好資料集參數後，如果要在頁面實現資料過濾查詢，就必須要有一個元件。根據想要的過濾形式選擇元件即可，這裏我們選擇一個「下拉框」元件。

如下圖所示，在參數面板新增了一個下拉框元件，併為為其綁定 数据字典 ，即設定「下拉框」的選項值為「銷量」表的「地區」欄位。如下圖所示：

注意：新增元件後，一般需要新增一個「查詢按鈕」，直接從元件區域拖曳新增到參數面板即可。

2.1.3 綁定參數和元件

以上準備好了元件和參數，只要兩者綁定即可實現資料過濾。參數和元件的綁定方式非常簡單，名稱一致即為綁定，這裏參數值已經確定，所以只需要將元件名稱改為參數值即可。如下圖所示：

但一般情況下新增了參數後，參數面板預設會顯示出新增的參數，方便使用者將其與元件綁定。如下圖所示：

點選參數即可將其新增在參數面板上，點選新增後預設新增一組過濾元件，分別為一個「標籤元件」、一個「查詢按鈕」和一個未定義元件，使用者根據需要給未定義元件選擇類型即可。如下圖所示：

自動新增後，元件名和參數名是一致的，即已經實現了綁定，就不需要再修改名稱了。但元件還需要設定資料字典，具體方法參考 数据字典。

2.1.4 設計報表實現過濾

將資料集拖到報表中，設計報表，如下圖所示：

儲存範本，點選預覽，area 元件選擇不同的值，也就對應着 area 參數為不同的值，area 參數值不同，資料 SQL 語句就不同，則查詢出的資料也就不同，這樣就實現了資料過濾查詢。如下圖所示：

2.2 範本參數

模板参数 實現資料篩選查詢和資料集參數不同，資料集參數是在從資料庫中查詢資料時就實現了過濾，而範本參數是將資料欄新增在儲存格中後再過濾，適合內建資料集或者檔案資料集使用。

2.2.1 定義範本參數

這裏相當於提前定義好一個參數，參數可以是 模板参数、全局参数、系统参数。差別在於全局參數所有範本都可以用，系統參數不用再定義。若你定義了一個全局參數想要實現過濾，或者想要透過系統參數過濾，也可以參考此方法。

定義一個範本參數 area。如下圖所示：

2.2.2 新增過濾元件

定義好參數後，如果要在頁面實現資料過濾查詢，就必須要有一個元件。根據想要的過濾形式選擇元件即可，這裏我們選擇一個「下拉框」元件。

新增方法同 2.1.2 節。

2.2.3 綁定參數和元件

以上準備好了元件和參數，只要兩者綁定即可實現資料過濾。綁定方法參考 2.1.3 節。

注：系統參數預設不會出現在參數面板中，使用者不能透過快捷方式新增。

2.2.4 新增過濾條件

建立資料集，SQL 語句為：SELECT * FROM 銷量，即預設查詢銷量表中所有資料。將資料欄新增到儲存格中，並設定報表樣式，如下圖所示：

這時預設是所有資料，如果要實現查詢，就必須新增過濾條件，雙擊 A2 儲存格，為其新增過濾條件。過濾條件為地區這一欄的值等於參數 area。如下圖所示：

這樣就實現了過濾，儲存範本，點選預覽，area 元件選擇不同的值，也就對應着 area 參數為不同的值，area 參數值不同，報表中過濾條件就不同，則查詢出的資料也就不同，這樣就實現了資料過濾查詢。如下圖所示：