檢視表樹元件- FineReport帮助文档 - 全面的报表使用教程和学习资料

1. 概述

1.1 版本

報表伺服器版本	功能變更
11.0	-
11.0.6	參數元件「非同步載入」修改名稱為「非同步展開樹節點」；設定預設值之後，非同步載入邏輯統一，詳情見 2.1.2 節使用自動建構方法建構檢視表樹時，樹資料集根節點的上代節點可以不為空
11.0.7	填報元件「非同步載入」修改名稱為「非同步展開樹節點」；設定預設值之後，非同步載入邏輯統一，詳情見 2.1.1 節新增「回傳值類型」設定項，詳情見 2.1 節屬性表格預設值設定方式優化，不用填寫完整路徑即可設定下拉樹預設值，詳情見 2.1.2 節
11.0.30	標籤名稱支援使用公式，詳情參見 2.1.2 節

1.2 應用場景

1.2.1 填報元件

填報報表中可以透過該元件選擇具有多層樹狀結構的資料，錄入填報的資料，如下圖所示：

注：檢視表樹不支援填報和聯動

1.2.2 參數元件

參數面板處可以透過該元件選擇具有多層樹狀結構的資料，鍵入查詢參數，如下圖所示：

1.3 如何新增

1.3.1 填報元件

被菜儲存格後，點選右側屬性面板的「元件設定」，「選擇元件」處下拉選擇「檢視表樹」元件，如下圖所示：

1.3.2 參數元件

將參數面板元件工具欄中的「檢視表樹」元件拖入到參數面板中，如下圖所示：

1.4 注意事項

1）檢視表樹與下拉樹的差別：
檢視表樹與下拉樹的定義方法是一樣的，差別在於瀏覽器端預覽時顯示的效果不同。如下圖所示：

2）檢視表樹的三種建構方式對比如下：

	極速分層建構	自動建構	普通分層建構
需要的資料集個數	一個或多個	一個	多個
需要的資料集類型	普通資料集	樹資料集	普通資料集
需要的資料結構	有對應關系的多列欄位，必須設定依賴關系。	有對應關系的一欄或兩列欄位，樹關系完整，支援存在多個根節點。注：11.0.6 之前根節點的上代節點必須為空。	有對應關系的多列欄位，sql中需要用treelayer函式進行過濾。
效能	標準情況下效能優於普通分層建構。	因資料結構特殊，所以和其他兩種建構方式無對比性。當資料量大且需要全選節點時，建議不勾選非同步載入。	大數據量情況下可考慮，需勾選效能優先和非同步載入。

2. 元件介紹

2.1 屬性

2.1.1 填報元件

「檢視表樹」元件的屬性設定介面如下圖所示：

各屬性設定項的詳細介紹如下：
注：「檢視表樹」元件在填報應用時，可透過在儲存格中新增值的方式設定預設值，方法和下拉樹一緻，可參考：下拉樹預設值設定

