新計算引擎下設定折疊樹

1.1 版本

1.2 應用場景

在 cpt 範本 開啟新計算引擎 後，點選設計器菜單欄的「範本」，會新增一個「計算屬性」入口，在「計算屬性」中的實驗性功能中，可優化與摺疊樹相關的效能，本文主要講解如何在新計算引擎下的實現摺疊樹，效果如下圖所示：

1.3 新計算引擎摺疊樹與舊計算引擎摺疊樹對比說明

1）新計算引擎效能提升

• 新計算引擎非同步摺疊樹在取數和前端渲染均做了優化，提升了效能。

• 新計算引擎非非同步摺疊樹，僅在前端渲染提升了效能。

2）支援重複與凍結

新計算引擎非同步/非非同步摺疊樹支援設定重複與凍結，但是限制所有的展開收起行列都必須同時重複或同時凍結。

在「計算屬性」中的實驗性功能中的相關功能如下：

• 勾選「摺疊樹」可以優化當前範本前台資料的載入效能，進而優化摺疊樹的前端效能。

• 在已經勾選「摺疊樹」後，計算屬性介面會新增一個「非同步取數」設定項，勾選該按鈕範本可非同步取數，從取數階段就對摺疊樹效能進行優化，當資料量較大時可以開啟。

• 勾選「摺疊樹-非同步取數」可以優化當前工程下所有範本的摺疊樹效能且開啟非同步取數。

注：新引擎摺疊樹支援凍結及調整摺疊按鈕所在儲存格的內容樣式，需注意若摺疊樹縱向展開則不可設定凍結行，摺疊樹橫向展開則不可設定凍結列。

2.1 非同步取數摺疊樹

非同步取數摺疊樹主要針對結構比較標準的單棵縱向摺疊樹，透過非同步取數+非同步載入，從取數階段就進行摺疊樹效能的優化，只支援同時滿足以下條件的場景：

• 單資料集

• 摺疊樹按鈕縱向排布

• 資料列公式僅支援 sum() 匯總和行內計算

• 單棵摺疊樹

• 摺疊樹按鈕所在行的資料列左父格需設定為摺疊樹按鈕所在儲存格

注：如何判斷是否支援非同步取數：摺疊樹範本轉換，轉換後如顯示相容模式則不支援。

2.2 非非同步取數摺疊樹

非非同步取數摺疊樹主要優化前台資料載入的效能問題，實現前台非同步載入，優化摺疊樹的前端效能，支援場景如下：

• 摺疊樹縱向擴展

• 單棵摺疊樹

3.1 開啟新計算引擎

1）建立一張普通報表，點選「範本>報表引擎屬性」，勾選「啟動後台分頁」按鈕，選擇「新計算引擎」，點選「確定」即可開啟新計算引擎。如下圖所示：

2）點選設計器菜單欄的「範本」，選擇「計算屬性」，選擇實驗性功能，並勾選「摺疊樹」，如下圖所示：

3.2 準備資料

1）建立一個資料庫查詢資料集 ds1，SQL 語句為：SELECT * FROM 公司部門

2）再建立一個 樹資料集 Tree1，其資料來源於 ds1，設定其原始標記欄位為列序號 1，父標記欄位為列序號 2，如下圖所示：

3.3 製作組織樹

1）將樹資料集 Tree1 的 FR_GEN_0、FR_GEN_1、FR_GEN_2 這 3 個欄位分別拖到 A1、A2、A3 儲存格，並都設定為靠左，如下圖所示：

2）A2 儲存格的左父格自訂為 A1，如下圖所示：

注：設定父格的目的是，點選主格時，控制附屬於該組的子項內容展開與摺疊。

3）A3 儲存格的左父格自訂為 A2，如下圖所示：

4）A1、A2、A3儲存格都將形態設定為資料查詢 ds1，實際值為列序號1，顯示值為列序號3，如下圖所示：

注：這裏設定顯示值為列序號 3，是讓前端預覽時可以顯示部門名稱，而不是 ID。

5）給 A2、A3 儲存格都加相同的條件屬性，隱藏掉沒有資料的行，如下圖所示：

3.4 新增樹節點按鈕

給 A1、A2、A3 儲存格都新增樹節點按鈕，這個按鈕作用就是實現層級展開或收起，如下圖所示：

注：新引擎摺疊樹所有摺疊樹層級都需要設定摺疊樹按鈕。

3.5 效果預覽

儲存報表，點選「分頁預覽」，效果如 1.2 節中所示。

注：不支援行動端。

注：下載範本後需要開啟新計算引擎並勾選摺疊樹後才生效。

已完成範本請參見：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doctw\SpecialSubject\TreeReport\摺疊樹.cpt

點選下載範本： 摺疊樹.cpt