历史版本9 :9-10 兼容说明 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:
各个版本之前进行升级，由于功能的增删改，会存在一些兼容性问题，但是整体上来说FineReport是向下兼容。

1. FR8.0版本升级指南编辑

1.1 扁平化风格
描述：参数界面控件、填报控件以及工具栏按钮样式换成了扁平化的风格。
更换7.1样式方案可在“插件管理”里启用“老控件样式插件”这个插件即可。
1.2 分栏
描述：分栏的大标题和结尾行会自动扩展到分栏区域大小。
1.3 激活码机制改变
描述：原来的激活码RXWY-A25421-K58F47757-7373之类不能再用于8.0激活，可到官网免费申请新的激活码。
注：原有已激活设计器版本升级不受影响
1.4 用户名和密码的参数
描述：各种关于用户名和密码的参数，全部统一为fr_username和fr_password，包括单点登陆. 所以原有单点登录集成方案升级时需要修改。
1.5 数据决策系统管理菜单
描述：数据决策系统管理菜单部分全部重写，xml不兼容，包含了系统外观、移动平台等平台所有属性配置、同步数据集内容和自定义角色等等保存于fsconfig.xml中的属性。
1.6 地图
描述：地图改进后仍兼容旧版本图片解析，老版本模板只支持预览不支持对地图的编辑。
1.7 组合图
描述：组合图设置界面会将旧版本的条件属性设置兼容为条件属性以及系列设置，预览效果不变。
1.8 升级
描述：8.0版本的升级，与之前版本升级方案一样，不同于7.1版本的升级，需要拷贝fr-chart-8.0.jar、fr-core-8.0.jar、fr-performance-8.0.jar、fr-platform-8.0.jar、fr-report-8.0.jar、fr-third-8.0.jar、fr-applet-8.0.jar，将原来的fr-xx-8.0.jar删除，然后将fr-xx-8.0.jar拷贝到对应目录，如果是从7.1升级到8.0，除了需要替换四个jar之外，还需要将四个http包删掉，详情请参照FineReport升级指南

2. FR7.1.1版本升级指南编辑

2.1 表单
描述：7.1.1版本中对表单进行了重新设计，优化内部逻辑，详细请查看表单设计；
升级方案：之前版本所做的表单在7.1.1中可以预览查看效果，但是无法用设计器打开，如果要修改表单，需要使用新的表单重新做一个；
2.2 升级
描述：7.1.1版本的升级，与之前版本升级方案一样，不同于7.1版本的升级，只需要拷贝fr-designer-7.1.jar、fr-server-7.1.jar和fr-third-7.1.jar即可，如果是从7.1升级到7.1.1，除了需要替换四个jar之外，还需要将四个http包删掉，详细请参照FineReport升级指南

3. FR7.1版本升级指南编辑

3.1 jar包拷贝
描述：7.1版本改动较大，其拷贝jar包升级有以下几个方面需要注意。
升级方案：首先将fr-server-7.1.jar和fr-third-7.1.jar拷贝至%FR_HOME%\WebReport\WEB-INF\lib下面，然后需要删掉7.1之前版本的fr-server-7.0.jar和fr-third-7.0.jar这两个包，如果是设计器升级，还需要将fr-designer-7.1.jar拷贝到设计器%FR_HOME%\lib下面，再删除7.0的包，除此之外，同时需要将httpclient-4.3.1.jar、httpclient-cache-4.3.1.jar、httpcore-4.3.jar、httpmime-4.3.1.jar、commons-codec-1.6.jar和fluent-hc-4.3.1.jar6个包也拷贝到%FR_HOME%\WebReport\WEB-INF\lib下面，jar包可以向FineReport索要，也可以重新安装，从安装包里直接拷贝。
3.2 注册文件
描述：从7.0版本升级至7.1版本，正式注册用户需注意，要向帆软商务重新索要注册文件，重新注册，将相关信息以邮件的方式发送到商务邮箱，具体操作方法请查看注册步骤。
3.3 填报居中以及分页居中边框删除
描述：填报预览增加了居中显示；分页与填报居中的边框删除，详细请查看填报居中
兼容：分页居中边框线升级后会被删除，7.1中提供加边框线和去边框线的方法，contentPane.setBorderVisible(true)；
3.4 地图
描述：新的制作方式不支持对不同层级设置不同维度的数据，新版本利用底层数据自动求和，计算出上层地图数据。
兼容：旧版本中的不同层级的不同维度，兼容为地图的每一层级都添加不同维度
3.5 平台
描述：fs与platform统一后，已使用同一套用户信息。
升级方案：如果老版本中在platform和fs中配置了两套不同的用户设置，在7.1中需要全部重新配置，详细请查看用户管理。
3.6 邮件通讯录
描述：7.1中将邮件通讯录的功能合并到了用户管理页面，邮箱直接作为用户信息的一个属性，方便统一配置管理。
升级方案：旧版本升级时，邮件通讯录需要重新配置，详细请查看添加用户。

