1.1 内置DEMO更新

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

2.1  SQL: orderby、注释语句

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

2.2 字段类型改变

若在 4.1 中使用直连数据库的数据表，升级到 5.1 后出现表预览失败显示空白的情况，可以比较升级后该表的字段类型与 4.1 中的对应表的字段类型。若出现不一致的情况，可能是由于直连的数据库中数据进行过字段类型的改变。

比如 costtime 字段在升级后的 5.1 工程中被识别成了数值字段，如下图所示：

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

2.3 ETL表名称过长

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

2.4 logdb、finedb取数方式变化

5.1与4.1连接logdb、finedb的取数方式不同，在升级后，需要重新配置。

2.5 手动指定关联

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

2.6 数据迁移、同步数据集

升级前，在4.1工程做了数据迁移或者同步数据集；升级到5.1后，相关的配置内容均仅会写到本地的embed文件夹中，若使用其他数据库，需要在5.1中重新配置数据迁移和同步数据集，5.1可参考配置外接数据库和用户同步数据集；

2.7 直连自助数据集切换

5.1版本由于组件不能从多张表选择字段，这些组件在升级兼容后，会自动生成新的自助数据集。而5.1版本直连的自助数据集性能比较差，此时我们建议优先使用抽取数据的方式，即在升级以后将直连数据库的自助数据集改为数据抽取。

此处提供了批量转换直连为抽取的工具：ajax.html，下面我们介绍一下该工具的使用方法。

• a. 在浏览器打开该html文件，输入对应的URL、token和params，如下图：

  

  URL：该数据决策系统的对应URL，例如：http://localhost:37799/webroot/decision/v5/api/conf/update/table

  token：从数据决策系统访问Cookie获取的fine_auth_token，如下图：

  

  params：isSpider=true

• b. 输入对应值以后，点击下方的submit按钮，执行完成后出现如下图的404报错，则表示执行成功，数据计算模式即切换成功。              

2.8 SQLite 数据连接

SQLite 数据连接创建的 SQL 数据集会更新失败，需要编辑预览之后，再更新才能成功；比如：高级报表业务包中的订单明细表

2.9 FRDemo 数据连接

4.1 如果驱动是空的，升级到 2020-01-15 及以后版本的 5.1 驱动也会是空，会测试连接失败，但是不会影响对应数据连接表的更新；需要手动配置一下驱动。

2.10 更新报错

更新报错：数据集生成错误 - out of row restriction: 1000000，

需要在管理系统>系统管理>常规>BI参数中改大数据访问量参数值。因为多路径场景会更新会触发这个参数，导致更新失败，如下图所示：

2.11 更新报错

更新报错： (不抽取) 表异常标红，如下图所示：

一般是因为所依赖的表或数据库的原始表的字段发生了变化，请重新编辑报错表以适配。

问题原因：数据库中表字段类型改变了；一般是因为所依赖的表或数据库的原始表的字段发生了变化，请重新编辑报错表以适配

解决方案：重新编辑标红的自传数据集，删除标红的过滤条件，重新添加即可。

2.12 星环数据库的表更新失败

星环数据库需要安装隔离插件，详情参见：2020-01-15 版本驱动隔离插件 。

2.13 过滤

没有明确判断结果的过滤（如A+B）在4.1的 ETL 逻辑中可以使用，但是在 2020-01-15 以后的 5.1 版本的自助数据集中此公式被认为是A+B=1。

2.14 服务器数据集部分丢失

升级后服务器数据集部分丢失。

原因分析：工程中有插件：plugin-com.fr.plugin.bi.data.finedb.transfer-4.1.9.zip

该插件导致的服务器数据集丢失，该插件不能在插件管理界面看到，需要在%FineBI%\webapps\webroot\WEB-INF\plugins路径下工程文件中删除。

2.15 Excel 数据集

4.1 的 Excel 表为内存化，升级后会打开内存化的按钮。

3.1 大量仪表板、组件为空

升级后发现系统中大量的仪表板都为空，大量仪表板中都为空白的组件。

解决方案：

• 此时，首先检查工程之前是否有正常抽取数据，即是否进行过全局更新操作；

