历史版本5 :JAR包、插件版本不匹配常见问题 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

用户通过设计器远程连接服务器进行远程设计时,设计器和服务器 JAR 包版本要保持一致,否则在设计时,会引发一系列的问题。

用户连接远程设计时,当服务器和设计器的 JAR 包不匹配时,设计器会弹窗显示:远程设计可连接,但版本不匹配。如下图所示:

1583213816197816.png

2020-04-26 及之后的 JAR 包版本,针对版本不一致导致远程设计某些功能不可用的问题,新增了弹窗提示的功能。

当设计器切换工作目录至远程服务器时(直接在菜单里切换,和打开配置工作目录弹窗后点击确定时切换)或设计器连着远程服务器启动后,会弹窗提示。弹窗中列举了可能受影响或不支持的功能,如下图所示:

勾选了本月不再提示后,当月不再弹出,下个月继续提示。

Desktop.png

所以用户在远程设计时,应先检查设计器版本和服务器版本,保证其 JAR 包版本一致,避免因不一致产生的一些设计问题。

2. 查看版本编辑

保证版本一致,首先客户需知道如何查看设计器和服务器的版本。

1)设计器版本

打开设计器,点击「菜单栏>帮助>更新升级」,可查看到设计器的 JAR 包时间。如下图所示:

1583215088690099.png

2)服务器版本

打开服务器对应的数据决策系统,点击「管理系统>智能运维>备份还原>更新升级」,可以查看到服务器的 JAR 包时间。如下图所示:

注:这里指服务器对应的数据决策系统,并非本地设计器对应的决策系统。

1583215968653387.png

若查看后,JAR 包时间不一致,说明设计器和服务器的版本不一致,需更新升级至一致。如何升级可参考:FineReport升级指南

3. 可能引发的问题编辑

当版本不一致时,会引发的问题主要表现在以下几个方面。

  • 部分模板挂载在平台上后预览效果和本地预览时有差异。

  • 图表元素显示不全,如图表百分比显示不全、扩展图表不显示等。

  • 模板无法预览,模板预览报错,预览数据集时报错。

  • 切换工作目录失败。

  • 模板内容不全,如模板中数据集无法显示,部分控件无法显示。

  • 数据连接成功,但无法对应库中的表数据。

  • 对模板进行重命名或另存为时,显示没有权限。

以下为一些引发问题的详细介绍。

1)数据连接成功但无法预览

数据连接成功,但是新建数据集时,看不到视图和表,显示数据库连接失败,如下图所示:

1583204485326555.png

查看日志,发现报错:connection pool shut down,如下图所示:

1583204309403632.png

2)预览数据集时报错

预览数据集时,报错:java.lang.reflect.UndeclaredThrowableException,如下图所示:

image.png

3)对模板操作时没有权限

远程设计时,对模板进行重命名或另存为时,显示没有权限,如下图所示:

1583206174831384.png

4)远程连接时示警

切换工作目录至远程服务器时,跳出警告:远程设计可以连接,但版本不匹配,如下图所示:

1583213816197816.png