1. 概述
1.1 版本
| 設計器版本 | 功能變動 |
|---|---|
| 11.0 | - |
| 11.0.7 | 新增函式，可根據節點的實際值，找出節點的完整路徑，輔助設定下拉樹預設值，相容原自訂函式 TREENODEFINDER 的功能。 |
1.2 應用場景
下拉樹元件預設值設定 ，要求預設值必須為節點的完整路徑。當下拉樹層級較多或下拉樹為多選且需要設定多個預設值時，填寫節點的完整路徑就會非常複雜。如下圖所示：
所以在層級較多和需要多個預設值的情況下，如何簡單填寫預設值呢？
1.3 功能簡介
11.0.7 及以後版本，新增下拉樹預設值設定函式 TREEDEFAULTPATH，根據子節點的值即可找出葉子節點的完整路徑，不用再填寫複雜的完整路徑。如下圖所示：
1.4 函式解譯
1）概述
| 文法 | TREEDEFAULTPATH(value) | 根據節點的實際值，在當前下拉樹資料字典中找出節點的完整路徑，輔助設定下拉樹預設值。 |
|---|---|---|
| 參數1 | value | 節點的值，只能是實際值，value 為字串時需要加 ""
傳入多個值時，單選下拉樹只匹配第一組資料，多選下拉樹匹配所有資料。 |
2）範例
單個值：TREEDEFAULTPATH("南京") 等於"華東","江蘇","南京"
多個值：TREEDEFAULTPATH(["南京","武漢"]) 等於"華東","江蘇","南京";"華中","湖北","武漢"
多個值為字串，可以透過ARRAY 函式將字串轉化為陣列：TREEDEFAULTPATH(ARRAY("南京","無錫")) 等於"華東","江蘇","南京";"華東","江蘇","無錫"
2. 操作步驟
實現給多選下拉樹元件賦 5 個預設值。如下圖所示：
2.1 建立下拉樹
建立範本，在參數面板中構建一個下拉樹元件，這裏直接使用 下拉樹元件普通分層構建範例 中的範本。如下圖所示：
2.2 設定預設值
如果想要下拉樹在預覽時預設選中南京、蘇州、無錫、常州、徐州，就可以給下拉樹設定預設值。如下圖所示：
點選下拉樹元件，在「元件設定」>「屬性」>「元件值」位置，選擇「公式」，輸入 TREEDEFAULTPATH(ARRAY("南京","無錫","蘇州","常州","徐州")) 。如下圖所示：
這樣就透過 TREEDEFAULTPATH 函式給下拉樹元件設定了預設值。
2.3 效果預覽
儲存範本，點選「分頁預覽」，效果如下圖所示：
3. 範本下載
點選下載範本：TREEDEFAULTPATH设置下拉树默认值.cpt
