下拉框/下拉複選框/下拉樹的模糊搜尋

1.1 版本

1.2 功能簡介

在使用元件進行填報或查詢資料時，若資料字典中的選項很多，找起來會很麻煩，因此 FineReport 提供了元件的模糊搜尋功能來提高輸入效率。如下圖所示：

模糊搜尋功能適用的元件為下拉框、下拉複選框、下拉樹、新多選下拉樹元件。

注：元件使用模糊搜尋前提是元件能輸入字元，所以元件「屬性>校驗」處必須勾選「允許編輯」。

2.1 匹配選項邏輯

1）匹配時匹配「資料字典」處設定的顯示值和實際值。

注：11.0.2-11.0.10 版本只匹配顯示值。

2）匹配字母時不區分大小寫。

注：11.0.2-11.0.10 版本區分大小寫。

3）字母與漢字選項的漢語拼音首字母進行匹配。

注：11.0.2 及之前版本字母與漢字選項的漢語拼音進行匹配。

4）數字、字母不會被分詞，字母、數字排列和搜尋內容不一致的不會被搜尋出來，只匹配和搜尋內容一致的選項。

注：11.0.2 及之前版本數字、字母會被分詞，數字排列和搜尋內容不一致的也會被搜尋出來。

5）漢字會被分詞進行匹配，例如：「北大」會按照「北」、「大」兩個文字進行匹配

2.2 匹配項排序邏輯

1）模糊搜尋後匹配的選項按匹配程度進行排序，匹配程度高的排在前面。同一匹配程度的選項按照「資料字典」選項本身的順序進行排序。

注：11.0.2 及之前版本模糊搜尋後匹配的選項順序進按照「資料字典」選項本身的順序進行展示。

2）「下拉樹元件」匹配時，匹配父節點和子節點，當父節點下的子節點被匹配到時，該父節點也算作匹配。如下圖所示：

3）「下拉樹元件」匹配項排序時，匹配項的層級越高，排序越靠前。因為子節點被匹配而作為匹配項的父節點將排序在最後面，優先排父節點直接被匹配的。

注：11.0.2 及之前版本模糊搜尋後匹配的選項順序按照「資料字典」選項本身的順序進行排序。

• 因為自身直接被匹配到的節點們，同一層級按照匹配程度進行排序。如下圖所示：

• 因為子節點被匹配而作為匹配項的父節點們，排序時按照「資料字典」中的順序而排序。如下，雖然“北京大學”的“王明”同學被完全匹配，但在「資料字典」的資料中，“北京師範大學”的“王明陽”同學排在前面，所以，展示時他就排在前面。

2.3 匹配後展開邏輯

1）為效能考慮，「下拉樹元件」模糊搜尋時，當某個節點匹配了搜尋關鍵字時，該節點不展開；只有當該節點的子節點或者子節點的子節點被匹配時，此節點才展開。

注：11.0.3 及之前版本當某個節點匹配了搜尋關鍵字時，該節點展開。

2）為效能考慮，「下拉樹元件」匹配後節點展開時，預設展開搜尋匹配結果的前 100 個節點，後面的節點不展開。

注：11.0.6 及之前，匹配的所有節點都展開。

2.4 匹配時觸發邏輯

為效能考慮，在用非英文輸入法輸入正文時，只有選定了要搜尋的內容後才觸發模糊搜尋，出現選項下拉框。

注：11.0.3 及之前版本在用非英文輸入法輸入正文時，在未選定內容前也觸發模糊搜尋，出現選項下拉框。

3.1 下拉框

3.1.1 英文字串

若下拉框中存在 JOHN 和 ANNA 兩筆資料，輸入 J 則過濾出包含 J 的所有資料即JOHN，若輸入 N 則過濾出包含 N 的所有資料即JOHN和 ANNA，如下圖所示：

3.1.2 中文字串

若下拉框中存在江蘇和浙江兩筆資料，輸入j則過濾出拼音的首字母中包含j的所有資料即江蘇和浙江，若輸入JS則過濾出首字元的拼音是 js 的所有資料即江蘇，如下圖所示：

3.2 下拉複選框

類似於下拉框的模糊查詢，下拉複選框也有該此功能。由於複選框可以選擇多個值，故不同於下拉框，下拉複選框可以模糊查詢多個值，如下圖，在範本中新增一個「下拉複選框元件」，資料字典設定如下圖所示：

預覽範本，使用模糊查詢選擇張珊和王偉兩個值。

在下拉複選框的正文框中輸z，則過濾出拼音的首字母中包含z的所有資料，如下圖所示：

勾選張珊之後，張珊的值則會傳回至正文框中，在後面接着輸入w，下拉複選框則會過濾出拼音的首字母中包含w的所有資料，如下圖所示：

選中王偉即可。

3.3 下拉樹

單選下拉樹元件的快速查詢與下拉框一致。多選下拉樹元件的快速查詢與下拉複選框一致。如下圖所示：

單選：

多選：

模糊查詢常見問題及解決方案可參考：模糊查詢常見問題