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