• 若抽数正常，则继续检查升级前的4.1工程../WEB-INF/resources/fineConf下的各项配置，检查各个xxxxxConfig和xxxxxAnalysis是否内容一致，配置是从配置从Analysis文件中取，因此需要确保xxxxxAnalysis配置正确；若不一致，可将xxxxxConfig内容复制到xxxxxAnalysis中，再进行升级；

  
  

3.2 数值默认分组方式变动

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

升级前4.1中：

升级后5.1中：

3.3 仪表板布局逻辑

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

3.4 通用查询控件过滤的数据不一致

问题现象：

在升级前后，查看仪表板时，发现经过通用查询控件过滤出的数据不一致，如下图：

此时，可以去升级后5.1中的通用查询控件中，查看拖入的过滤字段，并查看组件中拖入的字段，确认两者间是否存在关联关系。

比如，上述例子中，销售出库明细表与销售订单回款汇总表做的这两张表是N：1的关联，组件拖入的是自助数据集关联继承的和销售订单回款汇总表的N：1，与销售出库明细表没有关联；而控件拖的是销售出库明细表的字段；因此控件的过滤字段与组件的字段没有任何关联，在升级后的5.1中，通用查询控件未成功实现条件过滤效果，导致了数据与升级前不一致。

解决方案：

在通过查询控件中，重新选择与组件使用数据有关联的自助数据集字段即可；比如上述例子中，我们为通用查询控件选择自助数据集中对应的字段，如下图：

3.5 计算指标公式不合法

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

3.6 预览报错超多最大行限制

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

解决方案：

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

3.7 过滤后指标为空

问题现象： 

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

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

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

解决方案：

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

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

3.8 默认排序方式变化

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

3.9 明细表展示数据量

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

3.10 未勾选字段

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

注：升级至 2020-01-15 以后的 5.1 版本未勾选字段，若组件为图表类型，则默认会添加至仪表板结果过滤器中，表格类型则按照5.1 是否显示进行兼容，不会显示在结果过滤器中。

3.11 计算指标中的记录数

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

注：升级至2020-01-15 以后的 5.1 版本已支持添加记录数字段。

3.12 过滤结果区别

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

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

3.13 树标签控件

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

3.14 模板跳转

3.14.1 模板 ID 重复

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

3.14.2 跳转传值

4.1中跳转源字段和目标字段选择子表字段，可以跳转，在5.1中跳转字段选择子表字段无法跳转。

3.14.3 网页链接跳转

表升级后绑定分析表，触发原来的跳转到网页链接异常，因为绑定的表不一样，无法获取到原始字段。

3.15 过滤组件值同区间、上一区间

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

注：升级至2020-01-15 以后的 5.1 版本已支持。

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

3.16 分组表合计

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

3.17 横向滚动条

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

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

3.18 全局样式

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

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

3.19 FR模板地图组件

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

3.20 百分比仪表盘颜色

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

3.21 未生成dashboards文件夹

在升级之后，发现在../webroot/WEB-INF下没有生成用于存储模板的dashboards文件夹，且报错如下：

[ERROR]Special char prohibit! com.fr.decision.webservice.exception.general.SpecialCharProhibitException: Special char prohibit! at com.fr.schedule.feature.service.v10.ScheduleTaskService.addTask(Unknown Source) at com.fr.decision.v10.upgrade.action.schedule.ScheduleUpgradeAction.transferScheduleTask(ScheduleUpgradeAction.java:211) at com.fr.decision.v10.upgrade.action.schedule.ScheduleUpgradeAction.processUpgrade(ScheduleUpgradeAction.java:108) at com.fr.decision.v10.upgrade.action.AbstractUpgradeAction.upgrade(AbstractUpgradeAction.java:45) at com.fr.decision.v10.upgrade.UpgradeContext$3.run(UpgradeContext.java:184) at java.lang.Thread.run(Thread.java:748) [ERROR]Special char prohibit! com.fr.decision.webservice.exception.general.SpecialCharProhibitException: Special char prohibit! at com.fr.schedule.feature.service.v10.ScheduleTaskService.addTask(Unknown Source) at com.fr.decision.v10.upgrade.action.schedule.ScheduleUpgradeAction.transferScheduleTask(ScheduleUpgradeAction.java:211) at com.fr.decision.v10.upgrade.action.schedule.ScheduleUpgradeAction.processUpgrade(ScheduleUpgradeAction.java:108) at com.fr.decision.v10.upgrade.action.AbstractUpgradeAction.upgrade(AbstractUpgradeAction.java:45) at com.fr.decision.v10.upgrade.UpgradeContext$3.run(UpgradeContext.java:184) at java.lang.Thread.run(Thread.java:748)

