1. 概述编辑
本文主要汇总了 FineReport 10.0 升级至 11.0 后设计器的常见问题及解决方案，便于大家更好的解决升级过程中遇到的问题。
FineReport 10.0 升级至 11.0 过程中需要使用到升级工具，在使用升级工具的过程中出现的问题可以参考 升级工具常见问题 进行排查。
2. 升级后cptx模板异常编辑
2.1 cptx 模板下钻失败
问题描述：
升级之后，cptx模板下钻失败
原因分析：
11.0 版本的新计算引擎为内置功能，并且 11.0 版本没有 cptx 模板，所有的 cptx 模板会自动保存为 cpt 模板。
解决方案：
手动修改超链接 url 中的 cptx 改成 cpt。
2.2 cptx 模板数据显示空白
问题描述：
10 版本的 cptx 模板放到 11 版本异常，预览数据空白。
原因分析：
升级到 11.0.8 及之后版本即可。
3. 插件兼容问题编辑
3.1 老版本 frm 打开为空白，打开同时新建一个报表
问题详情：
打开老版本frm，设计器会自动新建一个 workbook，且原目标设计页面内容空白，预览正常有数据。
原因分析：
11.0 工程启动的时候，自动安装了模板助手插件，导致了功能异常。
解决方案：
禁用模板助手插件后，重新切换远程目录，模板打开正常。
3.2 升级后 word 报告导出异常
原因分析：
插件版本问题，图表小于一定阈值时，会产生形变/压缩。
解决方案：
将 JAR 更新至 11.0.9 及之后版本，同时更新 Word 报告插件。
3.3 填报预览报错：未安装新填报预览插件
问题详情：
升级之后决策平台预览挂载填报模板，出现报错：未安装新填报预览插件，自动转换为老填报预览，如下图所示：
原因分析：
Finereport11.0 废弃了「新填报预览」功能，改为插件支持。
若原 Finereport10.0 工程在三个月内有使用「新填报预览」的功能记录，在升级时会自动以插件形式保留此功能。
若原 Finereport10.0 工程在三个月内没有使用「新填报预览」的功能记录，需要用户自行按照新填报预览插件。
解决方案：
联系技术支持获取新填报预览插件。
技术支持联系方式：请前往「服务平台」，选择「在线支持」即可。
3.4 使用扩展图表插件开发的图表，升级之后图表颜色异常
问题详情：
模板使用旧图表插件开发的图表，升级之后图表的颜色样式不对。
解决方案：
更新扩展图表版本到 V4.6.5 解决
3.5 升级后钉钉配置消失
原因分析：
原始的钉钉集成插件版本老旧，兼容性较差。
解决方案：
更新最新版本插件，并重新配置相关信息，同时在钉钉应用上需要重新保存新的平台地址并发布。
3.6 升级后新建定时调度任务失败
问题详情：
10升11后定时调度执行失败，新建的定时调度通知方式为客户端通知的任务均无法保存。
原因分析：
插件版本不适配。
解决方案：
重新安装71版本微信管理插件即可。
3.7 升级后前端单点登录失败
问题详情：
FineReport 9.0 版本与其他产品集成，升级后 11.0 版本后单点登录失败。
原因分析：
升级后接口变更导致单点登录失败。
解决方案：
重新安装单点登录插件，重新配置单点登录地址即可。
3.8 升级后负载管理显示空白
问题详情：
升级之后，负载管理没有信息展示，都是空白现象，websocket端口正常，如下图所示：
解决方案：
更新至 11.0.10 版本即可。
3.9 升级后 Mes 集成失败
问题详情：
10.0版本与Mesh集成，升级后Mes集成失败。
原因分析：
云端运维插件冲突。
解决方案：
禁用云端运维插件即可。
3.10 升级后模板加载变慢
问题详情：
原 10.0 版本安装了性能插件，优化模板加载速度，升级后模板加载速度变慢。
原因分析：
Finereport10.0 使用性能插件，Finereport11.0 将该插件拆分为三个插件以及内置功能，不再使用性能优化插件。
解决方案：
Finereport11.0 将该插件拆分为三个插件以及内置功能，根据需求重新安装插件即可。
3.11 升级后 json 数据集取数失败报错：Read timed out
问题详情：
升级后 json 数据集取数失败报错：Read timed out，如下图所示：
原因分析：
插件版本问题
解决方案：
更新 json 数据集插件到 V9.5.11 版本即可。
3.12 升级后复选框全选报错
问题详情：
10.0 中使用控件性能优化插件，升级后复选框全选报错：CustomJSError :_..).setCellsQuick
原因分析：
11.0 版本不支持控件性能优化插件
解决方案：
使用替代方案：JS实现复选按钮控件全选和批量操作
4. 控件相关问题编辑
4.1 升级后填报时出现提示：不允许自定义值
问题详情：
升级后原填报报表，进行填报时出现提示：不允许自定义值，如下图所示：
原因分析：
10 升 11 后，控件校验逻辑改动导致填报效果异常，10.0 的时候不会校验控件自带的校验，11.0 控件默认自带校验功能。
解决方案：
可通过「fine_conf_entity可视化配置插件」，找到 fine_conf_entity 表，修改WriteOptimizationConfig.verifyCustomValue参数值为false，重启 tomcat 即可。
4.2 升级后填报校验失败
问题详情：
升级11之后，数据校验不通过，填报失败。
原因分析：
10.0中对空格不进行校验，11里面空格识别为自定义内容，导致了异常。
解决方案：
删除空格即可。
4.3 升级后标签控件写入html显示异常
问题详情：
10-11升级后 label标签控件写入html显示,大于号展示成>，如下图所示：
正常情况：
异常显示：
解决方案：
升级至 11.0.9 及之后的版本即可。
4.4 升级后日期控件报错
问题详情：
10-11升级后日期控件报错“找不到控件类型”，10版本正常，11版本报错，如下图所示：
原因分析：
初始日期用 YEAR(TODAY()) 返回的是一个数字类型的，和控件格式的 yyyy 类型不一致导致报错。
解决方案：
升级至 11.0.12 及之后的版本即可。
5. 自适应问题编辑
5.1 模板行高变高
问题描述：
8.0 使用部署升级方法升级至 11.0 后，cpt模板有自适应问题，单元格变的很高。
解决方案：
更换至最新的部署包，重新部署即可。
5.2 模板自适应失效，frm模板组件布局异常
问题描述：
10.0 升级到 11.0 后，PC端模板自适应失效，设计器界面frm模板组件布局异常，如下图所示：
移动端模板：布局错乱，pc端正常、报表块纵向拉长、报表块内产生横向或者纵向滚动条，如下图所示：
原因分析：
自适应逻辑变动导致的模板异常。
PC端：10.0 模板使用的旧自适应，升级后 11.0 使用新适应预览导致 PC 端模板异常。
移动端：10.0 版本移动端不支持新自适应，11.0 版本移动端开始支持新自适应。升级时候要用老自适应升级。
解决方案：
11.0 的自适应逻辑可参考：自适应属性
PC端：将 10.0 版本的模板新自适应改为老自适应，再放到 11.0 版本预览使用即可。
移动端：手动调整报表块的位置即可。
5.3 10.0 模板默认是双向自适应，11.0 环境中变成横向自适应
解决方案：
手动调整11.0环境中的模板，将模板变更为双向自适应即可。