1. 概述
適用場景：安裝了「FineVis資料視覺化」插件的使用者，可參考本文了解 FVS 的相關功能。
1.1 版本
| 报表服务器版本 | 插件版本 | 功能变动 |
|---|---|---|
| 11.0.21 | V2.0.0 | 新增「FVS组件刷新」功能，可实现真正的基于数据变动的推送刷新功能 |
| 11.0.22 | V2.7.1 | 组件刷新功能新增「开启仅刷新数据」设置项，详情参见 2.4 节 |
1.2 應用場景
FVS 組件「監視重新整理」功能，採取的是按照設定的固定時間主動發起請求重新整理行為。這種方式會降低一定的效能，且頻繁請求可能給資料庫帶來壓力。
透過開啟組件的資料推播重新整理」，滿足資料推播重新整理條件的組件開啟「監視重新整理」後，則可以實現基於資料變動即時重新整理的效果。
預期效果如下圖所示：
1.3 環境準備
若組件要實現資料推播重新整理，則該組件所使用的所有的資料集必須滿足資料推播權限。
注：三維組件根據資料圖層判斷權限，無需所有資料集滿足。
即對應的資料庫需為 MySQL、SQL Server 或 Oracle ，且需進行配置授權。詳情請查看以下文檔：
2. 功能介紹
2.1 功能入口
點選「範本>FVS範本設定>組件重新整理」，可勾選「開啟資料推播重新整理」和「開啟僅重新整理資料」。
2.2 開啟資料推播重新整理
開啟僅資料推播重新整理後，點選「立即校驗」，可校驗當前範本內所有開啟了「監視重新整理」的組件是否滿足資料推播權限，並彈出權限校驗列表。
列表中展示欄位包括：資料庫/資料庫表/資料集的名稱，是否滿足資料推播權限，以及涉及組件名稱（預設加上「頁面名稱」前綴）。
如下圖所示：
2.3 資料推播重新整理規則
1）資料推播前提是 websocket 是連結狀態，而設計器平台的要求是必須要登入才能連上 websocket 。
因此要登入報表平台後，資料推播重新整理才能生效；若未登入平台時存取範本，資料推播重新整理無效，保持原始監視重新整理規則。
2）組件開啟「監視重新整理」並開啟「資料推播重新整理」後：
若組件滿足資料推播重新整理權限，預覽時會一直對組件使用到的資料表進行監聽，資料更新後組件重新請求資料才重新整理組件；
若組件不滿足資料推播重新整理權限，則組件保持原始「監視重新整理」規則，即根據設定的重新整理間隔時間輪詢請求資料。
3）若預覽範本時，瀏覽器開啟了多個標籤頁，由於 websocket 不能共用，預設情況下，資料可能無法推播重新整理。
此時需要透過 fine_conf_entity視覺化配置插件 修改配置項 WebSocketConfig.randomSession 的參數值為 true。
2.4 開啟僅重新整理資料
開啟僅重新整理資料作用的組件僅包括：三維自訂場景組件、三維城市場景組件 和 Unity組件。
效果是：在監視重新整理或資料推播重新整理時，僅更新資料，保留即時性交互操作。例如場景視角、模型動畫等，均不受重新整理影響。
以 JS實現三維組件傳參僅重新整理資料 文檔中三維組件為例：
不開啟僅重新整理資料效果：資料更新時，組件整體重新整理，模型恢復初始狀態
開啟僅重新整理資料效果：僅資料更新，模型不受影響
3. 範例
注：操作以下步驟之前請確定已進行 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資料庫實現，不提供範本範例。
