插件管理

1.1 版本

1.2 應用場景

若需要插件實現某一功能時，可在「插件管理」中下載插件進行使用。

1.3 功能簡介

插件管理提供視覺化介面安裝、刪除、更新、禁用、啟用插件。如下圖所示：

注1：IE8 及以下版本瀏覽器不支援。

注2：登入的帳號並非FineBI系統帳號，而是帆軟社區通行證帳號。

伺服器上安裝插件有三種方法：下載安裝、本地安裝、手動安裝。

2.1 下載安裝

1）管理者登入FineBI系統，點選「管理系統>插件管理」，搜尋框輸入插件名稱進行搜尋，選中需要安裝的插件，點選安裝，如下圖所示：

2）插件安裝成功後，彈出安裝成功彈窗。如下圖所示：

2.2 本地安裝

1）在 帆軟市場 上下載插件，得到的壓縮包如下圖所示：

注：在帆軟市場中需使用帆軟通行證登入後，才能下載插件。

2）管理者登入FineBI系統，點選「管理系統>插件管理>從本地安裝」，選擇.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 重啟工程

手動安裝插件後，需要重啟FineBI工程，插件方可生效。

2.3.4 效果展示

重啟後，管理者登入FineBI系統，點選「管理系統>插件管理」，可看到插件已成功安裝。如下圖所示：

在「我的插件」處，選中某一插件，點選禁用/啟用按鈕，提示：xxx插件已被禁用/插件已被啟用。如下圖所示：

在「我的插件」處，選中需要刪除的插件，點選「刪除」按鈕，點選彈窗上的「確定」按鈕。如下圖所示：

在「我的插件」處，選中需要更新的插件，點選「更新」按鈕，點選彈窗上的「確定」按鈕。如下圖所示：

6.1 關閉插件自動更新功能

「當機處理」、「雲端維運」等插件，在工程啟動時、啟動一段時間後、每晚 23 點會自動檢測插件版本並更新。

超級管理者可透過「fine_conf_entity視覺化配置插件」關閉此類插件的自動更新。重啟伺服器後設定生效。

注：修改 FineDB 資料庫表字段值的方法請參考 FineDB 常用表欄位修改 。

6.2 插件完整性校驗

功能說明：

本地安裝/手動安裝插件時，為了防止惡意篡改插件包中的代碼，FineBI工程提供插件完整性校驗功能。該功能默認開啟。

下載安裝/本地安裝插件時，若該插件未透過完整性校驗，則提示「XXX插件安裝包簽名損壞，存在安全風險，無法安裝」。如下圖所示：

解決方案：

如需關閉插件包完整性校驗，管理者可透過修改finedb中的PluginFileValidateConfig.fileValidateOpen欄位值為false。

如需開啟插件包完整性校驗，但仍必須要安裝某個簽名無法透過校驗的插件（例如二開插件），則可透過手動安裝的方式安裝插件。

詳情請參見：第三方插件安裝失敗說明