4. FR7.0.5版本升级指南编辑

4.1 jetty服务器
描述：从低版本升级到7.0.5版本，除了要更换对应的jar包之外，还需要升级jetty服务器对应的jar包。
解决方案：从FineReport下载中心下载jetty_705.rar文件，解压之后，替换%FR_HOME%\lib文件夹下的jetty文件夹即可。
4.2 下拉控件的点击事件
描述：下拉控件如下拉框、下拉复选框、下拉树的点击事件是在点击控件后就触发了，705版本中将其改为点击下拉框中选项之后触发。
升级方案：此项修改无法兼容，假如之前使用了此点击事件，那么升级之后，该点击事件则会在点击下拉项的时候触发，无法实现点击控件触发，需要用户根据情况选用其他事件。

5. FR7.0.4版本升级指南编辑

5.1 存储过程
描述：7.0.4版本存储过程作为数据集的一种，分为模板数据集和服务器数据集，之前版本是直接在服务器上创建存储过程。
升级方案：原来703的存储过程，处理为服务器数据集中的存储过程。
5.2 行式引擎分页SQL
描述：7.0.4版本中新增了原来6.5版本中的分页sql行式引擎功能。
升级方案：完全兼容6.5中的分页SQL行式引擎。
5.3 行间距
描述：7.0.4版本中新增了原来6.5版本中的行间距功能。
升级方案：完全兼容6.5中的行间距。
5.4 地图
描述：7.0.4版本中改进地图区域选择算法。
升级指南：用703自定义过的自定义地图图片，如果自定义图片的区域线不是很清晰连贯，地图图片可能会出现区域合并的现象,需要将图片修正后才能正常使用，但如果自定义图片的区域线颜色是一致的且没有断点的，就不会有兼容问题。
5.5 填报自定义事件
描述：重新定义自定义提交事件的二次开发接口，增加二次开发的扩展性，并且自定义提交事件可直接定义，不单单以原来内置SQL的子事件存在。
升级指南：以前版本定义的填报自定义提交类，需要按照新的接口规范修正，详细请查看填报自定义事件。

6. FR7.0.3版本升级指南编辑

6.1 702设计器直接升级703
如果从702直接升级到703，除了需要替换designer，server，third3个jar包之外，因为703对地图的优化与修改，还需要将%FR_Home%\WebReport\WEB-INF\resources下面的chartmap文件夹拷过去，该文件夹下面包含了地图的内置数据。
6.2 地图升级
将702制作的地图模板放置在703版本中，由于FineReport7.0.3的地图较之前的版本，做了很大的优化和改动，需要按照以下方法进行升级：
  • 解决方案
除了将上述的chartmap文件夹拷过去之外，还需更改地图的区域对应关系，即重新设置设计器内置地图区域名称与数据库中区域名称的对应字段，详细操作步骤请查看地图中的地图制作>区域对应设置过程。
6.3 饼图升级
将702升级到703版本，饼图的分类数据丢失；
  • 解决方案
702版本中，饼图数据设置的时候有分类概念，需要给饼图绑定分类轴，而703版本中，考虑到实际的应用需求，删除了饼图的分类概念，故，升级之后，饼图的分类数据会丢失，也无法再给饼图添加分类数据。

7. FR7.0.1版本兼容性及升级指南编辑

FineReport7.0.1较7.0版本，做了一些优化和调整。以下我们详细介绍升级过程中会出现不兼容的地方及相应的解决方案。
强烈建议：升级前对模板和数据进行备份。