解决方案：

该问题是由于定时调度任务的名称中有非法字符导致的，需要进入管理系统>定时调度，将任务名称中的非法字符删除，比如空格。定时调度任务名称允许输入的字符为：字母、汉字、数字和“_”、“.”。

3.22 详细设置组件

升级后详细设置界面的组件顺序可能不同。

3.23 计算数据格式

4.1数据中有N/0的数据，指标做过滤0至无限制，不包含N/0的数据；升级后N/0变为无穷，过滤会多出无穷的数据，如下图所示：

3.24 数值维度分组

1）数值维度分组在 4.1 和 5.1 中的默认分组不同，添加过滤后升级会导致数据总体结果不一致，在升级后需要手动调整数值分组即可解决。

2）数值字段设置不同分组，升级后相同字段相同分组方式(自动分组和手动区间分组是相同一类, 和相同值为一组为不同一类) 的配置只保留前面的。

3.25 过滤

3.25.1 过滤后分组

4.1中先设置过滤条件，再设置分组方式后升级，在5.1中没有对应数据显示，因为5.1中分组后的过滤只能选到分组名，不能选到对应字段，无法兼容，手动调整后可解决。

3.25.2 维度过滤

添加维度过滤，其中最后为“或公式过滤”，但不输入具体公式内容，在4.1中为之前的过滤不生效，如下图所示：

升级后在5.1中为此“或公式”不添加的效果，如下图所示：

3.25.3 过滤组件绑定同表的不同字段

有A、B两个过滤组件绑定了同表不同字段，A 先设置过滤值，B 再全选后取消勾选部分值。升级到5.1后可能两个组件兼容为绑定各自的控件表，导致组件间不会相互影响，B显示勾选的值会比 4.1 多，但是过滤结果是一样的。

3.25.4 树过滤组件

树控件升级后不生成控件表，故过滤无效。

3.25.5 明细表一个字段添加多次并设置过滤

明细表一个字段添加多次，设置相同过滤条件，过滤条件会重复多次（维度过滤会合并条件, 不做去重）。

3.25.6 过滤与排序同时使用

文本维度根据指标排序，文本维度选择前N个。

4.1中：过滤受排序影响，结果显示的是排序后的按指标大小选择的前n个；

5.1中：过滤不受排序影响，结果显示的是文本维度筛选前十个，然后按指标大小排序，如下图所示：

3.26 指标维度格式

1）4.1 指标的数值格式有单位，升级后不显示；因为5.1调整名称后的指标不显示单位。

2）4.1 因为关联升级到 5.1 后多了一个空维度，模板就会出现一行空数据。

升级前如下图所示：

升级后如下图所示：

3）设置了数值格式为百分比，升级后指标的名字中的%丢失：升级后因为存在表名字段名出现变化的情况，所以都会做成显示名 ，显示名会覆盖掉设置的%。

3.27 字段标红

升级前有字段标红，字段有无法关联匹配，升级后会随机选取一个基础表来升级组件（与配置先拿到哪个表的配置有关系），升级后会存在字段丢失的情况。

3.28 自由布局组件

4.1自由布局组件有重叠，升级后4.1的默认组件层级规则升级时候无法兼容, 因为序列化无法获取到 ID 的顺序，所以组件的重叠层级会不同。

3.29 公共主表模型

1）公共主表模型升级后的控件过滤效果可能无法生效。

2）公共子表模型，时间字段的精度到毫秒级别，升级后生成的时间控件表的时间是年月日时分秒，时间控件过滤这一部分(带毫秒的)是直接计算不到的。

4.1 普通用户创建的业务包

在4.1中普通用户创建的业务包，升级至5.1后，需要管理员将业务包的管理权限重新分配给该普通用户，参考业务包权限管理；

4.2 数据连接权限

在4.1中分配给普通用户的数据连接权限，升级至5.1后，需要管理员重新分配。数据连接权限分配可参考数据连接控制；

4.3 链接形式挂出的仪表板

