1. 概述编辑
1.1 版本
报表服务器版本 |
---|
11.0 |
1.2 应用场景
用户工程部署在服务器上,若需要插件实现某一功能时,可在服务器中下载插件进行使用。
1.3 功能简介
插件管理提供可视化界面安装、删除、更新、禁用、启用插件。如下图所示:
注:IE8 及以下版本浏览器不支持。
插件管理支持以下特性:
支持热部署,安装、删除、更新、禁用、启用不需要重启
配置 license 不需要重启
自动安装和更新插件的依赖(包括插件之间的依赖关系)
自动删除不再使用的文件和服务依赖
远程环境下自动检测插件是否匹配,并实时同步插件的运行状态
注1:当设计器远程连接服务器时,服务器如需使用某插件功能,则服务器端和设计器端均需安装该插件,方可正常使用。
注2:FineReport 设计器中下载插件请参见: 设计器插件管理
注3:FineReport 设计器切换工作目录到远程环境,远程环境下「服务器」Tab 页中没有「插件管理」选项。
2. 安装插件编辑
服务器上安装插件有三种方法:下载安装、本地安装、手动安装。
2.1 下载安装
1)管理员登录数据决策系统,点击「管理系统>插件管理」,搜索框输入插件名称进行搜索,选中需要安装的插件,点击安装,如下图所示:
2)插件安装成功后,弹出安装成功弹窗。如下图所示:
2.2 本地安装
1)在 帆软市场 上下载插件,得到的压缩包如下图所示:
注:在帆软市场中需使用帆软通行证登录后,才能下载插件。
2)管理员登录数据决策系统,点击「管理系统>插件管理>从本地安装」,选择.zip压缩包,如下图所示:
注:请勿解压上文得到的压缩包,直接安装即可。
2.3 手动安装
注:当没有购买决策系统或 War 包部署时,可通过手动安装插件。
2.3.1 确定插件文件夹
1)FineReport 设计器所安装的插件存储在%FR_HOME%\webapps\webroot\WEB-INF\plugins 路径中,如下图所示:
注:路径下的文件夹必须是在设计器中安装插件生成的,不是官网下载的插件压缩包解压后得到的文件夹。
2)打开某个插件文件夹下的plugin.xml文件,可确定具体插件。如下图所示:
2.3.2 复制粘贴插件文件
将%FR_HOME%\webapps\webroot\WEB-INF\plugins下的plugin-com.fr.plugin.mobile.widget.date-10.4.55 文件夹复制粘贴到%Tomcat_HOME%\webapps\webroot\WEB-INF\plugins 路径下。如下图所示:
2.3.3 重启报表工程
手动安装插件后,需要重启报表工程,插件方可生效。
2.3.4 效果展示
重启后,管理员登录数据决策系统,点击「管理系统>插件管理」,可看到插件已成功安装。如下图所示:
3. 禁用/启用插件编辑
在「我的插件」处,选中某一插件,点击禁用/启用按钮,提示:插件已被禁用/插件已被启用。如下图所示:
4. 删除插件编辑
在服务器「我的插件」处,选中要删除的插件,点击删除按钮,点击弹窗上的确定按钮。如下图所示:
5. 更新插件编辑
在平台「我的插件」处,选中需更新的插件,点击「更新」按钮,点击弹窗上的「确定」按钮。如下图所示:
6. 注意事项编辑
6.1 关闭插件自动更新功能
「宕机处理」、「云端运维」等插件,在工程启动时、启动一段时间后、每晚 23 点会自动检测插件版本并更新。
超级管理员可通过「fine_conf_entity可视化配置插件」关闭此类插件的自动更新。重启服务器后设置生效。
注:修改 FineDB 数据库表字段值的方法请参考 FineDB 常用表字段修改 。
参数名 | 参数描述 | 参数值 |
---|---|---|
UpdateConfig.launchSwitchMap.plugins | 插件自动更新的启动更新是否开启 | 如需关闭工程启动后的插件自动更新,请将参数值修改为false,否则无需改动 |
CronUpdateConfig.typeMap.plugins | 插件自动更新的定时更新是否开启 | 如需关闭工程启动后每晚11点的外网更新插件,请将参数值修改为false,否则无需改动 |
DelayUpdateConfig.delaySwitchMap.plugins | 插件自动更新的延迟更新是否开启 | 如需关闭工程启动后延迟一段时间的插件自动更新,请将参数值修改为false,否则无需改动 |
6.2 开启插件完整性校验
本地安装/手动安装插件时,为了防止恶意篡改插件包中的代码,提供插件完整性校验功能。该功能默认关闭。
超级管理员可通过「fine_conf_entity可视化配置插件」开启对上传的插件安装包的完整性校验功能。重启服务器后设置生效。
注:修改 FineDB 数据库表字段值的方法请参考 FineDB 常用表字段修改 。
参数名 | 参数描述 | 参数值 |
---|---|---|
PluginFileValidateConfig.fileValidateOpen | 插件包完整性校验是否开启 | 参数值需为布尔型,默认为false false:插件包完整性校验关闭 true:插件包完整性校验开启 |
若开启了插件完整性校验功能,如果插件包被解压/被破坏:
1)本地安装插件时,禁止此插件安装至系统,并报错提醒「此插件安装包签名损坏,存在安全风险,无法安装」。
2)手动安装插件时,不加载此插件至系统,日志内出现报错,前端无报错。
注1:若开启了插件完整性校验功能,但仍然必须要安装某个签名无法通过校验的插件(例如二开插件),用户可通过手动安装的方式安装插件,详情请参见本文 2.3 节。
注2:插件完整性校验功能仅对帆软官方插件生效,第三方插件不生效。如需对第三方插件添加校验签名,请联系技术支持。技术支持联系方式:QQ「800049425」、电话「400-811-8890」。