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

目录:

1. 概述编辑

1.1 版本

报表服务器版本功能变动
11.0-
11.0.7
  • 用户旧工程安装了插件 A ,若新版本插件 A 内置了,用户升级 JAR 后,给予提示

  • 用户手动安装已经内置的插件,选择安装后,弹出插件已内置的提示

详情请参见本文第六章

1.2 应用场景

用户工程部署在服务器上,若需要插件实现某一功能时,可在服务器中下载插件进行使用。

1.3 功能简介

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

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

1583937729509547.png

插件管理支持以下特性:

  • 支持热部署,安装、删除、更新、禁用、启用不需要重启

  • 配置 license 不需要重启

  • 自动安装和更新插件的依赖(包括插件之间的依赖关系)

  • 自动删除不再使用的文件和服务依赖

  • 远程环境下自动检测插件是否匹配,并实时同步插件的运行状态

注1:当设计器远程连接服务器时,服务器如需使用某插件功能,则服务器端和设计器端均需安装该插件,方可正常使用。

注2:FineReport 设计器中下载插件请参见: 设计器插件管理

注3:FineReport 设计器切换工作目录到远程环境,远程环境下「服务器」Tab 页中没有「插件管理」选项。

2. 安装插件编辑

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

2.1 下载安装

1)管理员登录数据决策系统,点击「管理系统>插件管理」,搜索框输入插件名称进行搜索,选中需要安装的插件,点击安装,如下图所示:

7.png

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

6.png

2.2 本地安装

1)在 帆软市场 上下载插件,得到的压缩包如下图所示:

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

1583941160814910.png

2)管理员登录数据决策系统,点击「管理系统>插件管理>从本地安装」,选择.zip压缩包,如下图所示:

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

3.png

2.3 手动安装

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

2.3.1 确定插件文件夹

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

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

1583939222266100.png

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

1589940917946392.png

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

1583940207248189.png

2.3.3 重启报表工程

手动安装插件后,需要重启报表工程,插件方可生效。

2.3.4 效果展示

重启后,管理员登录数据决策系统,点击「管理系统>插件管理」,可看到插件已成功安装。如下图所示:

1583940494971867.png

3. 禁用/启用插件编辑

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

6.png

4. 删除插件编辑

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

7.png

5. 更新插件编辑

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

8.png

6. 插件内置提示编辑

11.0.7 及之后版本:

1)用户手动安装已经内置的插件,选择安装后,弹出提示:XX插件因功能内置而自动失效,不影响原功能使用。如下图所示:

1658994338381316.png

2)用户旧工程安装了插件 A ,若新版本插件 A 内置了,用户升级 JAR 后,给予提示:

注:提示对象都为超级管理员。

  • 设计器内:推送系统通知给用户,告知用户其使用中的内置插件列表。

1658994505139093.png

点击上图 2 的窗口,详情页界面如下图所示:

1658994548975803.png

用户若点击「忽略」,则关闭弹窗;若选择「删除内置插件」,则删除内置插件的文件

  • 平台内:推送系统消息给用户,告知用户其使用中的内置插件列表。如下图所示:

1658994686467422.png

7. 注意事项编辑

7.1 关闭插件自动更新功能

「宕机处理」、「云端运维」等插件,在工程启动时、启动一段时间后、每晚 23 点会自动检测插件版本并更新。

超级管理员可通过「fine_conf_entity可视化配置插件」关闭此类插件的自动更新。重启服务器后设置生效。

注:修改 FineDB 数据库表字段值的方法请参考 FineDB 常用表字段修改 。

参数名
参数描述参数值
UpdateConfig.launchSwitchMap.plugins插件自动更新的启动更新是否开启如需关闭工程启动后的插件自动更新,请将参数值修改为false,否则无需改动
CronUpdateConfig.typeMap.plugins插件自动更新的定时更新是否开启如需关闭工程启动后每晚11点的外网更新插件,请将参数值修改为false,否则无需改动
DelayUpdateConfig.delaySwitchMap.plugins插件自动更新的延迟更新是否开启如需关闭工程启动后延迟一段时间的插件自动更新,请将参数值修改为false,否则无需改动

7.2 开启插件完整性校验

本地安装/手动安装插件时,为了防止恶意篡改插件包中的代码,提供插件完整性校验功能。该功能默认关闭。

超级管理员可通过「fine_conf_entity可视化配置插件」开启对上传的插件安装包的完整性校验功能。重启服务器后设置生效。

注:修改 FineDB 数据库表字段值的方法请参考 FineDB 常用表字段修改 。

参数名
参数描述参数值
PluginFileValidateConfig.fileValidateOpen插件包完整性校验是否开启参数值需为布尔型,默认为false

false:插件包完整性校验关闭

true:插件包完整性校验开启

若开启了插件完整性校验功能,如果插件包被解压/被破坏:

下载安装/本地安装插件时,禁止此插件安装至系统,并报错提醒「此插件安装包签名损坏,存在安全风险,无法安装」。

注1:若开启了插件完整性校验功能,但仍然必须要安装某个签名无法通过校验的插件(例如二开插件),用户可通过手动安装的方式安装插件,详情请参见本文 2.3 节。

注2:插件完整性校验功能仅对帆软官方插件生效,第三方插件不生效。如需对第三方插件添加校验签名,请联系技术支持。技术支持联系方式:QQ「800049425」、电话「400-811-8890」。