在4.1中以链接形式挂出的仪表板，升级到5.1中不再支持。升级后5.1工程目录中不显示的仪表板，去4.1中查看是否是以链接形式挂出的，若为链接挂出则在5.1中重新配置，参考目录管理；

4.4 普通用户分享给我的模板

5.1普通用户分享给我的模板，不受用户权限影响，4.1会受普通用户权限影响，升级后按照5.1的逻辑展示；

注：升级至2020-01-15 以后的 5.1 版本被分享用户看到的数据和 4.1 一致 ，升级至 2020-04-03 以后的 5.1 版本分享弹窗的使用制作者数据权限未勾选，即被分享用户打开模板仍然是按照查看者权限展示数据。如下图所示：

4.5 使用模板 ID 

升级前的 4.1 模板 ID 在升级后会增加前缀，例如 old-platform-    reportlet-entry-    url-entry-   folder-entry-      file-entry-。此时，若用户将升级前的 4.1BI 模板与其他系统做了集成，那么原先取用的模板 ID 需调整。

注：角色 ID 相关也会在升级后产生前缀，调整同模板 ID 调整方式。

4.6 分级授权

4.1 在管理系统>权限设置中打开分级授权，给用户配置了数据配置的权限，升级到 2020-01-15 的5.1 版本默认为数据使用权限，如有需要，需要重新配置数据管理权限。如下图所示：

4.7 分享模板

4.1 只有普通用户可以分享模板，升级到 2020-01-15 及以后版本的 5.1 超级管理员和普通用户都可以分享模板，并且支持分享文件夹。

升级后的文件夹以及新增的模板，都是默认按照制作者权限分享的模板，且提供数据权限勾选框，可通过"使用制作者数据权限”的勾选框勾选与否，来实现是按制作者还是查看者权限分享模板。 如下图所示：

4.8 所有职务

4.1 中勾选了“所有职务”这一权限，升级到 2020-01-15 之后的 5.1 版本后，删除了“所有职务”这个职位，这个职位在原来4.1的系统里，等效于某一个部门底下的所有的具体职位，所以升级的时候会把权限分散各个职位上去。

4.9 权限配置

权限配置界面数值字段相关的都会变成 double ，比如 1 会变成1.0，只是显示问题，并不影响使用，原因是 4.1 和 5.1 对于这块的处理逻辑不一样。

5.1 升级后部分模板丢失

升级前用户 A 创建模板并挂出模板，删除用户 A ，挂出目录的模板还在。

升级后用户没有，这些挂出的模板也无法被读取，升级后的挂出目录里面就没有这些模板。特殊情况，正常而言4.1删除用户挂出的模板也会被删除，如果有需要，可以将这些模板用管理员重新挂载目录。

5.2 升级后数据连接创建者为空

升级至 2020-01-15 的 5.1 版本，数据连接的创建者可能为空。

6.1 全局样式

4.1里仪表板背景勾选了图片，但没有上传图片，读的是预设样式的主题色深色,升级后，主题色为浅色。效果变动，需要手动切换一下仪表板样式。如下图所示：

6.2 cube 数据为空

升级之后要加非空过滤。

6.3 排序

直连4.1默认使用 JAVA 默认排序，cube是拼音排序
如果没有直连或者直连 4.1 系统配置里没有配置,，那么会按默认值到5.0就是不按拼音排序，需要手动配置。

6.4 地图

用户工程目录中挂出 FR 的模板，且模板中包含地图组件，需要手动将4.1%FineBI%/webapps/WebReport/WEB-INF/assets/map/geographic 中 JSON 文件拷贝到5.1的

%FineBI%/webapps/WebReport/WEB-INF/assets/map/geographic 下（与world平级）

如下图所示：

6.5 添加计算指标

4.1添加计算指标，输入数值，升级后，计算指标加了聚合函数sum_agg(数值),不能再修改计算方式，即显示的是对所有的维度的汇总值。应该在计算指标中直接输入数值，然后在分析区域修改计算方式为求平均，就可同4.1的展示效果 。

6.6 背景图片样式

样式背景选择图片但没有上传图片，升级后会走颜色的逻辑(透明)。

6.7 百分比仪表盘的颜色

4.1里的自动是有3个颜色区间，指标值在哪个区间图形就会显示对应的区间颜色。

升级后的数据，指标字段会添加至颜色属性中，目前的处理逻辑是区间渐变的自动，会根据指标值自动划分5个区间，所以升级后的仪表盘有5个色阶。

