範本參數

1.1 應用場景

希望使用範本參數綁定元件，實現參數查詢的效果。

例如，正文框中輸入具體地區，則查詢出具體地區的資料。

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

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

1.2 功能簡介

1）範本參數是只適用於當前報表的參數，需要與資料欄的過濾條件結合使用。

2）範本參數適用於資料量小的情況，先透過資料集取出所有資料，再在報表中設定範本參數，在資料查詢時使用範本參數過濾出有用的資料。

注1：資料量大的情況，建議使用 資料集參數 進行過濾。

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

2.1 建立範本

建立一張普通報表。如下圖所示：

2.2 準備資料

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

2.3 設計報表

1）A1~C1 儲存格輸入正文，A2~C2 儲存格拖入相應的資料欄，設計報表樣式，如下圖所示：

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

2.4 定義範本參數

1）點選菜單欄「範本>範本參數」，彈出範本參數設定對話框。點選增加按鈕，建立一個範本參數，雙擊該參數將它重新命名為：地區，設定預設值為字串：華東。如下圖所示：

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

2.5 參數綁定元件

1）點選參數面板的「編輯」按鈕，進入參數面板編輯介面。右上角元件設定面板會顯示沒有新增到參數面板的參數，點選「地區」或者點選「全部新增」，將參數新增至參數面板。如下圖所示：

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

2）點選自訂元件的「編輯」按鈕，選擇正文元件，參數即綁定正文元件，如下圖所示：

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

3）將查詢按鈕往左邊拖曳，形成緊湊式佈局，讓參數面板更加美觀。如下圖所示：

4）再次點選參數面板的「編輯」按鈕，完成參數面板的設定，回到報表設計介面。如下圖所示：

2.6 設定資料過濾

參數綁定元件後還不能實現根據正文框中輸入參數值查詢指定地區的銷售資訊。因為報表的資料來源於資料集，資料集取出了資料庫表中的全部資料，所以需要給報表設定資料過濾，才可以查詢出元件輸入參數值對應的銷售資訊。

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

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

2.7 效果預覽

1）PC 端

儲存報表，點選「分頁預覽」。

• 正文框中輸入「華東」，點選查詢，只查詢出報表中華東地區的銷售資訊。如下圖所示：

• 正文框中輸入「華北」，點選查詢，只查詢出報表中華北地區的銷售資訊。如下圖所示：

2）行動端

同時支援 App 與 HTML5 端。

• 正文框中輸入「華東」，點選查詢，只查詢出報表中華東地區的銷售資訊。如下圖所示：

• 正文框中輸入「華北」，點選查詢，只查詢出報表中華北地區的銷售資訊。如下圖所示：

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