具体内容删除原因替代方案
绘图区边框删掉1）没有看到绘图区边框的实际场景 2）不删的话，设置了显示边框后会覆盖网格线或者坐标轴绘图区默认无边框，也不可以添加边框
图例自适应大小的选项删掉1）图例自定义大小要解决的问题是，用户在图例较多的时候，能够显示全部的图例，且图例区的位置不挤压绘图区的位置； 2）但是之前弄的"图例自适应大小"效果奇差，所以决定换一个方案图例区在左右的位置的时候，区域大小固定，图列只显示一列，默认8-10个，图例区有一个箭头，点击箭头可以显示出所有的图例；图例区在上下的位置的时候，按最佳效果显示1行，同样用箭头点开显示所有图例。另外当图例字很多的时候，超出了图例区的宽度，中间用省略号，鼠标移上去可看到全部。
图表标题竖排和旋转的功能删掉1）没有什么用 2）删掉后提升产品稳定性图表标题一律横排，界面上不可以设置文字方向
标签位置“轴内侧”删掉1）设置后效果不好，没什么用不支持轴内侧的界面设置和效果
折线图&&散点图的标签位置，上下左右的设置删掉1）没什么用 2）删掉后提升产品稳定性界面上不可以设置，默认找一个最好的位置放标签
全距图标签位置，删除靠左，靠右1）靠左、靠右跟居中的效果相差不大 2）删掉后提升产品稳定性界面上不可以设置靠左和靠右，支持靠上、靠下、居中
删除图例字体颜色的设置1）标签字体那边，字体类型、加粗倾斜、字体大小只对系统标签有用， 而颜色不仅对系列标签有用，还对图例有用，这边逻辑上有问题。 2）设置标签字体颜色没用不支持系列标签字体颜色的界面设置和效果
所有图表的标题区、图例区，及数据图表的数据表部分的背景删掉图片1）没什么用 2）删掉后提升产品稳定性所有图表的标题区、图例区，及数据图表的数据表部分不支持图片做背景
二维分离饼图和三维分离饼图类型删掉不分离饼图通过设置分离度，可以成为分离饼图，所以不用单独列出分离饼图类型，二者整合到一起。不用单独列出分离饼图类型，二者整合到一起。
饼图分离度设置删掉分离度设置没有用。只要在饼图设置界面添加“是否分离”的选项，界面上不可以设置分离度，分离多少的效果系统默认给。
三维图表删除绘图区的图片1）侧边的图片贴不上去 2）绘图区的背景图片没有什么用不支持三维图表绘图区图片的界面设置和效果
删除非动态的饼图分离1）没有实际应用场景 2）非动态下的分离饼图，表示同时强调所有值，那就等于一个都没有强调。 3）Excel2010也在慢慢引导用户，让用户不要用分离饼图不可以设置饼图分离，只能在动态展示的时候，通过鼠标点击弹出时有分离效果，其他没有分离效果。
数据点提示界面变更 1.股价图数据点提示删除，其他图表类型，数据点提示界面上删除分隔符、系列名和分类名； 2.数据点提示界面上可勾选的只保留值和占比值，默认勾选显示值，同时可以对值和占比值进行样式的设置默认的动态数据点提示都有分类名和系列名，而且分类名、系列名以及系列值的摆放顺序由UI统一设置最佳的效果，所以删去界面上的配置。默认的动态数据点提示都有分类名和系列名，而且分类名、系列名以及系列值的摆放顺序由UI统一设置最佳的效果
删除图表交互属性中的值轴缩放和第二值轴缩放之前的坐标轴缩放功能，做的效果太差，而且支持值轴和第二值轴的缩放，属于理解错用户需求，用户体验很不好。本版本将坐标轴缩放功能做精致了，按照用户的需求，只支持坐标轴的缩放。不支持值轴和第二值轴的缩放，只支持坐标轴的缩放。
参数界面参数默认值的逻辑修改原来的参数控件的控件值需要考虑3层。比如有控件P1 A. 假如有外部传入的参数P1的值为1，则控件P1值为1. B. 假如没有外部传入的P1值，则看是否设置了控件的值。假如控件值不为空，则显示该值。 C. 假如控件值为空，再去取报表内设置的参数P1的默认值。 整个考虑的逻辑对于用户来说过于复杂冗繁。 故删除C的考虑，不再存在控件值为空就取默认值这样一个特殊逻辑。在控件属性表内显示什么就会是什么样的默认值，保证直观。 另外，这样可以去除做为表单的参数界面与报表之间的强关联性，使表单与报表之间的代码间划分更清晰。以前的模板保证兼容，效果一致。 新模板的设计时采用新逻辑，只在控件自动生成时，将参数默认值带入控件的控件值内。 不再保留控件值为空就取参数默认值的逻辑。
关联数据集改成合并数据集之前的关联数据集只能合并数据集和按条件显示数据集，现在的功能更多直接合并数据集兼容7.0版本，按条件合并数据集则不兼容