如果客户不能接受5个色阶，可以进行手动调整：将颜色中的指标字段拖拽至细粒度中，然后点开颜色弹窗，进行颜色设定。

6.8 地图经纬度

4.1的地图使用了文本字段类型的经纬度字段，升级后，需要手动调整字段类型，将文本类型调整为数值类型。如下图所示：

6.9 区间分组

如果在4.1中区间分组有重叠，升级后需要手动调整。

6.10 范围面积图

范围面积图升级后不展示图例，可手动调整。

6.11 组件布局

组件布局是按配置里的设置值升级上来的, 不能完全保证效果一致，可手动调整。

6.11 饼图

饼图百分比升级之后是根据指标百分比计算的，如果数据展示有负值，需要手动调整 。

升级前如下图所示：

升级后如下图所示：

6.11 不兼容

1）当前维度的指标百分比不兼容。

2）4.1指标使用区间分组设置后，作为分类使用，5.1不兼容。

7.1 数据迁移插件

4.1安装过数据迁移插件的工程，在升级至 5.1 后，需要将该数据迁移插件删除。5.1 中不需要该数据迁移插件了，可至%FineBI%/webapps/webroot/WEB-INF/plugins中删除；

7.2 工程启动不了

若升级后，工程启动不了，可至工程目录%FineBI%/webapps/webroot/WEB-INF/lib下查看是否有Hive的连接驱动jar包：hive-jdbc-1.2.1000.2.5.3.0-37-standalone.jar，若包含该jar，可参考Hadoop Hive数据连接重新下载驱动替换原先的jar包进行连接，如下图所示：

7.3 单点登录

在 4.1 中若做过单点登录的，在升级后的5.1工程中，需要先将单点登录删除，否则工程启动后无法登录成功。单点登录删除的操作为：

修改 finedb 里面的 fine_conf_entity 表，将AppearanceConfig.loginType改为0；（修改操作参考如何使用第三方管理软件连接报表内置hsql数据库finedb）

7.4 用户无法登录

7.4.1 升级至 5.1

升级后，数据决策系统除了管理员外，其他用户都无法登录。可能原因是使用了同步数据集且开启MD5加密，而4.1 版本 FineBI 内置的 MD5 加密方式不区分密文大小写，5.1 版本 FineBI 适配的 MD5 加密方式区分大小写。FineBI 升级后会内置一个小写MD5的 class，如果用户使用的是大写密文，升级后就不能登录，需要手动替换大写 class：

1）点击下载class 文件：MD5UpperCasePasswordValidator.rar；

2）将该class文件放入工程目录%FineBI%\webroot\WEB-INF\classes\com\fr\decision中；

3）进入管理系统>用户管理>全局设置，在用户同步数据集下选择加密方式，重新选择上述添加的类并点击保存，触发同步后，用户即可登录；

7.4.2 升级至 2020-01-15 的5.1版本

普通用户无法登录问题：使用普通用户无法登录，客户在4.1工程中使用了自定义加密的方式，升级后上无法登录。

1）需要将encrypted.zip 中的 class 文件放到工程目录下：%FineBI%\webroot\WEB-INF/classes/come/fr/privilege；

2）在管理系统>用户管理>编辑同步用户数据集>加密方式处，选择该路径下的该文件即可。如下图所示：

7.5 升级日志报错：NonUniqueObjectException

7.5.1 问题现象

4.1 版本升级 5.1.2，因为 4.1 有脏数据导致，升级有问题。升级日志里有关键报错：NonUniqueObjectException，如下图所示：
具体原因：Caused by: com.fr.third.org.hibernate.NonUniqueObjectException: A different object with the same identifier value was already associated with the session : com.fr.decision.authority.entity.AuthorityObjectEntity#old-platform-folder-entry-100

7.5.2 原因说明

根据具体原得出，「old-platform-folder-entry」这个表里，有个 id 为 100 的是重复值。

7.5.3 解决方案

在 finedb 中找到对应的表「FR_FOLDERENTRY」删掉重复的记录，使得 id=100 的只有 1 个。然后重新升级。
注：每次为空的报错，不一定都是这个表有重复数据，有可能有其他表，要看 NonUniqueObjectException里对应的具体信息。