管理過濾器
本文介紹過濾器的詳細(xì)使用方法,包括新建過濾器、添加過濾器和排序過濾器等。
前提條件
已登錄DataV控制臺(tái)
已進(jìn)入畫布編輯器頁面
新建過濾器
您可以通過以下兩種方法新建過濾器。
通過過濾器 > 過濾器新建。
在左側(cè)導(dǎo)航欄,單擊過濾器,進(jìn)入過濾器頁面。
在過濾器面板中,單擊新增過濾器。
在過濾器配置區(qū)域,輸入過濾器的名稱和自定義的過濾代碼,單擊保存。
再次打開過濾器,可以單擊關(guān)聯(lián)全局變量,將已創(chuàng)建的全局變量綁定到當(dāng)前過濾器中,您可以直接使用該全局變量。
創(chuàng)建成功的過濾器會(huì)排列顯示在過濾器列表中。
重要通過過濾器創(chuàng)建的過濾器,可以被當(dāng)前數(shù)據(jù)看板中的任意組件調(diào)用,調(diào)用方式請(qǐng)參見使用過濾器。被調(diào)用后會(huì)顯示組件和過濾器的依賴關(guān)系。
通過組件 > 數(shù)據(jù)源新建。
在當(dāng)前數(shù)據(jù)看板中隨機(jī)添加一個(gè)組件,單擊右側(cè)配置面板中的數(shù)據(jù)源。
在數(shù)據(jù)源配置面板中,打開過濾器,單擊新建。
在過濾器配置區(qū)域,輸入過濾器的名稱和自定義的過濾代碼,單擊保存。
創(chuàng)建成功的過濾器會(huì)排列顯示在過濾器列表中,并顯示過濾器和組件之間的依賴關(guān)系。
重命名過濾器
鼠標(biāo)移動(dòng)到過濾器列表中的某個(gè)過濾器上,單擊圖標(biāo),輸入過濾器名稱即可。
刪除過濾器
刪除過濾器操作可能會(huì)導(dǎo)致相關(guān)組件不可用,請(qǐng)確認(rèn)后操作。
鼠標(biāo)移動(dòng)到過濾器列表中的某個(gè)過濾器上,單擊圖標(biāo)即可。
添加過濾器
在組件的數(shù)據(jù)源配置面板中,打開過濾器。
單擊下拉菜單,選擇需要添加的過濾器即可。
清空過濾器
在組件中添加了多個(gè)過濾器后,可以單擊清理過濾器列表清空過濾器。
過濾器被清除后無法恢復(fù),請(qǐng)謹(jǐn)慎操作。
排序過濾器
在組件中添加了多個(gè)過濾器后,可以通過上下拖動(dòng)過濾器進(jìn)行排序。
組件數(shù)據(jù)源內(nèi)添加了多個(gè)過濾器后,數(shù)據(jù)過濾的順序是從上往下,依次經(jīng)過排序好的過濾器。第一個(gè)過濾器的輸入是數(shù)據(jù)源直接請(qǐng)求得到的結(jié)果;第二個(gè)過濾器的輸入等于第一個(gè)過濾器過濾后的輸出數(shù)據(jù),依次類推傳遞數(shù)據(jù)。
當(dāng)組件中添加了多個(gè)過濾器時(shí),如果中間有過濾器返回值為空,那么該過濾器會(huì)被忽略,但過濾不會(huì)終止,且系統(tǒng)會(huì)在多個(gè)過濾器配置頁面中進(jìn)行提示。
當(dāng)組件中添加了多個(gè)過濾器時(shí),如果某個(gè)過濾器執(zhí)行報(bào)錯(cuò),那么過濾會(huì)終止,并采用上一次執(zhí)行正確的結(jié)果。
調(diào)試過濾器
在數(shù)據(jù)源頁面中,可以編輯過濾代碼進(jìn)行調(diào)試,左側(cè)彈窗實(shí)時(shí)展示返回結(jié)果。
過濾器調(diào)試功能可確保過濾代碼的正確性,但不適用于數(shù)據(jù)量過大的情況。
數(shù)據(jù)源和過濾器報(bào)錯(cuò)
數(shù)據(jù)源報(bào)錯(cuò):在組件數(shù)據(jù)面板添加完過濾器后,如果將當(dāng)前數(shù)據(jù)源切換成其他類型的數(shù)據(jù)源,會(huì)在錯(cuò)誤信息處展示下面兩個(gè)錯(cuò)誤,提示用戶數(shù)據(jù)接口有問題。
重要當(dāng)數(shù)據(jù)源異常的時(shí)候,即使是有返回的數(shù)據(jù)內(nèi)容,添加在數(shù)據(jù)面板的過濾器也不會(huì)執(zhí)行,會(huì)置灰顯示。因?yàn)閿?shù)據(jù)流從一開始就錯(cuò)了,再通過過濾器處理就沒有意義了。
過濾器報(bào)錯(cuò):在過濾器對(duì)數(shù)據(jù)執(zhí)行過濾過程中,如果代碼執(zhí)行出錯(cuò)會(huì)在界面提示。 例如:待返回字段未定義。
管理過濾器面板
在過濾器頁簽的過濾器面板中,您可以管理應(yīng)用內(nèi)所有組件的過濾器,面板中的過濾器都可以被數(shù)據(jù)看板內(nèi)任意組件添加使用。您可以在每個(gè)過濾器的右側(cè)查看當(dāng)前過濾器被調(diào)用數(shù)量。
在過濾器面板中修改某個(gè)過濾器的內(nèi)容時(shí),會(huì)使所有依賴這個(gè)過濾器的組件不可用,請(qǐng)謹(jǐn)慎操作。