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

目录:

1. 概述编辑

1.1 版本

在实际操作前，请确保FineBI 和 FineReport 版本兼容。版本兼容情况如下表：

FineBI 版本
FineBI JAR 包时间FineReport 版本FineReport JAR 包时间
5.0 2018-10-1210.02018-10-12
2018-12-202018-12-20
5.12019-1-1510.0
2019-1-15
2019-2-16/2019-3-62019-1-29

2019-4-3/2019-4-24/

2019-4-25

2019-4-3
2019-5-152019-5-15
2019-6-142019-6-13
2019-8-152019-8-15
2019-11-292019-9-27

1.2 功能简介

在实际使用过程中存在需要将 FineReport 工程集成到 FineBI 数据决策系统上使用的情况。

本文将分别介绍 FineReport 工程为空（即没有模板）和不为空情况下的集成步骤。

1.3 准备工作

1.3.1 确定 FineBI 版本

可打开数据决策系统，选择管理系统>注册管理。查看 BI 模块版本，如下图所示：

1577169801211810.png

1.3.2 确定 FineReport 版本

打开 FineReport 设计器，点击帮助>更新升级，查看当前 FineReport 版本，如下图所示：

1577171421930897.png

如果实际安装的 FineReport 版本与 FineBI 版本不一致需要升级，详情参见：FineReport升级指南 。

若需升级 FineBI ，详情参见：FineBI升级指南 。

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

注2：FineReport 若为 8.0 版本，需要与 FineBI4.0.2 版本工程匹配；

        FineReport为 9.0 版本，需要与 FineBI4.1版本工程匹配；

        FineReport为10.0版本，需要与FineBI5.0版本工程匹配。

       不仅需要大版本匹配，小版本 JAR 日期也需要一致，否则可能存在问题。

2. FineReport 不为空，FineBI 不为空编辑

2.1 必须操作

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

1577172048677306.png

注：若原 FineReport 工程的%FR_HOME%\webroot\WEB-INF\lib文件下存在驱动，集成的时候需要判断集成后使用的数据连接需要哪种驱动，从而保留对应版本，如上图中的 mysql-connector-java-5.1.39-bin、ojdbc14 和 sqljdbc 驱动，不需要的驱动版本需要删除。 

2）将FineReport安装目录%FR_HOME%\webroot\WEB-INF\plugins下的所有文件拷贝至FineBI目录%FineBI%\webroot\WEB-INF\plugins下，若有相同的文件，保留BI的不替换。如下图所示：

1577172319131138.png

3）将 FineReport 目录%FR_HOME%\webroot\WEB-INF\assist下拷贝文件夹 phantomjs 至 FineBI 对应目录下，若不进行此操作，使用到 FineReport 的图表导出和定时调度中含有图表时，图表会无法显示。如下图所示：

1577173277952828.png

2.2 选择性操作

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

2.2.1 embed 文件

embed 文件夹里面存储了数据决策系统中除平台属性配置以外的所有信息，包括目录树设置、模板定时任务信息等。

若要在集成后的系统中保留原先 FineReport 中的配置信息，需要将 FineReport 安装目录%FR_HOME%\webroot\WEB-INF 下的 embed 文件夹拷贝至 FineBI 目录%FineBI%\webroot\WEB-INF内替换 FineBI 原先的文件夹。若想保留 FineBI 的设置信息，则这一步可不操作，即不替换 embed 文件夹。

1577184713269432.png

2.2.2 logs 文件

logs 文件夹是FineBI日志监控开启之后保存日志的内置数据库。

若想保留 FineReport 系统中的日志数据，则需要将 FineReport 安装目录%FR_HOME%\webroot下的 logs 文件夹拷贝至 FineBI 目录%FineBI%\webroot内替换原先的文件夹。若想保留 FineBI 的日志信息，则这一步可不操作，即不替换 logs 文件夹。

2.2.3 resources 文件

resources 文件夹保存了报表信息、配置信息等。

若想要在集成后保留原先 FineReport 中的此类数据，可参考 FineBI工程目录结构 查看配置文件详细介绍，将想要保存的配置文件从 FineReport 安装目录%FR_HOME%\webroot\WEB-INF\resources中拷贝至 FineBI 目录%FineBI%\webroot\WEB-INF\resources内替换即可。

2.3 效果展示

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

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

222

2.4 显示报表

因为 FineReport 不为空，原先在 FineReport 中已制作的报表在集成到 FineBI 中显示给出详细说明。

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

2） FineReport 的模板路径%FR_HOME%\webroot\WEB-INF\reportlets中将需要展示的报表拷贝至 FineBI 工程目录%FineBI%\webroot\WEB-INF\reportlets中。拷贝 FineReport 的报表 GettingStarted.cpt 至 FineBI 中，如下图所示：

222

3）登陆 FineBI 数据决策系统，在管理系统>目录管理中选择添加模板，选择之前拷贝过去的报表，如下图所示：

222

222

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

222

点击确定后刷新页面，即可在目录节点看到添加的 FineReport 报表。如下图所示：

222

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

3. FineReport 为空，FineBI 不为空编辑

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

4. FineReport 不为空，FineBI 为空编辑

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

5. FR为空，BI为空编辑

当 FineReport 和 FineBI 都为新安装且没有做任何操作时，在集成时仅需操作第 2 章节的 2.1 小节，且在 2.1 小节中只需操作第一步骤，即拷贝 lib下的 JAR 包即可。

6. 将FR从BI中拆分成单独的工程编辑

将当前工程webroot按照 web服务器部署的方式 在新的服务器中进行部署。部署完成之后启动，登陆系统，然后删除目录管理中BI相关的目录节点即可。

注：若不需要显示“数据准备”、“仪表板”节点，在用户管理，平台用户管理tab页，将所有用户设置为BI查看用户即可。