模板參數

1.1 在線視頻

在線視頻學習請查看：參數入門示例。

1.2 應用場景

模板參數是只适用於當前報表的參數，需要與數據列的過濾條件結合使用。即先通過數據集取出所有數據，再在報表中設置模板參數，在數據查詢時使用模板參數過濾出有用的數據，适用於數據量小的情況。數據量大的情況，建議使用數據集參數進行過濾。

1.3 功能簡介

文本框中輸入「華東」，點擊查詢，只查詢出報表中華東地區的銷售信息。

文本框中輸入「華北」，點擊查詢，只查詢出報表中華北地區的銷售信息。

2.1 數據準備

新建數據集 ds1，數據庫查詢對話框中寫入 SQL 查詢語句：SELECT * FROM 銷量，取出銷量表中的所有數據。

2.2 表格樣式設計

1）A1~C1 單元格寫入表格标題信息，選中 A1~C1 單元格，右側屬性面板選擇「單元格屬性>樣式」，樣式下拉框選擇「預定義樣式」，給标題設置一個「Head」類型的樣式。

注：設置好 Head 類型的樣式後，标題字體會自動居中，無需另外設置。

2）将數據集中的字段拖入到對應單元格中，選中 A2~C2 單元格，将字體居中，選中 A1~C2 單元格，給表格整體添加預定義樣式默認的天藍色内外框。

3）選中 C2 單元格，右側屬性面板選擇「單元格元素>基本」，數據設置下拉框選擇「彙總>求和」。

2.3 定義模板參數

1）菜單欄選擇「模板>模板參數」，彈出模板參數設置對話框。

2）模板參數對話框點擊增加按鈕，新建一個模板參數，雙擊該參數将它重命名爲「地區」，設置默認值爲字符串「華東」。點擊确定完成模板參數的定義。

如果想要修改模板參數名稱，只能通過雙擊原名稱進入編輯狀态後進行修改，修改完後點擊「确定」即可，如下圖所示：

2.4 參數添加控件

1）點擊參數面板的「編輯」按鈕，進入參數面板編輯界面。

2）右上角控件設置面板會顯示沒有添加控件的參數，點擊「地區」或者點擊「全部添加」，将參數的默認控件添加到參數面板。

注：參數與控件是通過參數名稱進行綁定的，也就是說當控件名稱與參數名稱一緻時，參數與控件就進行了綁定，即在 Web 端給控件賦值就相當於給參數賦值。

3）參數「地區」的默認控件添加到參數面板後，效果如下圖所示：

注：如果不想點擊「全部添加」或「參數」快捷添加默認控件，也可以直接從控件欄中将控件拖拽到參數面板中，修改控件的名稱與參數名稱一緻，即可将控件與參數進行綁定。

4）點擊自定義控件的「編輯」按鈕，選擇「文本控件」類型，讓用戶自行輸入參數值。

5）将查詢按鈕往左邊拖拽，形成緊湊式布局，讓控件面板更加美觀。再次點擊參數面板的「編輯」按鈕，完成參數面板的設置。

2.5 數據過濾

設置好控件後還不能實現根據文本框中輸入的參數值查詢指定地區的銷售信息。因爲表格的數據來源於數據集，數據集中的數據是将數據庫表中的數據全部取出來的，所以需要給表格添加「數據過濾條件」，才可以查詢出控件輸入的參數值的信息。

雙擊 A2 單元格，在彈出的數據列對話框中選擇「過濾」，添加一個普通條件，設置數據列「地區等於參數 $地區」，點擊增加按鈕，點擊确定。即将地區單元格與參數綁定起來。

注：參數爲空時，查詢數據爲空，若要參數爲空時查詢全部數據，可參考文檔下拉框參數爲空選擇全部。

1）PC端

保存報表，點擊「分頁預覽」。

文本框中輸入「華東」，點擊查詢，只查詢出報表中華東地區的銷售信息。

文本框中輸入「華北」，點擊查詢，只查詢出報表中華東地區的銷售信息。

2）移動端

移動端查看報表的方式參見 報表移動端預覽。

文本框中輸入「華東」，點擊查詢，只查詢出報表中華東地區的銷售信息。

文本框中輸入「華北」，點擊查詢，只查詢出報表中華東地區的銷售信息。

已完成模板可參見：%FR_HOME%\webroot\WEB-INF\reportlets\demo\NewbieGuide\模板參數.cpt

點擊下載模板：模板參數.cpt