设计器升级指南

1.1 版本

1.2 功能简介

为满足客户的新需求以及完善之前版本某些功能的不足之处，我们的产品在不断地更新迭代。升级分为设计器升级和服务器升级。

• 服务器升级：操作对象一般为系统管理员，负责将公司测试环境和正式环境工程进行升级，以便修复之前版本中存在的一些问题及增加新的产品功能。

  如需进行服务器工程升级，请参考：工程升级指南
  

• 设计器升级：操作对象一般为设计模板的用户，为了保持和公司系统的一致性，对本地设计器进行升级。

  不提供跨大版本（例如FineReport10.0升级FineReport11.0）的设计器升级方案，请直接重新下载并安装设计器。

  本文主要介绍设计器在小版本内（例如FineReport11.0.5升级FineReport11.0.9）升级的两种升级情况，请根据实际情况选择适用方案。
  

本节方案：FineReport11.0低版本设计器，在线升级到FineReport11.0最新版本

2.1 备份设计器

在进行设计器升级前，为避免升级失败出现文件丢失的情况，请务必对设计器工程进行备份后再升级。

推荐直接备份%FineReport_HOME%\webapps\webroot文件夹。

2.2 在线更新

1）打开设计器。

2）确保从远程设计状态切换为本地默认环境，远程设计状态下不支持「更新升级」功能。

3）点击菜单「帮助>更新升级」，查看「立即更新」按钮是否可点击，灰化则说明当前已处于最新版本，无需升级。

3）点击「立即更新」按钮。由于设计器更新时要获取比对 JS 并解析，会出现几秒的延迟，获取更新信息中，请耐心等待。

2.3 重启设计器

1）关闭设计器。

2）如从11.0.9以下版本版本升级至11.0.9及之后版本，请手动删除%FR_HOME%/webapps/webroot/WEB-INF/lib下netty相关jar包。

11.0.9及之后版本，产品内置了netty-all-4.1.78.Final.jar相关功能，因此需要删除额外的jar，否则可能无法正常启动工程。

如需从高版本回退至11.0.9以下版本，需要额外在设计器 %FR_HOME%/webapps/webroot/WEB-INF/lib目录下加上netty相关jar包。

点击下载JAR包：netty-all-4.1.78.Final.jar

3）启动设计器。

2.4 检查升级是否成功

重启设计器后，点击菜单「帮助>更新升级」。

提示「当前已是最新版本」，且「立即更新」按钮灰化，说明设计器更新成功。如下图所示：

本节方案：FineReport11.0低版本设计器，手动升级到FineReport11.0最新/指定版本

3.1 备份设计器

在进行设计器升级前，为避免升级失败出现文件丢失的情况，请务必对设计器工程进行备份后再升级。

推荐直接备份%FineReport_HOME%\webapps\webroot文件夹。

3.2 获取JAR包

1）如需获取指定版本JAR包，一般都是为了远程连接，可先查看下需要远程连接的服务器工程版本。

登录远程工程，点击「管理系统>注册管理>版本信息」，记录下服务器工程的小版本号（精确到日期）。

2）付费用户请联系帆软技术支持，索要最新/指定版本的JAR包。技术支持联系方式：前往「服务」，选择「在线支持」、电话「400-811-8890」。

一般包括 14 个升级 JAR 包：

fine-accumulator-11.0.jar、fine-activator-11.0.jar、fine-core-11.0.jar、fine-datasource-11.0.jar、fine-decision-11.0.jar、fine-decision-report-11.0、fine-report-designer-11.0.jar、fine-report-engine-11.0.jar、fine-schedule-11.0.jar、fine-schedule-report-11.0.jar、fine-swift-log-adaptor-11.0.jar、fine-third-11.0.jar、fine-webui-11.0.jar、fine-cbb-11.0.jar

3.3 手动更新

1）关闭设计器。

2）将fine-report-designer-11.0 JAR 包，放到 %FR_Home%/lib 下。

3）将其余 JAR 包，放到%FR_Home%/webapps/webroot/WEB-INF/lib下。

注：11.0.3 之前版本不存在 fine-cbb-11.0.jar ，只有12个JAR包。如果回退版本，请删除该JAR。

4）如从11.0.9以下版本版本升级至11.0.9及之后版本，请手动删除%FR_HOME%/webapps/webroot/WEB-INF/lib下netty相关jar包。

11.0.9及之后版本，产品内置了netty-all-4.1.78.Final.jar相关功能，因此需要删除额外的jar，否则可能无法正常启动工程。

如需从高版本回退至11.0.9以下版本，需要额外在设计器工程 %FR_HOME%/webapps/webroot/WEB-INF/lib目录下加上netty相关jar包。

点击下载JAR包：netty-all-4.1.78.Final.jar

5）如从11.0.20以下版本升级至11.0.20及之后版本

请先手动删除%FR_HOME%/lib下原有的jxbrowser相关jar包。

请根据设计器所在环境，下载合适的6.0.23和7.26版本的jxbrowser相关jar包，并上传至%FR_HOME%/lib下。

6）启动设计器。

3.4 检查升级是否成功

重启设计器后，点击菜单「帮助>更新升级」。可查看当前JAR版本，确认是否是自己所需的设计器版本。如下图所示：

以下两种场景下，会触发升级。

4.1 插件管理触发升级

设计器开启了「使用新插件管理器」，如下图所示：

点击服务器，插件管理，若检测到 jxbrowser 的 JAR 包不存在，则弹出强制升级提示框，如下图所示：

点击确定或关闭提示框，将跳转至更新升级界面，后续升级步骤如上文所示。

4.2 远程连接版本不一致

服务器上和设计器上的 JAR 的版本要保持一致，否则可能会导致某些模板本地看预览效果正常，服务器下预览出现问题。

当设计器切换工作目录至远程服务器时，若服务器和设计器的 JAR 包不匹配时，将出现弹窗提示。

点击「同步至本地」，将从服务器上获取不一致的内容信息并下载对应jar包和插件并替换本地 JAR 包，替换完成后将重启设计器并再次远程到服务器。如下图所示：

详情请参见：JAR包不匹配常见问题