1. 概述
1.1 版本
报表服务器版本 | 功能变更 |
---|---|
11.0 | -- |
1.2 功能简介
用户通过设计器远程连接服务器进行远程设计时,设计器和服务器 JAR 包版本要保持一致,否则在设计时,会引发一系列的问题。
FR 11.0 版本的设计器,用户连接远程设计时,当服务器和设计器的 JAR 包不匹配时,设计器右上角出现弹窗,并且设计器“通知中心”按钮显示有新消息状态,如下图所示:
当设计器切换工作目录至远程服务器时(直接在菜单里切换,和打开配置工作目录弹窗后点击确定时切换)或设计器连着远程服务器启动后,当服务器和设计器的 JAR 包不匹配时,设计器“通知中心”按钮显示有新消息状态。鼠标点击显示具体异常信息,将出现弹窗,如下图所示:
当设计器可连接至外网时,点击「同步至本地」,将从服务器上获取不一致的内容信息并下载对应jar包和插件并替换本地 JAR 包(只同步启用状态的插件),替换完成后将重启设计器并再次远程到服务器。
当设计器无法连接至外网时,此时需要用户手动替换不一致的内容。
点击「忽略」,可忽略此问题,继续使用,但会因 JAR 包版本不一致,产生的一些设计问题。
2. 查看版本
保证版本一致,首先客户需知道如何查看设计器和服务器的版本。
1. 设计器版本
打开设计器,点击「菜单栏>帮助>关于软件」,可查看到设计器的 JAR 包时间。如下图所示:
2. 服务器版本
打开服务器对应的数据决策系统,点击「管理系统>智能运维>备份还原>更新升级」,可以查看到服务器的 JAR 包时间。如下图所示:
注:这里指服务器对应的数据决策系统,并非本地设计器对应的决策系统。
若查看后,JAR 包时间不一致,说明设计器和服务器的版本不一致,需更新升级至一致。如何升级可参考:FineReport升级指南
3. 可能引发的问题
当版本不一致时,会引发的问题主要表现在以下几个方面。
部分模板挂载在平台上后预览效果和本地预览时有差异。
图表元素显示不全,如图表百分比显示不全、扩展图表不显示等。
模板无法预览,模板预览报错,预览数据集时报错。
切换工作目录失败。
模板内容不全,如模板中数据集无法显示,部分控件无法显示。
数据连接成功,但无法对应库中的表数据。
对模板进行重命名或另存为时,显示没有权限。
以下为一些引发问题的详细介绍。
3.1 数据连接成功但无法预览
数据连接成功,但是新建数据集时,看不到视图和表,显示数据库连接失败,如下图所示:
查看日志,发现报错:connection pool shut down,如下图所示:
3.2 预览数据集时报错
预览数据集时,报错:java.lang.reflect.UndeclaredThrowableException,如下图所示:
3.3 对模板操作时没有权限
远程设计时,对模板进行重命名或另存为时,显示没有权限,如下图所示:
3.4 远程连接时示警
切换工作目录至远程服务器时,跳出警告:远程设计可以连接,但版本不匹配,如下图所示:
3.5 平台 fetchsize 消失
平台中数据连接高级设置中的「Fetchsize」 设置可能会消失,如下图所示: