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