1. 内置DEMO更新：

           若升级工程包含4.1的内置DEMO，升级后进行数据更新，会报错如下，该问题不影响5.1正常使用，为4.1内置DEMO的配置bug，忽略即可。

1. SQL orderby 、注释语句：

           SQL数据集中若使用了orderby 、注释等5.1不支持的语句，若非ETL表，需要在升级后的5.1工程中修改；若为做了ETL操作的表，因为升级后仅显示为结果集，因此需要在升级前的4.1工程中做修改，去掉不支持语句；

2. 字段类型改变：

           若在4.1中使用直连数据库的数据表，在升级到5.1后，表预览失败显示空白的情况，可以比较升级后该表的字段类型与4.1中的对应表的字段类型。若出现不一致的情况，可能是直连的数据库中数据进行过字段类型的改变。比如下面的costtime字段在升级后的5.1工程中识别为了数值字段：

           但是原始的4.1工程中的字段类型为文本字段。若为数据库中字段类型的变化，我们需要在5.1工程中对该表点击编辑，进入表编辑后重新获取数据进行预览；

3. ETL表名称：

           升级后，仪表板字段显示均为空，如下图。可去4.1工程下查看升级前该仪表板使用的是否为ETL表，使用的字段是否过长，超多100后可能由于名称太长导致配置无法保存。该问题需要在升级后的5.1工程中，手动重新添加该表，并重做该仪表板。

4. logdb、finedb：

           5.1与4.1连接logdb、finedb的取数方式不同，在升级后，需要重新配置，5.1可联系技术支持获取连接取数方式；

5. 手动指定关联：

           升级后，在5.1中若组件显示为空组件，则可去该组件对应的4.1工程中，查看是否组件添加的是手动指定关联的字段。目前这种情况升级至5.1暂时不支持，需要为添加的字段在业务包中添加关联，再至组件中手动添加指定字段；

1. 数值分组：

           4.1维度中数值字段默认分组方式是自动，升级后在5.1中，维度中数值字段默认分组方式是自定义，此处需要在升级后的工程中手动调整；

           升级前4.1中：

           升级后5.1中：

2. 仪表板布局：

           4.1的布局逻辑和5.1的布局逻辑不一致，需要手动调整一下，5.1的仪表板布局逻辑可参考仪表板布局;

3. 通用查询控件：

4. 计算指标公式不合法：

           若计算指标公式中存在==null，在升级后会提示该公式不合法，如下图，需要将其手动修改为==0。

5. 仪表板预览报错：

            升级后，仪表板在预览的时候报错：out of max row size limitation，如下图：

            此种情况，可以去管理系统>系统管理>常规中，修改数据访问量的值，如下图：

6. 过滤后指标为空：

          问题现象： 

          升级后，在5.1中分组表显示数据为空，如下图，但是该组件使用的表在业务包中数据显示正常，且在升级前的4.1工程中数据也显示正常。

          此时，可以查看该分组表中的指标是否添加了过滤条件，若添加了过滤条件，如下图：

          
           检查在该过滤条件下的指标是否存在，若不存在，则在5.1下，分组表中就不会显示过滤后指标为空的字段。

           解决方案：

           此时，我们可以为该组件新增一个没有过滤条件的字段，添加至结果过滤器中，如下图：

           注：目前升级工具默认升级至2019.3.5的5.1stable版本，不支持直接添加字段不勾选。在3.28之后的5.1版本中，可直接支持添加字段不勾选；

7. 排序方式：

           4.1中默认按照中文排序，而5.1中默认为ASCII排序，工程在升级后都会按照5.1的逻辑进行排序，若需调整，可至管理系统>系统管理>常规下，开启中文排序，重启FineBI并重新进行数据更新。

8. 明细表展示数据量：

           在升级后的5.1工程中，明细表默认展示1000条数据，升级后需要手动调整展示的数据量。在仪表板的明细表编辑页面，在组件样式>格式>总行数处，调整展示数据量，如下图，且5.1中编辑状态下最多展示10000条，预览时抽取数据展示全部数据，实时数据仍然展示设置的总行数。

9. 未勾选字段：

           在4.1仪表板维度和指标中未勾选的字段，升级后默认会添加至5.1仪表板的结果过滤器中，如下图，升级后可视情况进行调整。

10. 计算指标记录数：

           5.1中计算指标公式中不再支持添加记录数字段，对于4.1中已添加的计算指标需要修改公式，可参考COUNT_AGG使用；

11. 过滤结果区别：

           当时间维度过滤条件为“不属于”，且不选择过滤值时，4.1显示全部数据，5.1则显示空；

           当时间维度过滤条件为“不属于”，4.1的过滤结果不包含空值，5.1则包含；

12. 树标签控件：

           在4.1中，树标签控件支持完全不相关的表放在一起，这种情况升级到5.1是选一个单表来升级字段，在此表找得到字段的就会展示，找不到就不会展示；

13. 模板跳转：

           老一些版本的4.1，BI模板的id是可以重复的(同用户的模板不重复)。这种情况在升级后，可能出现跳转无法找到对应的模板实际应该是哪个的情况，这种情况需要在5.1中重新配置模板跳转，可参考组件跳转;

14. 过滤组件值同区间、上一区间：

            在4.1中为指标字段添加的，属于过滤组件值（日期控件）的相同步长的上一区间和同一时间段，如下图，在5.1中不支持；

            同样，该种情况下按照组件值的同一区间、上一区间，在升级后也不支持；

15. 分组表合计：

          分组表中的合计，记录数按字段记录，这里的合计默认在升级后，为自动合计，可能和4.1直连的合计值不一致；

16. 横向滚动条：

           5.1页面无横向滚动条，4.1原来存在横向滚动条的模板升级后无横向滚动条，可能组件大小变小了，但是相对位置不变。

           需要在升级后视情况调整组件布局位置，5.1的仪表板布局逻辑可参考仪表板布局;

17. 全局样式：

           升级后，仪表板原先为深色，升级后变为浅色了。此种情况下，可以查看4.1工程中，该仪表板背景是否勾选了图片，但没有上传图片。

           此种情况下载4.1中读的是预设样式的主题色深色，升级后，主题色为浅色，效果发生了变动。需要在5.1中手动切换一下仪表板样式；

18. 地图：

           若在升级前的4.1工程中挂出了FineReport的模板，且该模板包含了地图组件，则在升级后，需要手动将4.1工程目录%FineBI%/webapps/WebReport/WEB-INF/assets/map/geographic中的json文件拷贝至5.1工程%FineBI%/webapps/webroot/WEB-INF/assets/map/geographic中；

19. 百分比仪表板颜色：

           百分比仪表板在4.1中自动为三个颜色区间，指标值在哪个区间图形就会显示对应的区间颜色；升级至5.1后，指标字段会添加至颜色属性中，会根据指标值自动划分5个区间，所以升级后的仪表盘有5个色阶，如下图。若不想要五个颜色区间，可至组件中颜色属性下手动调整；