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

目录:

1. 概述编辑

1.1 版本

报表服务器版本功能变动
11.0-
11.0.18

插件管理全面优化:

1)支持批量管理插件,包括:批量禁用/启用、全部更新

2)插件管理界面拆分为「应用商城」和「我的插件」界面,并采用全新界面风格

  • 「应用商城」提供插件浏览、安装操作

  • 「我的插件」提供已安装插件的详细信息以及各种管理操作

1.2 应用场景

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

1.3 功能简介

11.0.18 及之后版本,插件管理界面全面优化,并支持批量管理插件。本文将对插件管理的使用进行介绍。

管理员登录数据决策系统,点击「管理系统>插件管理」,如下图所示:

  • 应用商城:提供插件商城安装、本地安装插件功能。

  • 我的插件:提供已安装插件的信息以及多种插件管理操作,包括:删除、更新、禁用/启用、批量禁用/启用和全部更新操作。

注: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.decision.background.sso.v11-1.2.2复制粘贴到服务器%Tomcat_HOME%\webapps\webroot\WEB-INF\plugins 路径下。如下图所示:

2.3.3 重启报表工程

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

2.3.4 效果展示

重启后,管理员登录数据决策系统,点击「管理系统>插件管理>我的插件」,搜索插件名称,可以看到服务器中已成功安装插件。如下图所示:

3. 管理插件编辑

管理员登录数据决策系统,点击「管理系统>插件管理>我的插件」,「我的插件」页面中以列表形式展示已安装插件的信息,并支持对插件进行管理操作。

  • 插件信息包括:插件名称、版本、待更新(仅在插件可更新时出现)、费用类别、状态。

  • 插件操作包括:搜索、更新、禁用/启用、删除、全部更新、批量禁用/启用。如下图所示:

3.1 更新插件

3.1.1 单独更新

管理员登录数据决策系统,点击「管理系统>插件管理>我的插件」,当插件可更新时,插件版本右侧会新增「待更新」标识。

点击「更新」按钮,更新完成后出现弹窗提示:XXX插件更新成功,点击「确定」即可。如下图所示:

3.1.2 全部更新

管理员登录数据决策系统,点击「管理系统>插件管理>我的插件」,点击「全部更新」按钮,将对已安装的所有插件进行更新。

更新过程中提供进度条,便于获知更新进度,全部插件更新完成后,出现弹窗提示:插件更新成功,点击「确定」即可,如下图所示:

若部分插件更新失败,将弹窗提示:XXX项插件处理失败,XXX项插件处理成功,并提供更新失败原因,如下图所示:

3.2 禁用/启用插件

3.2.1 单独禁用/启用

管理员登录数据决策系统,点击「管理系统>插件管理>我的插件」,点击「禁用/启用」按钮,出现弹窗提示:XXX插件已被禁用/启用,点击「确定」即可,如下图所示:

3.2.2 批量禁用/启用

管理员登录数据决策系统,点击「管理系统>插件管理>我的插件」,勾选需要禁用/启用的插件,点击「禁用/启用」按钮,如下图所示:

出现弹窗提示:所选插件禁用/启用成功,点击「确定」即可,如下图所示:

3.3 删除插件

管理员登录数据决策系统,点击「管理系统>插件管理>我的插件」,点击「删除」按钮,点击弹窗上的「确定」按钮即可,如下图所示:

4. 注意事项编辑

4.1 关闭插件自动更新功能

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

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

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

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

4.2 插件完整性校验

功能说明:

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

下载安装/本地安装插件时,若该插件未通过完整性校验,则提示「XXX插件安装包签名损坏,存在安全风险,无法安装」。如下图所示:

解决方案:

如需关闭插件包完整性校验,管理员可通过修改finedb中的PluginFileValidateConfig.fileValidateOpen字段值为false。

如需开启插件包完整性校验,但仍必须要安装某个签名无法通过校验的插件(例如二开插件),则可通过手动安装的方式安装插件。

详情请参见:第三方插件安装失败说明