分類	設定項	詳細介紹
基本	元件名稱	元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為無。
	可用	元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選。
	可見	元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選。
	建構樹	可以定義下拉樹實際值與顯示值，有 3 種建構方式，自動建構、普通分層建構、極速分層建構 1）自動建構：根據樹資料集層級關系自動建構出下拉樹，無需一層一層定義資料。詳細範例可參考：下拉樹自動建構 2）普通分層建構：透過資料字典一層一層定義下拉樹，需要資料集中定義一些 layer 參數配合完成，將上一層的值作為參數值，過濾下一層的資料。詳細範例可參考：下拉樹普通分層建構普通分層建構時，提供「效能優先」選項，勾選後會提高載入效率，預設不勾選。如下圖所示：勾選後，當有層目錄下沒有子節點，顯示的時候仍會是 + ，點開無資料項，如下圖所示： 3）極速分層建構：透過「資料集」來定義下拉樹的層級，相比「普通分層建構」，不需要 layer 參數配合，而是將資料按分類排列，每一層綁定資料列即可。詳細範例可參考：下拉樹極速分層建構注：不支援透過設定儲存格字體大小和顔色來調整資料字典選項的字體大小和顔色。
	多選	勾選後，填報時可選擇檢視表樹的多個選項；不勾選，填報時只可選擇一個選項。預設不勾選。
	非同步展開樹節點注：11.0.7 之前名稱為非同步載入	節點載入邏輯，會影響效能，預設勾選。勾選後，展開選項時只載入上代節點的資料，所有子節點預設不展開，適用於資料量大的情況。當元件有預設值時，預設值節點展開並選中，其他節點不展開。不勾選，展開選項時所有子節點一次性展開，適用於資料量小的情況。當元件有預設值時，所有子節點一次性展開並選中預設值節點。
	只傳回葉子節點	多選時，選擇上代節點後，是否會自動選擇子節點。預設勾選勾選後，勾選上代節點時自動勾選子節點；不勾選，當勾選上代節點時不自動勾選子節點注：「結果傳回葉子節點」是多選檢視表樹的功能設定項，單選檢視表樹不受影響。
	結果傳回完整層次路徑	下拉樹是一種有層次結構的元件，每個最末端的葉子節點都有其完整的層次路徑。結果傳回完整路徑即選擇值後，要不要傳回其完整的層次路徑，回傳值為陣列類型的資料。勾選後，傳回完整路徑，如選擇部長，回傳值為：總部，人力資源部，部長不勾選後，只傳回葉子節點，如上選擇部長，回傳值為：部長
	回傳值類型注：此項為11.0.7 新增	勾選「多選」和不勾選「結果傳回完整層次路徑」後才有此設定項。用來設定多選檢視表樹回傳值的格式，分為陣列和字串兩種。勾選「結果傳回完整層次路徑」後，回傳值類型已確定，所以對應情況下不會有此設定項。 1）陣列：回傳值類型是陣列型，例如：勾選三個值，回傳值為：["值 1","值 2","值 3"] 2）字串：回傳值類型為字串，需要定義分隔符、開始符和結束符，即將勾選的多個值根據分隔符連結成一個字串。例如：在輸入法為英文的狀態下，將分隔符，開始符和結束符分別定義成逗號，單引號和單引號，則回傳值為：'值 1,值 2,值 3'
校驗	允許為空	是否允許元件不選擇項，勾選後，允許元件不選擇；不勾選，填報校驗和提交時會提示，預設勾選。
校驗	錯誤提示	不勾選「允許為空」時出現的設定項，可自訂提示資訊。預設情況下將顯示：不能為空

2.1.2 參數元件

檢視表樹元件的屬性設定介面如下圖所示：

各屬性設定項的詳細介紹如下：

分類	設定項	詳細介紹
基本	元件名稱	元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為 treeEditor# 。
	可用	元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選。
	可見	元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選。
