範本參數

1.1 應用場景

範本參數是只適用於當前報表的參數。

配合參數面板元件設定可實現參數查詢。

參數可以在定義公式時被引用，實現資料過濾。

1.2 功能簡介

正文框中輸入「華東」，點選查詢，只查詢出報表中華東地區的銷售資訊。

正文框中輸入「華北」，點選查詢，只查詢出報表中華北地區的銷售資訊。

注：範本參數預設值不支援 Value 函式。

2.1 資料準備

建立資料集 ds1，資料庫查詢對話框中寫入 SQL 查詢語句：SELECT * FROM 銷量，取出銷量表中的所有資料。如下圖所示：

2.2 表格樣式設計

1）A1~C1 儲存格寫入表格標題資訊，選中 A1~C1 儲存格，右側屬性面板選擇「儲存格屬性>樣式」，樣式下拉框選擇「預定義樣式」，給標題設定一個「Head」型別的樣式。如下圖所示：

2）將資料集中的欄位拖入到對應儲存格中，選中 A2~C2 儲存格，將字體置中，選中 A1~C2 儲存格，給表格整體新增預定義樣式預設天藍色內外框。如下圖所示：

3）選中 C2 儲存格，右側屬性面板選擇「儲存格元素>基本」，資料設定下拉框選擇「匯總>求和」。如下圖所示：

2.3 定義範本參數

1）菜單欄選擇「範本>範本參數」，彈出範本參數設定對話框。如下圖所示：

2）範本參數對話框點選增加按鈕，建立一個範本參數，雙擊該參數將它重命名為「地區」，設定預設值為字串「華東」。點選確定完成範本參數的定義。如下圖所示：

如果想要修改範本參數名稱，只能透過雙擊原名稱進入編輯狀態後進行修改，修改完後點選「確定」即可，如下圖所示：

設定預設值為 【華東】，預設值字符類型預設為【字串】，預設值可選擇不同字符類型。點擊【確定】，完成範本參數的定義

2.4 參數新增元件

1）點選參數面板的「編輯」按鈕，進入參數面板編輯介面。如下圖所示：

2）右上角元件設定面板會顯示沒有新增元件的參數，點選「地區」或者點選「全部新增」，將參數的預設元件新增到參數面板。如下圖所示：

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

3）參數「地區」的預設元件新增到參數面板後，效果如下圖所示：

注：如果不想點選「全部新增」或「參數」快捷新增預設元件，也可以直接從元件欄中將元件拖曳到參數面板中，修改元件的名稱與參數名稱一緻，即可將元件與參數進行綁定。

4）點選自訂元件的「編輯」按鈕，選擇「正文元件」型別，讓使用者自行輸入參數值。如下圖所示：

5）將查詢按鈕往左邊拖曳，形成緊湊式佈局，讓元件面板更加美觀。再次點選參數面板的「編輯」按鈕，完成參數面板的設定。如下圖所示：

2.5 資料過濾

設定好元件後還不能實現根據正文框中輸入參數值查詢指定地區的銷售資訊。因為表格的資料來源於資料集，資料集中的資料是將資料庫表中的資料全部取出來的，所以需要給表格新增「資料過濾條件」，才可以查詢出元件輸入參數值的資訊。

雙擊 A2 儲存格，在彈出的資料列對話框中選擇「過濾」，新增一個普通條件，設定資料列為地區，運算子為等於，值型別修改為參數型別，選擇 $地區，點選「增加」按鈕，點選「確定」。即將地區儲存格與參數綁定起來。如下圖所示：

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

3.1 PC端

見 1.2 節。

3.2 行動端

App 與 HTML5 端效果相同。

正文框中輸入「華東」，點選查詢，只查詢出報表中華東地區的銷售資訊。

正文框中輸入「華北」，點選查詢，只查詢出報表中華北地區的銷售資訊。

點選下載範本：範本參數.cpt