1. 概述
1.1 版本
| 报表服务器版本 | JAR 包版本 | 功能优化 |
|---|---|---|
| 10.0 | 2020-04-26 | 针对版本不一致导致远程设计某些功能不可用的问题，新增了弹窗提示的功能 |
| 10.0.18 | - | 支持将服务器中的JAR 包、插件等同步至本地 |
1.2 问题描述
用户通过设计器远程连接服务器进行远程设计时，设计器和服务器 JAR 包版本要保持一致，否则在设计时，会引发一系列的问题。
10.0.18 版本及之后的设计器，用户连接远程设计时，当服务器和设计器的 JAR 包不匹配时，设计器右下角出现弹窗，并且设计器“通知中心”按钮显示有新消息状态，如下图所示：
当设计器切换工作目录至远程服务器时（直接在菜单里切换，和打开配置工作目录弹窗后点击确定时切换）或设计器连着远程服务器启动后，当服务器和设计器的 JAR 包不匹配时，设计器“通知中心”按钮显示有新消息状态。鼠标点击显示具体异常信息，将出现弹窗，如下图所示：
2. 解决方案
2.1 查看当前版本
保证版本一致，首先客户需知道如何查看设计器和服务器的版本。
1）设计器版本
打开设计器，点击「菜单栏>帮助>更新升级」，可查看到设计器的 JAR 包时间。如下图所示：
2）服务器版本
打开服务器对应的数据决策系统，点击「管理系统>智能运维>备份还原>更新升级」，可以查看到服务器的 JAR 包时间。如下图所示：
注：这里指服务器对应的数据决策系统，并非本地设计器对应的决策系统。
2.2 更新JAR包
2.2.1 10.0.18 版本之前
当设计器 JAR 包与服务器 JAR 包版本不一致时，此时需要用户手动替换不一致的内容。由于 JAR 包版本不一致，可联系技术支持获取相关版本的 JAR 包。手动替换 JAR 包的方法参考 小版本升级指南 的 3.1.2 节。若插件不一致，可以拷贝服务器上：%FR_HOME%/webapps/webroot/WEB-INF/plugins下的所有插件，复制到设计器的 %FR_HOME%/webapps/webroot/WEB-INF/plugins 以及 %FR_HOME%/plugins 下，重启设计器即可。
2.2.2 10.0.18 及之后版本
若查看后，JAR 包时间不一致，说明设计器和服务器的版本不一致，需更新升级至一致。
1）当设计器可连接至外网时，点击「同步至本地」，将从服务器上获取不一致的内容信息并下载对应jar包和插件并替换本地 JAR 包（只同步启用状态的插件），替换完成后将重启设计器并再次远程到服务器。如下图所示：
若使用如果部分插件未能实现同步，有两种可能原因：
该插件在插件商城由于某些原因已经下架；
该插件是内置插件，无需手动安装，重启设计器即可。
2）当设计器无法连接至外网时，此时需要用户手动替换不一致的内容。由于 JAR 包版本不一致，可联系技术支持获取相关版本的 JAR 包。手动替换 JAR 包的方法参考 小版本升级指南 的 3.1.2 节。若插件不一致，可以拷贝服务器上：%FR_HOME%/webapps/webroot/WEB-INF/plugins下的所有插件，复制到设计器的 %FR_HOME%/webapps/webroot/WEB-INF/plugins 以及 %FR_HOME%/plugins 下，重启设计器即可。
3. 忽略JAR包不一致可能引发的问题
当版本不一致时，会引发的问题主要表现在以下几个方面。
部分模板挂载在平台上后预览效果和本地预览时有差异。
图表元素显示不全，如图表百分比显示不全、扩展图表不显示等。
模板无法预览，模板预览报错，预览数据集时报错。
切换工作目录失败。
模板内容不全，如模板中数据集无法显示，部分控件无法显示。
数据连接成功，但无法对应库中的表数据。
对模板进行重命名或另存为时，显示没有权限。
以下为一些引发问题的详细介绍。
1）数据连接成功但无法预览
数据连接成功，但是新建数据集时，看不到视图和表，显示数据库连接失败，如下图所示：
查看日志，发现报错：connection pool shut down，如下图所示：
2）预览数据集时报错
预览数据集时，报错：java.lang.reflect.UndeclaredThrowableException，如下图所示：
3）对模板操作时没有权限
远程设计时，对模板进行重命名或另存为时，显示没有权限，如下图所示：
4）远程连接时示警
切换工作目录至远程服务器时，跳出警告：远程设计可以连接，但版本不匹配，如下图所示：