進階	標籤名稱	元件的標籤屬性是用在行動端的，行動端不支援參數面板上的「標籤元件」，識別的是普通元件的「標籤名稱」屬性，所以行動端可以用元件的標籤名稱來實現標籤。 FineReport 11.0.30 及以上版本，標籤名稱支援使用公式。編輯框內輸入公式正文（等號開頭），自動計算公式結果作為最終標籤名稱。注：使用 i18n 函式實現標籤名稱根據語言顯示時，多語言插件需更新至 V2.2.2 版本。若範本中使用的 key (範本內或平台內的 key )更新，需手動重新整理範本才可生效。
	控件值	元件初始化時的預設值，僅支援公式進行設定，或預設為空。注：11.0.7 之前版本下拉樹預設值必須寫節點實際值的完整路徑，11.0.7 及以後版本，新增TREEDEFAULTPATH 函式，不用填寫完整路徑即可設定預設值。公式：設計器支援的公式，例如： A1 儲存格的值若公式對應的值符合多個值寫法，則會多選。例如：單選：[1,11,111] 多選：[[1,11,111],[1,11,112]] 預覽效果，如下圖所示：
	資料字典	可以定義下拉樹實際值與顯示值，有 3 種構建方式，自動構建、普通分層構建、極速分層構建 1）自動建構：根據樹資料集層級關系自動構建出下拉樹，無需一層一層定義資料。詳細範例可參考：下拉樹自動建構 2）普通分層建構：透過資料字典一層一層定義下拉樹，需要資料集中定義一些 layer 參數配合完成，將上一層的值作為參數值，過濾下一層的資料。詳細範例可參考：下拉樹普通分層構建普通分層建構時，提供「效能優先」選項，勾選後會提高載入效率，預設不勾選。如下圖所示：勾選後，當有層目錄下沒有子節點，顯示的時候仍會是“+”，點開無資料項，如下圖所示： 3）極速分層建構：透過「資料集」來定義下拉樹的層級，相比「普通分層建構」，不需要 layer 參數配合，而是將資料按分類排列，每一層綁定資料列即可。詳細範例可參考：下拉樹極速分層建構
	水印	填報時元件內顯示的淺灰色水印文字，手動輸入，以提示使用者需要輸入資訊，點選元件編輯區域後消失，預設為空。
	字體大小	複用下拉樹的設定項，檢視表樹暫無作用。
	多選	勾選後，填報時可選擇「檢視表樹」的多個選項；不勾選，填報時只可選擇「檢視表樹」的一個選項。預設不勾選。
	非同步展開樹節點注：11.0.6 之前名稱為非同步載入	節點載入邏輯，會影響效能，預設勾選。勾選後，展開選項時只載入上代節點的資料，所有子節點預設不展開，適用於資料量大的情況。當元件有預設值時，預設值節點展開並選中，其他節點不展開。不勾選，展開選項時所有子節點一次性展開，適用於資料量小的情況。當元件有預設值時，所有子節點一次性展開並選中預設值節點。
	結果傳回葉子節點	多選時，選擇上代節點後，是否會自動選擇子節點。預設勾選勾選後，勾選上代節點時自動勾選子節點；不勾選，當勾選上代節點時不自動勾選子節點注：「結果傳回葉子節點」是多選「檢視表樹」的功能設定項，單選「檢視表樹」不受影響。
	結果傳回完整層次路徑	下拉樹是一種有層次結構的元件，每個最末端的葉子節點都有其完整的層次路徑。結果傳回完整路徑即選擇值後，要不要傳回其完整的層次路徑，回傳值為陣列類型的資料。勾選後，傳回完整路徑，如選擇部長，回傳值為：總部，人力資源部，部長不勾選後，只傳回葉子節點，如上選擇部長，回傳值為：部長
	回傳值類型注：此項為11.0.7 新增	勾選「多選」和不勾選「結果傳回完整層次路徑」後才有此設定項。用來設定多選檢視表樹回傳值的格式，分為陣列和字串兩種。勾選「結果傳回完整層次路徑」後，回傳值類型已確定，所以對應情況下不會有此設定項。 1）陣列：回傳值類型是陣列型，例如：勾選三個值，回傳值為：["值 1","值 2","值 3"] 2）字串：回傳值類型為字串，需要定義分隔符、開始符和結束符，即將勾選的多個值根據分隔符連結成一個字串。例如：在輸入法為英文的狀態下，將分隔符，開始符和結束符分別定義成逗號，單引號和單引號，則回傳值為：'值 1,值 2,值 3'
校驗	允許為空	是否允許元件不選擇項，勾選後，允許元件不選擇；不勾選，填報校驗和提交時會提示，預設勾選。
	錯誤提示	不勾選「允許為空」時出現的設定項，可自訂提示資訊。預設情況下將顯示：不能為空
	允許直接編輯	複用下拉樹的設定項，檢視表樹暫無作用。
	允許自訂值	複用下拉樹的設定項，檢視表樹暫無作用。
座標.尺寸	元件位置	元件在參數面板中的位置，透過橫縱座標調整，座標會根據元件在參數面板中的位置自動顯示。
座標.尺寸	元件大小	元件的大小，透過寬度、高度調整，若透過拖曳調整，高寬度也隨着自動調整。

2.2 事件

事件設定介面可以為元件新增事件實現某些效果，「檢視表樹」元件支援的事件有初始化後、點選、節點生成。如下圖所示：

選擇一種事件類型後，即可新增事件內容，「檢視表樹」元件支援的事件迴應方式有 JavaScript 腳本、提交入庫、傳送郵件。如下圖所示：

選擇對應的事件迴應方式新增即可，不同迴應方式差別可參考：事件迴應方式

2.3 行動端

行動端支援檢視表樹元件。

3. 應用範例

檢視表樹元件的應用，可參見以下文檔：

應用場景	實際效果
場景描述：左邊檢視表樹節點，右邊動態顯示該節點對應的報表內容參考文檔：檢視表樹展開
場景描述：透過檢視表樹元件展現具有多層樹狀結構的資料，右邊動態顯示該節點對應的報表內容參考文檔： FVS檢視表樹元件

應用場景

實際效果

場景描述：

左邊檢視表樹節點，右邊動態顯示該節點對應的報表內容

參考文檔：

檢視表樹展開

場景描述：

透過檢視表樹元件展現具有多層樹狀結構的資料，右邊動態顯示該節點對應的報表內容