1. 概述
1.1 版本
| FineBI 版本 | 功能變動 |
|---|---|
| 5.0 | - |
| 5.1.13 | 所有 BI 插件會跟隨對應 BI 的升級而自動升級 |
| 5.1.16 | 支援關閉部分插件的自動更新 新增插件完整性校驗功能 |
1.2 應用場景
若需要插件實現某一功能時，可在「插件管理」中下載插件進行使用。
1.3 功能簡介
插件管理提供視覺化介面安裝、刪除、更新、禁用、啟用插件。如下圖所示：
注：IE8 及以下版本瀏覽器不支援。
2. 安裝插件
伺服器上安裝插件有三種方法：下載安裝、本地安裝、手動安裝。
注：本章範例伺服器為 Tomcat 伺服器 ，範例插件為「HTML5 行動端展現插件」。
2.1 下載安裝
1）以管理者身分進入數據決策系統，點選管理系統>插件管理，搜尋框輸入插件名稱進行搜尋，選中需要安裝的插件，點選安裝，以安裝「HTML5 行動端展現」插件為例，如下圖所示：
2）插件安裝成功後，彈出安裝成功彈窗。如下圖所示：
2.2 本地安裝
1）在 帆軟市場 上下載「HTML5 行動端展現」插件，得到的壓縮包如下圖所示：
注：在帆軟市場中需使用帆軟通行證登入後，才能下載插件。
2）以管理者身分進入數據決策系統，點選管理系統>插件管理>從本地安裝，選擇.zip壓縮包，如下圖所示：
注：請勿解壓上文得到的壓縮包，直接安裝即可。
2.3 手動安裝
注：當沒有購買決策系統或 War 包部署時，可透過手動安裝插件。
2.3.1 確定插件資料夾
1）FineBI 所安裝的插件儲存在%BI_HOME%\webapps\webroot\WEB-INF\plugins 路徑中，如下圖所示：
注：路徑下的資料夾必須是在 FineBI 中安裝插件生成的，不是官網下載的插件壓縮包解壓後得到的資料夾。
2）開啟某個插件資料夾下的plugin.xml檔案，可確定具體插件。如下圖所示：
2.3.2 複製貼補插件檔案
將%BI_HOME%\webapps\webroot\WEB-INF\plugins下的plugin-com.fr.plugin.mobile.web-10.4.76 資料夾複製貼補到%Tomcat_HOME%\webapps\webroot\WEB-INF\plugins 路徑下。如下圖所示：
2.3.3 效果展示
重啓 Tomcat 伺服器，以管理者身分進入數據決策系統，點選管理系統>插件管理，可看到「HTML5 行動端展現」插件已成功安裝。如下圖所示：
3. 禁用/啟用插件
在伺服器「我的插件」處，選中某一插件，點選禁用/啟用按鈕，提示：插件已被禁用/插件已被啟用。如下圖所示：
4. 刪除插件
在伺服器「我的插件」處，選中要刪除的插件，點選刪除按鈕，點選彈窗上的確定按鈕。如下圖所示：
5. 更新插件
在平台「我的插件」處，選中需更新的插件，點選更新按鈕，點選彈窗上的確定按鈕。如下圖所示：
6. 注意事項
6.1 關閉插件自動更新功能
「當機處理」、「雲端健檢分析」等插件，在工程啟動時、啟動一段時間後、每晚 23 點會自動檢查插件版本並更新。
5.1.16 及之後版本的BI工程，超級管理者可透過「fine_conf_entity視覺化配置插件」關閉此類插件的自動更新。重啓伺服器後設定生效。
注：修改 FineDB 資料庫表欄位值的方法請參考 FineDB 常用表欄位修改 。
| 參數名 | 參數描述 | 參數值 |
|---|---|---|
| UpdateConfig.launchSwitchMap.plugins | 插件自動更新的啟動更新是否開啓 | 如需關閉工程啟動後的插件自動更新，請將參數值修改為false，否則無需改動 |
| CronUpdateConfig.typeMap.plugins | 插件自動更新的定時更新是否開啓 | 如需關閉工程啟動後每晚11點的外網更新插件，請將參數值修改為false，否則無需改動 |
| DelayUpdateConfig.delaySwitchMap.plugins | 插件自動更新的延遲更新是否開啓 | 如需關閉工程啟動後延遲一段時間的插件自動更新，請將參數值修改為false，否則無需改動 |
6.2 開啓插件完整性校驗
本地安裝/手動安裝插件時，為了防止惡意篡改插件包中的代碼，5.1.16 及之後版本的BI工程提供插件完整性校驗功能。該功能預設關閉。
超級管理者可透過「fine_conf_entity視覺化配置插件」開啓對上傳的插件安裝包的完整性校驗功能。重啓伺服器後設定生效。
注：修改 FineDB 資料庫表欄位值的方法請參考 FineDB 常用表欄位修改 。
| 參數名 | 參數描述 | 參數值 |
|---|---|---|
| PluginFileValidateConfig.fileValidateOpen | 插件包完整性校驗是否開啓 | 參數值需為布林型，預設為false false：插件包完整性校驗關閉 true：插件包完整性校驗開啓 |
若開啓了插件完整性校驗功能，如果插件包被解壓/被破壞：
1）本地安裝插件時，禁止此插件安裝至系統，並報錯提醒「此插件安裝包簽章損壞，存在安全風險，無法安裝」。
2）手動安裝插件時，不載入此插件至系統，日誌內出現報錯，前端無報錯。
注1：若開啓了插件完整性校驗功能，但仍然必須要安裝某個簽章無法透過校驗的插件（例如二開插件），使用者可透過手動安裝的方式安裝插件，詳情請參見本文 2.3 節。
注2：插件完整性校驗功能僅對帆軟官方插件生效，第三方插件不生效。如需對第三方插件新增校驗簽章，請聯絡技術支援。技術支援聯絡方式：QQ「800049425」、電話「400-811-8890」。