BI5.x版本适配FR10.0/11.0维护策略公告

1.1 版本维护策略

FineReport 在 2021 年 10 月发布了 11.0 ，我们在 BI 5.1.19 版本开始对 FR 11.0 版本进行了适配，版本号为 5.1.19+ 版本。

与此同时，由于仍有大量客户继续使用依赖 FR10.0 版本的FineBI，所以我们后续也同时维护适配 FR10.0 的版本，版本号为 5.1.18.x 版本。

所以后续 BI 将会有两个 5.x 版本同时维护和发布，即：

• 5.1.18.x 版本（5.1.18.22，5.1.18.23，5.1.18.24……）：适配 FR 10 

• 5.1.19+ 版本（5.1.19，5.1.20，5.1.21，5.1.22……）：适配 FR 11  

意味着 5.x 版本客户可以按需同步配套使用 FR10.0/FR11.0 ，均对其进行维护。

1.2 升级策略及建议

BI 升级团队升级 5.1.x 版本时将主推 5.1.18.x 版本（适配 FR 10），但不严格限制，如果有其他必要原因也可以升级 5.1.19+ 版本（适配 FR 11）。

同时，也建议客户优先升级到 5.1.18.x 版本（适配FR 10），如果客户已经购买并使用了FR11版本，且需要配套使用BI，则可以推荐客户升级5.1.19+版本（适配FR 11），升级注意事项见下一部分。

2.1 升级路径

从 5.1.18 版本之后分出 2 个小版本，分别适配FR10及FR11，升级路径如箭头所示：

5.1.18 版本，可以选择以下两种升级方式

1. 5.1.19+  ，在该路径上可以按序升级（5.1.18 → 5.1.19 → 5.1.20 → 5.1.21 → ……），可以跳跃升级（例如 5.1.18 → 5.1.20）

2. 5.1.18.x  ，在该路径上可以按序升级（5.1.18 → 5.1.18.22 → 5.1.18.23 → 5.1.18.24 → ……），可以跳跃升级（例如 5.1.18.22 → 5.1.18.24）

2.2 升级方式

升级 5.1.19 及往后版本必须使用升级工具（详情请见：FRBI升级工具(适配FR11)），且升级后 lic 会失效，必须更换 11 版本的 lic ；

若已升级到适配 11.0 的版本，则直接换 jar 升级即可。

工具适配版本

FRBI升级工具(11.0.1+5.1.19)

5.1.15（jar日期为：2021.08.05）至5.1.18版本才可以使用此工具；如果是5.1.15之前的版本，需要将工程先升级到 5.1.15 至 5.1.18 之间的任意版本，再使用从工具升级；

FRBI升级工具(11.0.2+5.1.20)

5.1.5（jar日期为：2020.08.07）至5.1.18版本均可以使用此工具；

FRBI升级工具(11.0.3+5.1.21)

5.1.5（jar日期为：2020.08.07）至5.1.18版本均可以使用此工具；

FRBI升级工具(11.0.4+5.1.22)

5.1.5（jar日期为：2020.08.07）至5.1.18版本均可以使用此工具。

注：升级工具仅维护到5.1.22-2022/04/29版本，若客户需升级2022/04/29以后的5.X版本，需先升级到任意5.1.19及以后版本，再换jar升级。

2.3 其他事项

1）适配不同 FR 版本的 BI 版本间不能交叉升级，例如 5.1.18.22 可以升级到5.1.18.23，但不能升级到 5.1.23 ；

2）6.0 版本发布后，5.1.x 版本（包括 5.1.18.x，5.1.19+）均可直接升级 6.0 版本。

3.1 通用注意事项

• 【必做】从低版本升级到高版本：中间的每个版本注意事项都得过一下；

• 【必做】必须备份好webroot（配置了外接数据库同时备份平台配置）；

• 【必做】由于BI 5.1.18版本适配FR 10.0版本，BI 5.1.19版本开始适配FR 11.0版本，升级5.1.19及往后版本必须使用升级工具，且升级后lic会失效，必须更换11版本的lic；若已升级到适配11.0的版本，则直接换jar升级即可。详见本文 2.2 节；

• 【必做】BI 5.1.26及5.1.18.26版本

• 【选做】 h2-1.4.192.jar 存在高危漏洞 CVE-2021-23463 ，若未使用 demo 库可自行替换最新版本的 h2 驱动，若客户有使用 h2 1.x 的数据库，升级到 2.x 存在兼容问题，需要重新生成库或者自行评估是否替换；

3.2 5.1.18之前版本

5.1.15

5.1.15版本直连部分null计算逻辑改动：

1）计算逻辑
空字符与null值分开计算处理；
null参与四则、函数计算时结果都返回null；
补充不等式的逻辑：做不属于/不等于/不包含等过滤计算时结果不会包含null。

2）公式兼容插件
插件：BI定位分析工具（区别spider兼容操作）
逻辑：对升级前存在的数值类型的四则运算公式进行修改兼容， 例如：sum_agg(A) + 1 , 变为 NVL(sum_agg(A), 0) + 1.0；
操作：升级后安装插件，并通过访问如下接口从而实现公式兼容
数据集：http://IP:端口号/webroot/decision/url/tools/direct/function/update/conf
仪表板: http://IP:端口号/webroot/decision/url/tools/direct/function/update/dashboard
风险：使用兼容插件会改变之前的公式，不会对新做模板的公式产生影响；改变公式不可逆，兼容之前做好备份

          如需要实现与5.1.15版本计算结果兼容，需要升级工程至5.1.18版本并使用BI定位分析工具进行兼容处理。

3.3 5.1.18升级5.1.18.x(FR10.0)

5.1.22

• 需要删除「字段分组」插件

5.1.21

• 升级工具使用：5.1.5（jar日期为：2020.08.07）至5.1.18版本均可以使用此工具：FRBI升级工具(11.0.3+5.1.21)

5.1.20

• 升级工具使用：5.1.5（jar日期为：2020.08.07）至5.1.18版本均可以使用此工具：FRBI升级工具(11.0.2+5.1.20)

5.1.19

• 升级5.1.19版本，使用sqlserver外置库的客户首次启动会慢，建议切换内置库升级后再迁移，或换mysql/oracle外置库。；

• 升级工具使用：5.1.15（jar日期为：2021.08.05）至5.1.18版本才可以使用此工具；如果是5.1.15之前的版本，需要将工程先升级到5.1.15至5.1.18之间的任意版本，再使用从工具升级。

3.4 5.1.18升级5.1.19+(FR11.0)

5.1.18.22

• 需要删除「字段分组」插件

使用升级工具升级步骤详情请参见文档：FRBI升级工具(适配FR11)