1. 概述编辑
用户在使用设计器时会遇到设计器模板报存失败或模板无法打开等情况,但是不知道如何定位问题或者解决问题,本文根据常见的客户 bug 原因及模板保存机制,整理出了常规有关模板问题的解决方案,用户可以根据自己遇到的实际情况进行排查并解决问题。
1.1 报表文件保存机制
2. 模板创建常见问题编辑
2.1 模板创建失败
问题描述:模板创建失败
解决方案:通常是权限的问题,可以检查远程设计权限和服务器目录权限
2.2 创建的为决策报表(frm)但生成了空白的普通报表(cpt)
问题描述:创建的为决策报表(frm)但生成了空白的普通报表(cpt)
解决方案:为新自适应插件的问题,禁用或升级插件即可
3. 模板打开常见问题编辑
设计器当前打开模板需经过以下校验:
1)当前打开模板是否有被他人锁定。
2)当前模板结构(xml)是否正常。
若均正常,则会正常打开模板。若无法打开,排查思路如下:
1)查看日志报错:可以根据具体报错看下是不是插件的问题,可能是扩展图表插件的问题。
2)若日志中无有效信息,有可能是 xml 损坏。
注:设计器远程连接服务器设计模板的常见问题请参考:远程设计常见问题 。
3.1 打开 frm 出现空白 cpt
问题描述:打开 frm 出现空白 cpt
解决方案:新自适应插件问题,禁用或升级插件即可
3.2 预览报表无法启动浏览器
问题描述:在对报表进行分页预览,可能会遇到如下两种无法在 B/S 端展现报表的情况,无法启动浏览器,弹窗显示:
解决方案:设置电脑的默认浏览器。
3.3 设计器无法预览所有模板
问题描述:设计器点击预览无法跳转模板,新建模板也不行,报错:ERROR [standard] --job class not found, jobKey: DATA_PREPARE.DATA_PREPARE_FR-FB001
解决方案:设置更换电脑的默认浏览器或者安装预设浏览器插件
4. 模板保存常见问题编辑
4.1 模板保存无法实时生效
问题描述:模板保存无法实时生效
解决方案:
注:集群环境需要先排查是否开启了集群缓存。
1)由于平台设置了缓存导致的,在「管理系统>抽数缓存>缓存配置」开启了「总是重新读取模板」,关闭后即可恢复正常。
2)若关闭「总是重新读取模板」仍无法解决,可关闭新引擎即可恢复正常。
4.2 模板保存为 0kb
问题描述:模板保存为 0kb
解决方案:这是由于磁盘空间不足导致的,在11.0.2及以上的版本和10.0.19及以上的版本都已修复。在保存模板时,若发现磁盘空间不足,则会弹出警告框,提示用户清理磁盘空间后再保存。
1)如果用户环境低于11.0.2或低于10.0.19,且发生了模板丢失的现象,如何找回?
若为集群环境:找之前的备份还原了,没有备份就只能重做
若非集群环境:查看用户是否使用了版本管理功能,通过版本管理还原即可。若无可以通过 git 还原。
2)特殊情况:磁盘还有空间,但仍报错空间不足
检查下模板文件名称是否包含 ?* 等字符,去掉特殊字符即可
4.3 模板保存失败
问题描述:模板保存失败
解决方案:
1)检查服务器 JAR 和设计器 JAR 版本是否一致,若不一致换为一致的 JAR。若版本一致,检查是否缺少 JAR,详情请参考:JAR 包异常检测
2)查看日志报错信息
报错信息为:because there was insufficient free space available after evicting expired cache entries,此为 Tomcat 环境问题,需要提高最大缓存值
报错信息为:socket write error,此问题发生在某些安装了 IPv6 TCP 堆栈的 Windows 系统上,为网络问题,添加jvm配置项即可
报错信息为:nginx 413报错,限制了请求大小(模板大小超出),修改配置项即可
报错信息为:write account error,为操作者权限不够导致文件修改保存不成功,修改文件夹权限即可
3)若日志无异常,可查看具体问题表现
仅某个模板保存不了:可能是 post 请求,size 大小默认限制为 2m 导致,修改 tomacat 的 post 请求大小即可
所有模板都保存不了(新建模板无法保存、旧模板也无法保存):多数是权限问题,查看下服务器目录权限。
4.4 模板保存未生效
4.4.1 修改模板后BS浏览结果不变
问题描述:改了模板,在浏览器中访问却还是原来的结果,没有改过来。
原因分析:浏览器访问过一个页面后,会将结果缓存一段时间。修改模板后再次预览,访问路径相同,参数相同,浏览器会直接加载之前缓存的结果,导致效果没有变化。
解决方案:清空浏览器历史记录,刷新页面即可看到修改后的效果。
4.4.2 修改了模板某些设置预览时模板没有变化
解决方案:清理浏览器缓存后,检查修改内容是否进行了正确的配置,例如参数名是否和参数控件进行绑定等。
4.5 设计器异常关闭导致模板文件丢失为 temp 文件
问题描述:设计器异常关闭导致模板文件丢失为 temp 文件
解决方案:可以通过改后缀为 cpt 或 frm 恢复文件
4.6 保存模板时出现提示
问题描述:保存时出现提示:保存时发现模板锁定信息不一致,是否生成备份文件
解决方案:原因为保存时 uuid 不一致,可能是因为:
1)编辑过程中被管理员强制解锁,可参考:远程设计模板锁定
2)切换工作目录
5. 模板预览常见问题编辑
5.1 无法正常预览
问题描述:模板无法正常预览,点击预览没反应
解决方案:
1)查看默认浏览器设置,修改下默认浏览器
2)安装插件:预设浏览器插件
5.2 预览效果与模板实际效果不一致
问题描述:预览效果与模板实际效果不一致
解决方案:由于平台设置了缓存导致的,在「管理系统>抽数缓存>缓存配置」开启了「总是重新读取模板」,关闭后即可恢复正常。
5.3 设计能够打开报表,但预览没有反应
问题描述:设计器能够打开报表,但是点击预览没反应,报错:cannot open the url Successful
解决方案:
1)默认浏览器设置问题(防火墙,杀毒软件),一些杀毒软件会自动改默认浏览器,绝大数情况下都是这个原因
2)远程设计,先切换到本地工作目录,可以预览报表,怀疑是jar包问题
3)url问题,直接预览配置的远程设计里的url,访问报错,发现ip地址最后多了一个空格
6. 乱码问题编辑
设计器打开模板显示乱码的主要原因有如下几种:
1)语种显示乱码一般为缺少对应的语种字体。
2)设计器、服务器、传输工具编码不一致,导致远程设计或传输后模板打开显示乱码。
解决方法:
1)安装对应语种的语言包,并安装性能优化插件。
2)修改设计器、服务器、传输工具编码,使得三者编码一致
6.1 设计器出现泰文乱码
在设计器单元格内或者公式编辑框内编辑泰文时会乱码,如下图所示:
单元格:
公式编辑器
原因分析:设计器 OpenJDK 不支持显示泰文。
解决方案:
将 JDK 安装目录下的%JAVA_HOME%\jre文件夹拷贝,覆盖掉设计器安装目录下的%FR_HOME%\jre文件夹。
将 JDK 安装目录下的%JAVA_HOME%\jdk\lib目录下的tools.jar拷贝,复制到设计器安装目录%FR_HOME%\lib文件夹中。
注1:如果不引入 tools.jar ,设计器无法正常启动。
注2:10.0 设计器要求 JDK 版本为:JDK 1.8 且小版本需在 JDK8u102 以上。
6.2 图表中中文乱码出现方框等
原因分析:方框是缺少中文字体的缘故。
解决方案:对应计算机系统,下载更新对应的中文字体库。
6.3 泰语 韩语等小语种乱码
解决方案:修改 fs 里的编码设置为 UTF-8
6.4 设计器界面错乱, 菜单显示成英文
原因分析:可能是上一次打开的模板里面用了当前环境里不存在的插件元素
解决方案:Ctrl + N 新建一张模板后, 退出设计器.再次启动。
6.5 设计器数据库查询界面输入乱码
问题描述
数据库查询界面的 SQL 编辑区域中所有英文都显示乱码,如下图所示:
解决方案:请参见:设计器数据库查询界面输入乱码
6.6 日文数据源预览乱码
问题描述
数据都是日语数据,数据在报表和数据库中都是正常显示的,但是用浏览器预览就是乱码
解决方案
正常显示的日文字符和不能正常显示的日文字符并非同一种字符,排查字体安装包并安装对应正确的字体包即可。