FVS組件重新整理

適用場景：安裝了「FineVis資料視覺化」插件的使用者，可參考本文了解 FVS 的相關功能。

1.1 版本

1.2 應用場景

FVS 組件「監視重新整理」功能，採取的是按照設定的固定時間主動發起請求重新整理行為。這種方式會降低一定的效能，且頻繁請求可能給資料庫帶來壓力。

透過開啟組件的資料推播重新整理」，滿足資料推播重新整理條件的組件開啟「監視重新整理」後，則可以實現基於資料變動即時重新整理的效果。

預期效果如下圖所示：

1.3 環境準備

若組件要實現資料推播重新整理，則該組件所使用的所有的資料集必須滿足資料推播權限。

注：三維組件根據資料圖層判斷權限，無需所有資料集滿足。

即對應的資料庫需為 MySQL、SQL Server 或 Oracle ，且需進行配置授權。詳情請查看以下文檔：

• MySQL環境準備

• SQL Server環境準備

• Oracle 環境準備

2.1 功能入口

點選「範本>FVS範本設定>組件重新整理」，可勾選「開啟資料推播重新整理」和「開啟僅重新整理資料」。

2.2 開啟資料推播重新整理

開啟僅資料推播重新整理後，點選「立即校驗」，可校驗當前範本內所有開啟了「監視重新整理」的組件是否滿足資料推播權限，並彈出權限校驗列表。

列表中展示欄位包括：資料庫/資料庫表/資料集的名稱，是否滿足資料推播權限，以及涉及組件名稱（預設加上「頁面名稱」前綴）。

如下圖所示：

2.3 資料推播重新整理規則

1）組件開啟「監視重新整理」並開啟「資料推播重新整理」後：

若組件滿足資料推播重新整理權限，預覽時會一直對組件使用到的資料表進行監聽，資料更新後組件重新請求資料才重新整理組件；

若組件不滿足資料推播重新整理權限，則組件保持原始「監視重新整理」規則，即根據設定的重新整理間隔時間輪詢請求資料 。

2）若預覽範本時，瀏覽器開啟了多個標籤頁，由於 websocket 不能共用，預設情況下，資料可能無法推播重新整理 。

此時需要透過 fine_conf_entity視覺化配置插件 修改配置項 WebSocketConfig.randomSession 的參數值為 true 。

3）V2.8.0 之前版本，資料推播前提是 websocket 是連結狀態，而設計器平台的要求是必須要登入才能連上 websocket 。

因此要登入報表平台後，資料推播重新整理才能生效；若未登入平台時存取範本，資料推播重新整理無效，保持原始監視重新整理規則 。

2.4 開啟僅重新整理資料

開啟僅重新整理資料作用的組件僅包括：三維自訂場景組件、三維城市場景組件 和 Unity組件。

效果是：在監視重新整理或資料推播重新整理時，僅更新資料，保留即時性交互操作。例如場景視角、模型動畫等，均不受重新整理影響。

以 JS實現三維組件傳參僅重新整理資料 文檔中三維組件為例：

• 不開啟僅重新整理資料效果：資料更新時，組件整體重新整理，模型恢復初始狀態

• 開啟僅重新整理資料效果：僅資料更新，模型不受影響

注：操作以下步驟之前請確定已進行 1.3 節環境準備。

3.1 建立視覺化看板

點選設計器左上角「檔案>建立視覺化看板」，建立一張空白看板。如下圖所示：

3.2 準備資料

請根據實際的資料庫類型 定義資料連結 。如下圖所示：

建立資料庫查詢，如下圖所示：

3.3 設計組件

3.3.1 設計表格

1）點選組件區「文字>表格」，將組件新增到畫布中，點選「編輯組件」進入編輯。如下圖所示：

2）將資料集中欄位直接拖入儲存格即可，點選「傳回視覺化看板」傳回畫布。如下圖所示：

3.3.2 設計柱形圖

點選組件區「圖表>柱形圖」，新增到畫布中，綁定資料如下圖所示：

3.4 設定重新整理

3.4.1 開啟組件監視重新整理

選中組件後，點選右側配置面板「交互>監視重新整理」，勾選開啟監視重新整理。如下圖所示：

3.4.2 開啟資料推播重新整理

點選「範本>FVS範本設定>組件重新整理」，勾選「開啟資料推播重新整理」。此時進行資料校驗可看到上述新增的兩個組件均滿足資料推播權限。

3.5 效果預覽

先登入報表平台，再預覽範本，效果如 1.2 節應用場景所示。

注：本文使用本地SqlServer資料庫實現，不提供範本範例。