1. 概述
1.1 版本
| 報表伺服器版本 | FineVis資料視覺化插件 | 應用共享插件版本 | 功能變動 |
|---|---|---|---|
| 11.0.24 | V2.10.0 | V1.0 | - |
| 11.0.24 | V3.1.0 | V1.4 |
|
1.2 應用場景
傳統的FineReport範本分享，只能透過將範本另存為或將原檔案傳送給其他人來實現。
無法實現聯動範本同時匯出，導致其他使用者使用時經常出現報錯，需要花費大量人力進行修改。
無法實現資料脫敏等操作，容易引發資料安全問題。
1.3 功能簡介
本插件實現匯出範本時，將相聯動的範本同時匯出在同一資料夾下，並自動修改超連結等跳轉路徑，避免複用時出現報錯。
同時支援設定脫敏規則，在匯出可根據脫敏規則對資料進行脫敏處理，避免資料安全問題，使得資源複用更加便捷安全。
匯出 FVS 範本及其聯動範本：
支援匯出 FVS 範本以及範本中相聯動的範本。例如，A 範本中有相關連結跳轉到 B 範本，在將 A 範本匯出為 mfvs 檔案時，會自動將 B 範本同時匯出到此檔案中，並修改 A 範本中的跳轉連結路徑。
資料脫敏：
支援設定脫敏規則，並根據脫敏規則將範本中的資料進行脫敏處理，確定資料安全。
資料庫表匯出：
匯出時會將資料庫中的表匯出為 AppData 檔案，實現參數查詢聯動效果。
範本封裝與配置：
匯出時可以根據需求將範本進行封裝並配置內容，使得在匯入時在資源中心預覽時可實現封裝效果。
資料血緣：
匯入的 mfvs 範本支援「資料血緣」功能，便於理解範本內容的構成、實現資料的溯源。
注：資料血緣功能僅支援 FVS 為 V3.1.0 及以上版本且應用共享插件為 V1.4 及以上版本。
2. 插件介紹
2.1 使用前提
1）如需安裝「應用共享插件」：
請先確定升級 FineReport 至 11.0.24 及以上
請確定安裝並啟動「FineVis資料視覺化插件」至 V2.10.0 及以上
再安裝應用共享插件
2）安裝「應用共享插件」後，FVS和應用共享插件的升級有聯動關係
每次升級「FineVis資料視覺化插件」前，請先升級「FineVis資料視覺化插件」至最新，再升級應用共享插件。
「FineVis資料視覺化插件」升級時，「應用共享插件」會被自動禁用，請在 FVS 升級完成後手動啟動。
2.2 插件安裝
點選下載插件：應用共享插件
設計器插件安裝方法請參見：設計器插件管理
伺服器安裝插件方法請參見：伺服器插件管理
2.3 插件功能
2.3.1 匯出
1）入口一
點選設計器左上角「檔案>複用>匯出」。
注：「預覽」功能可實現快速預覽脫敏匯出後的範本，向資料庫中新增資料，以檢查是否有問題。一般情況下，不建議使用者使用該功能。如有實際應用場景，可聯絡帆軟技術支援協助。
在彈出頁面中，點選「內容配置>全部頁面/新增頁面>範本資源」即可選擇需要匯出的範本資源，選擇匯出方式後即可匯出。如下圖所示：
2）入口二
點選設計器左上角「伺服器>FVS我的資源管理」，選擇「應用封裝>建立」，選擇需要匯出的範本後點選「確定」。如下圖所示：
在建立的應用右側，點選「匯出」，選擇匯出方式後即可匯出。
2.3.2 匯入
點選設計器左上角「檔案>建立視覺化看板」，選擇「本地資源」，可透過拖曳或點選本地範本開啟。
3. 範例
3.1 匯出
1）點選設計器左上角「檔案>複用>匯出」，點選「內容配置>全部頁面>範本資源」。
2）選擇需要匯出的範本後點選「確定」
3）在右側可以看到設計器內的封裝預覽介面，如下圖所示：
4）點選「應用配置」即可對匯出的資源進行配置。
具體配置項說明如下表所示：
| 配置項 | 說明 |
|---|---|
| 應用名稱 | 支援自訂應用名稱、應用描述 |
| 封面 | 支援自訂封面，點選圖片即可進行選擇 |
| 類型 | 預設為 FVS 企業戰情室，不支援自訂 |
| 作者 | 預設為帳號稱，不支援自訂 |
| 展示終端 | 支援選擇桌上端、行動端，預設為桌上端 |
| 導航樣式 | 支援選擇頂部導航、側邊導航、混合式導航，預設為頂部導航 |
| 主題色 | 支援自訂導航欄背景、目錄選中態、目錄預設態 |
5）配置完成後，點選右下角「直接匯出/脫敏匯出」即可匯出。
本例選擇脫敏匯出，在彈出的資料脫敏頁面，選擇「確定」。如下圖所示：
6）在儲存頁面中，檔案名稱預設為「應用配置」中的「應用名稱」，點選儲存
彈出 提示：匯出成功，即為儲存成功。
3.2 匯入
1）點選設計器左上角「檔案>建立視覺化看板」，選擇「我的資源」，選擇「應用共享範例.mfvs」檔案，儲存至我的資源並開啟。
2）匯入的資源在 reportlets 目錄下自動建立一個資料夾，資料夾內包含 H2 格式的資料檔案：appdata.mv.db 。
注1：遠端設計下載匯入時，需要確定帳號可以看到 Reportlets 資料夾全部檔案的預覽權限。
注2：FVS V3.1.0 之前版本且應用共享插件為 V1.4 之前版本，資料檔案格式為 DuckDB。
3）匯入的範本預設使用 AppData 作為資料連結，範例資料的查詢語句為 PGSQL 語句。使用者根據不同需求切換為其他資料連結。
3.3 資料血緣
升級 FVS 插件至 V3.1.0 及以上版本、應用共享插件至 V1.4 及以上版本，設計器新增「資料血緣」功能。
透過表血緣和組件血緣，範本開發人員可以快速瞭解資料表和組件之間的關係，清晰看到資料來源和流向。這有助於快速理解範本結構，定位資料異常，提高開發和維護效率，便於資料溯源和優化。
注：資源中心的歷史資源包不支援使用資料血緣。
3.3.1 功能入口
對於複用的 FVS 範本，底部工具欄處新增「血緣」按鈕，如下圖所示：
3.3.2 血緣檢視表構成
點選「血緣檢視表」按鈕，畫布下方彈出血緣檢視表，支援透過拖曳行動檢視表內位置。如下圖所示：
血緣檢視表分資料來源、範本資料集、組件、頁面 4 層，檢視表視窗中設有工具欄。具體說明如下表所示：
| 檢視表項 | 說明 | ||
|---|---|---|---|
| 1 | 血緣檢視表 | 資料來源 | 資料的來源表 僅「資料庫查詢表」、「範例資料表」支援展示來源表 |
| 2 | 範本資料集 | 展示該範本內所有的範本資料集 | |
| 3 | 組件 | 僅展示「表格」、「圖表」、「三維組件」以及含有動態值的「標題」、「富正文」 | |
| 4 | 頁面 | 展示分頁欄裏的所有分頁 | |
| 5 | 工具欄 | 定位 | 點選後，可將血緣檢視表內選中的節點，行動到檢視表中心的位置 注1：僅行動位置，不改變縮放比例。 注2：沒有選中節點時，定位至畫面中心。 |
| 6 | 大小縮放 |
| |
| 7 | 全螢幕 | 點選可放大血緣檢視表視窗 | |
3.3.3 血緣檢視表交互
1）選中一個節點後，範本中有選中效果。該節點上下游的所有節點以及箭頭，均變為聯動狀態，如下圖所示：
2）選中節點，右側顯示「編輯」按鈕，點選「編輯」即可開啟編輯介面。如下圖所示：
注1：僅支援編輯「範本資料集」部分。
注2：若資料集已被刪除，點選編輯按鈕後，顯示彈窗「資料集已刪除，無法編輯」。
4. 注意事項
1）支援匯出 .cpt 和 .fvs 格式的範本
2）僅支援匯入使用本插件匯出的 .mfvs 檔案，非本插件匯出的檔案缺少必要的 appdata.db 檔案，會導致無法正常使用
3）支援建立並使用範例資料集，如下圖所示：
注：缺少 appdata.db 檔案時，不支援建立「範例資料集」
4）若需要刪除資源，點選設計器左上角「伺服器>FVS我的資源管理」，在「範本」和「應用封裝」中找到對應資源一併刪除即可。
注：reportlets 目錄下的資源檔案與「FVS我的資源管理」中的資源是獨立的，以上刪除操作不會影響 reportlets 目錄下的資源檔案。
