1. 概述
1.1 功能简介
FineBI 5.0 化茧成蝶，焕然一新，进化幅度如同 iphone7 到 iPhoneX，将企业级自助式 BI 工具提升到一个新的高度。
因此由 4.1 版本直接升级到 5.1版本，有很多地方无法兼容，在升级时需要注意。
本文将对不兼容的地方做详细说明，以下不兼容部分，在进行升级 5.1 时，大部分会以一定形式保留，对应的具体变化待后续更新。
1.2 注意事项
因 2019.01.15 已发布 FineBI5.1 版本，因此当前提供的升级工具将跳过5.0版本，直接升级至 5.1 版本，但 5.1 的功能在交互及视觉上与下述截图可能有稍许区别。
2. 数据准备
2.1 业务包
1）（重要问题）业务包复制功能不兼容，只保留原始业务包。
升级前：
行业数据下的销售 DEMO 业务包为原始业务包，功能数据下的销售 DEMO 业务包为复制过来的业务包，在升级后，将只保留行业数据下的销售 DEMO 业务包。如下图所示：
升级后：
2.2 数据表
1）（重要问题）4.1业务包中所有的ETL结果表升级后转成特殊类型的基础表，计算逻辑与4.1基础表一致，但不会还原具体ETL步骤，也不能对步骤进行修改。但仍符合数据库表基础表特征，可以对该表进行后续操作；
升级前：
升级后：（直接为处理后的结果集，不再保有中间步骤）
2）（一般问题）4.1设置未参与分析的的字段在5.0中也正常显示；
升级前：
升级后：
3）（重要问题）数据更新的增量修改功能在 5.0 中需要通过增量增加和删除组合实现，不能直接使用；
升级前：
升级后：
3. 仪表板
3.1 组件
1）（一般问题）功能维度表，多个不同子表的组件分析5.0没办法很好的支持，将会兼容为结果集级，为汇总后的数据值，结果集组件不能支持明细数据的过滤，联动等。维度指标不勾选的字段，会兼容到组件的结果过滤器里。
比如由店名与销售额、毛利组成的图表，如下图，因为来自不同的子表，则升级后的数据兼容为按照店名汇总后的销售额和毛利，不再保存有明细数据。
升级前：
升级后：
2）（一般问题）5.0 不支持组件中维度字段不勾选。钻取的设置发生了较大变化，因此原有钻取层级不兼容用户在升级后需要重新根据需求定义钻取层级；
升级前：
升级后：
3）（一般问题）2020-01-15以后的 5.1 版本不支持图表组件中指标字段不勾选，在图表组件中未勾选的指标需要重新设置，但支持表格组件中指标字段不勾选。
升级前图表组件：
升级后图表组件：
升级前表格组件不勾选的字段，升级后兼容。
4）（一般问题）5.0 的同期环期计算逻辑有较大调整，按照实际数据计算，5.0 中的详细计算逻辑可参考 同比/环比（快速计算） ；
升级前：
升级后：
5）（重要问题）5.0不支持复杂表，升级后将变为交叉表；
升级前：
升级后：（数据呈现为交叉表）
6）（一般问题）4.1 中组件属性下的联动传递过滤条件功能，在 5.0 中仅分组表有该按钮，其他表格及图表均没有，联动功能在 5.0 中为单独的 联动设置 ，支持单向联动配置；
升级前：
升级后：（普通图表无该选项）
分组表支持勾选；
3.2 过滤组件
3.2.1 多表过滤字段
（重要问题）5.0 的过滤组件不支持来自多个表的字段，因此升级后的效果和原始 4.1 效果可能有出入；
升级前：
升级后：（为空，需重新配置）
3.2.2 日期过滤组件
（一般问题）如果升级后需要使用 节假日智能过滤 来实现动态时间过滤，需要在%FineBI%\webapps\webroot\WEB-INF\assets\extdata目录下放置需要的节假日文件，可通过删除或者增加日期，来实现节假日自定义。如下图所示：
详细设置请参见：节假日智能过滤 。
3.2.3 树过滤控件
树控件使用多张表字段时，若仪表板的树控件绑定多个字段，可能有部分过滤失效。
3.3 图表
1）（一般问题）针对图表属性设置中的数据表格功能在5.0中不再支持；
升级前：
升级后：
2）（一般问题）5.0中不再支持数目大于两个的多值轴。
升级前：
升级后：
3）（一般问题）4.1指标字段的下拉选项中，针对特殊值的'数据标签样式'中设置的图片标签不再支持；
升级前：
升级后：
4）（一般问题）在4.1中针对面积图，曲线和垂直的线型设置不支持，5.0中仅支持折线；
升级前：
升级后：
3.4 函数
1）相比 4.1 版本，5.1 对函数做了优化，删除了部分用不到的旧函数，新增了部分函数，详细函数列表可参考 5.1函数更新日志；
在升级后，对于部分删除的旧函数，在 5.1 中还是可以使用，但是在函数面板不能选择。
2）5.1 中 BI 支持的函数，写法上只支持函数名全大写和全小写的情况，例如MIN()合法，min()合法，Min()非法；
3）5.1 中 BI 不支持单引号，BI使用的 jep 框架目前不支持单引号，如果使用会导致公式不合法；
4）5.1 中 BI 的文本常量一定要用双引号括起来，数值常量统一解析为了 Double 类型，如果使用的自定义函数内部对参数做处理的时候需要注意这点。且在 5.1 中，一些自定义的常量如 null，false，true，这些常量是以默认变量的形式添加到jep内部的，可以直接使用。而关于布尔类型，BI 统一使用 0 和 1 表示的，1 代表 true，0 代表 false 。
3.5 仪表板界面
1）（一般问题）在升级至 5.1 后，仪表板预览界面不支持自定义分组功能，该功能改至组件编辑界面，点击对应维度字段即可展开下拉框，选择自定义分组。
升级前：
升级后：
2）在升级至 5.0 后，仪表板预览界面不支持原图表切换为分组表、交叉表和复杂表。如下图所示：
升级前：
升级后：不支持该功能。
4. 权限控制
4.1 数据连接权限
若升级前的 BI4.1 版本进行了 FineReport集成到FineBI 操作，升级至 5.1 版本以后，在管理系统<权限管理中配置的数据连接权限自动分配的是 FineReport9.0 的数据连接权限，而非之前 FineBI4.1 配置的的数据连接权限。此时需要用户手动在管理系统<权限管理<数据连接控制 中重新配置权限。
4.2 仪表板分享下的数据权限
1）4.1 仪表板分享给其他用户，需为被分享用户分配数据权限，被分享用户才能查看该仪表板数据，否则提示暂无权限查看该组件数据。
2）升级到 2020-04-03 之后的的 5.1 后，看到的数据和 4.1 一致，分享弹窗的使用制作者数据权限不勾选，即用户仅能看到自己权限下的数据。例如，Alice （夏梅）用户将新建仪表板分享给 Anna，且 Alice 用户拥有新建仪表板内相关数据的使用权限，如下图所示：
此时， Anna 用户若没有该仪表板内数据的查看权限，则不能看到被分享的仪表板的数据，如下图所示：
5. 其他
1）早期 4.0.2 及其之前版本的的螺旋分析功能在 5.0 中不兼容，不能使用；
2）4.1的 Excelview 功能在 5.0 不兼容，不能使用；
3）5.1 与 4.1 连接 LogDB 和 FineDB 的取数方式不同，未进行兼容。若在升级后使用，需要重新配置。可新增用户访问日志业务包，通过 程序数据集 方式添加模板执行日志和平台管理日志到业务包中。
4）关于 LogDB 的获取，可以参考 报表日志 LogDB 数据库 。
6. Web页面集成
1）5.1 与 4.1 中提供的嵌入式集成接口和集成方式也发生了变化，未进行兼容。
在升级成功后，需要进行接口的调整，5.1 中使用可参考 Web页面嵌入式集成 。
