1. 概述
1.1 版本
| 報表伺服器版本 | 插件版本 | App版本 HTML5行動端展現插件版本 | 功能變更 |
|---|---|---|---|
| 11.0 | V2.7 | - | - |
| 11.0.20 | V2.7 | V11.0.85 | 新多選下拉樹元件適配行動端 |
1.2 問題描述
FineReport 設計器內建多選下拉樹元件
若勾選了「只傳回葉子節點」，雖然可以全選子節點，但是上代節點本身不在傳回值中。
若不勾選「只傳回葉子節點」，可以選中上代節點作為傳回值，但子節點需要一個個手動選，無法批量選中。
如何同時既可選中上代節點本身，又可以一鍵全選目錄下的葉子節點呢？
1.3 實現思路
FineReport 提供新多選下拉樹元件插件，使用者透過該元件選擇具有多層樹狀結構的資料時，可以選到目錄和全選目錄下的葉子節點。
注：該元件不支援在開啟 參數面板新樣式 下使用。
1.4 注意事項
1）新多選下拉樹元件，不支援在 參數面板新樣式 下使用。
2）新多選下拉樹元件，不支援在 新計算引擎介紹 下使用。
3）11.0.20之前版本，不支援在行動端使用新多選下拉樹元件。
11.0.20及之後版本，支援在行動端使用新多選下拉樹元件。
2. 插件介紹
2.1 插件安裝
點選下載插件：新多選下拉樹元件
設計器插件安裝方法參照：設計器插件管理
伺服器安裝插件方法參照：伺服器插件管理
2.2 插件使用
插件安裝完成後，新增「新多選下拉樹元件」，拖曳至「參數面板」即可新增該元件，如下圖所示：
2.3 元件屬性
新多選下拉樹元件屬性與下拉樹元件屬性基本一致，詳情請參見 下拉樹元件 。
新多選下拉樹元件在勾選多選和勾選只傳回葉子節點的情況下可以實現目錄和葉子節點都能選中的功能。
二者的差別如下：
| 結果是否傳回葉子節點 | 下拉樹元件 | 新多選下拉樹元件 |
|---|---|---|
| 勾選 | 支援勾選目錄進行全選子節點 目錄不作為結果傳回 | 支援勾選目錄進行全選子節點 目錄作為結果傳回 |
| 不勾選 | 不支援勾選目錄進行全選子節點 目錄可以作為結果傳回 | 不支援勾選目錄進行全選子節點 目錄可以作為結果傳回 |
3. 範例
3.1 範本製作
參考 多選下拉樹實現多值查詢 第 3 章 制作新模板。
範本製作的步驟不變，僅將參數面板中「下拉樹元件」更換為「新多選下拉樹元件」即可。
勾選「多選」和「只傳回葉子節點」，如下圖所示：
3.2 效果預覽
3.2.1 PC端
儲存範本，點選「分頁預覽」。
可以實現單獨選擇目錄下的葉子結點，也可以實現選中目錄和全選目錄下的葉子節點，效果如 1.3 節所示。
3.2.2 行動端
行動端查看效果如下圖所示：
4. 範本下載
點選下載範本：新多選下拉樹實現多值查詢.cpt
