历史版本14 :插件管理 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

FineBI 版本功能变动
5.0-
5.1.13所有 BI 插件会跟随对应 BI 的升级而自动升级
5.1.16

支持关闭部分插件的自动更新

新增插件完整性校验功能

1.2 应用场景

若需要插件实现某一功能时,可在「插件管理」中下载插件进行使用。

1.3 功能简介

插件管理提供可视化界面安装删除更新禁用启用插件。如下图所示:

注:IE8 及以下版本浏览器不支持。

26.png

2. 安装插件编辑

服务器上安装插件有三种方法:下载安装、本地安装、手动安装。

注:本章示例服务器为 Tomcat 服务器 ,示例插件为「HTML5 移动端展现插件」。

2.1 下载安装

1)以管理员身份进入数据决策系统,点击管理系统>插件管理,搜索框输入插件名称进行搜索,选中需要安装的插件,点击安装,以安装「HTML5 移动端展现」插件为例,如下图所示:

3.png

2)插件安装成功后,弹出安装成功弹窗。如下图所示:

2.png

2.2 本地安装

1)在 帆软市场 上下载「HTML5 移动端展现」插件,得到的压缩包如下图所示:

注:在帆软市场中需使用帆软通行证登录后,才能下载插件。

1592187684989225.png

2)以管理员身份进入数据决策系统,点击管理系统>插件管理>从本地安装,选择.zip压缩包,如下图所示:

注:请勿解压上文得到的压缩包,直接安装即可。

6.png

2.3 手动安装

注:当没有购买决策系统或 War 包部署时,可通过手动安装插件。

2.3.1 确定插件文件夹

1)FineBI 所安装的插件存储在%BI_HOME%\webapps\webroot\WEB-INF\plugins 路径中,如下图所示:

注:路径下的文件夹必须是在 FineBI 中安装插件生成的,不是官网下载的插件压缩包解压后得到的文件夹。

1592190869885409.png

2)打开某个插件文件夹下的plugin.xml文件,可确定具体插件。如下图所示:

8.png

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 路径下。如下图所示:

1592189488513861.png

2.3.3 效果展示

重启 Tomcat 服务器,以管理员身份进入数据决策系统,点击管理系统>插件管理,可看到「HTML5 移动端展现」插件已成功安装。如下图所示:

13.png

3. 禁用/启用插件编辑

在服务器「我的插件」处,选中某一插件,点击禁用/启用按钮,提示:插件已被禁用/插件已被启用。如下图所示:

14.png

4. 删除插件编辑

在服务器「我的插件」处,选中要删除的插件,点击删除按钮,点击弹窗上的确定按钮。如下图所示:

15.png

5. 更新插件编辑

在平台「我的插件」处,选中需更新的插件,点击更新按钮,点击弹窗上的确定按钮。如下图所示:

16.png

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」。