历史版本3 :FineReport 集成到 FineBI 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1、描述编辑

在实际使用过程中存在需要将FineReport工程集成到FineBI数据决策系统上使用的情况，该如何操作呢？下面我们将分别介绍FR工程为空（即没有模板）和不为空情况下的集成步骤。

2、FR不为空，BI不为空编辑

2.1 确定FineReport版本

首先查看FineReport的版本（可以通过管理系统>注册管理查看FR的版本，如下图）。FineReport若为8.0版本，需要与FineBI4.0.2版本工程匹配；若FineReport为9.0版本，需要与FineBI4.1版本工程匹配；若FineReport为10.0版本，需要与FineBI5.0版本工程匹配。且不仅需要大版本匹配，小版本jar日期也需要一致，否则可能存在问题。若版本不匹配需要升级，可以参考FineReport升级指南。

222

2.2 确定FineBI版本

查看FineBI的版本，检查方法与FineReport相同，都是在注册信息中查看版本，如果版本不一致需要升级的，升级方法见FineBI升级指南。或者使用新安装的FineBI5.0/4.1/4.0.2版本。

注：FineBI4.1暂时不能升级至5.0，待后续更新，目前仅能新安装5.0版本。  


2.3 文件拷贝

1）确保FineBI和FineReport的jar包同步之后，将FineReport安装目录..\WebReport\WEB-INF\lib下的所有jar包拷贝至FineBI工程目录的..\WebReport\WEB-INF\lib文件夹中（若有相同的jar包，保留原先FineBI里的不替换），如下图中所示为拷贝后的FineBI lib文件夹：

222

2）将FineReport安装目录..\WebReport\WEB-INF\plugins下的所有文件拷贝至FineBI目录..\WebReport\WEB-INF\plugins下，若有相同的文件，保留BI的不替换。

222

3）embed文件夹里面存储了数据决策系统中除平台属性配置以外的所有信息，包括目录树设置、模板定时任务信息等，若要在集成后的系统中保留原先FineReport中的配置信息，那需要将FineReport安装目录..\WebReport\WEB-INF下的embed文件夹拷贝至FineBI目录..\WebReport\WEB-INF内替换BI原先的文件夹。若想保留FineBI的设置信息，则这一步可不操作，即不替换embed文件夹。

注：若FineReport中的finedb做过迁移操作且想保留，则可将迁移的路径直接指向FineBI，将finedb数据迁移过来。若FineBI中的finedb做过迁移操作且想保留，则不更改即可。

4）logs文件夹是FineBI日志监控开启之后保存日志的内置数据库。因此用户若想保留FineReport系统中的日志数据，则需要将FineReport安装目录..\WebReport\WEB-INF下的log文件夹拷贝至FineBI目录..\WebReport\WEB-INF内替换BI原先的文件夹。若想保留FineBI的日志信息，则这一步可不操作，即不替换logs文件夹。

5）resources文件夹保存了报表信息、配置信息等，若想要在集成后保留原先FineReport中的此类数据，可参考FineBI工程目录结构查看配置文件详细介绍，将想要保存的配置文件从FineReport安装目录..\WebReport\WEB-INF\resources中拷贝至FineBI目录..\WebReport\WEB-INF\resources内替换即可。

需要根据客户的需求看保存FineReport还是FineBI的embed、logs、resources文件夹。文件夹详细介绍请查看FineBI工程目录结构。


2.4 效果展示

将jar包拷贝覆盖后，重新启动FineBI，可以看到，BI的管理系统中会增加FineReport管理系统内已安装的节点。比如，在FineReport中安装了HTML5报表节点，那集成到FineBI中以后，管理系统下就会新增HTML5报表节点。

注：若在FineReport管理系统下没有单独安装自定义的节点，则在集成后，FineBI的管理系统下没有任何变化。


2.5 显示报表

因为FineReport不为空，那原先在FR中已制作的报表如何在集成到FineBI中显示呢？下面给出详细说明。

1、首先需要在BI中添加FineReport已制作报表使用到的数据连接，且数据连接名称要相同，可参考配置数据连接。

2、从FineReport的模板路径..\WebReport\WEB-INF\reportlets中将需要显示的报表拷贝至FineBI工程目录..\WebReport\WEB-INF\reportlets中。如下图，拷贝FineReport的报表GettingStarted.cpt至FineBI中：

222

3、登陆FineBI数据决策系统，在管理系统>目录管理中选择添加模板，能看到之前拷贝过去的报表在路径下可以选择，如下图：

222

222

点击下一步设置模板显示的名称、描述等，点击确定完成设置。

222

设置确定后刷新页面，即可在目录节点看到添加的FineReport报表。

222

注：在集成时，FineReport与FineBI的license需统一，统一使用FineBI的license。

3、FR为空，BI不为空编辑

若我们新安装了FineReport且没有在上面做任何操作，也即FR工程为空没有模板时，在集成的时候比较简单，只需要操作第二章节的2.1至2.4小节，且在2.3小节中只需要操作1、2步骤，即不用拷贝替换embed、logs文件夹，操作完成后即可像在FR内一样使用数据决策系统。

4、FR不为空，BI为空编辑

在集成过程中若FineBI为空，是新安装的版本没有做任何操作，可完全按照第二章节操作。其中2.3章节拷贝FR文件夹lib、plugins、embed、logs直接到BI中替换。

5、FR为空，BI为空编辑

当FR和BI都为新安装且没有做任何操作时，在集成时我们仅需操作第二章节的2.1至2.3小节，且在2.3小节中只需操作第一步骤，即拷贝lib下的jar包即可。