目录:
1. 概述编辑
1.1 版本
在实际操作前,请确保 FineBI 和 FineReport 版本兼容。版本兼容情况如下表所示:
FineBI 版本 | FineBI JAR 包时间 | FineReport 版本 | FineReport JAR 包时间 |
4.0.2 | 8.0 | ||
4.1 | 9.0 | ||
5.0 | 2018-10-12 | 10.0 | 2018-10-12 |
2018-12-20 | 2018-12-20 | ||
5.1 | 2019-01-15 | 10.0 | 2019-01-15 |
2019-02-16/2019-03-06 | 2019-01-29 | ||
2019-04-03/2019-04-24/ 2019-04-25 | 2019-04-03 | ||
2019-05-15 | 2019-5-15 | ||
2019-06-14 | 2019-6-13 | ||
2019-08-15 | 2019-8-15 | ||
2019-11-29 | 2019-9-27 | ||
2020-01-15 | 2020-01-15 | ||
2020-03-27 | 2020-01-15 |
1.2 应用场景
在实际使用过程中存在需要将 FineReport 工程集成到 FineBI 数据决策系统上使用的情况。
本文将分别介绍 FineReport 工程为空(即没有模板)和不为空情况下的集成步骤。
1.3 功能介绍
将 Finereport 集成到 FineBI ,可以将这两个软件合并成一个整体的系统,应用服务只需维护 一套;并且统一 BI 和 Finereport 的用户、权限体系、门户以及管理系统;用户登录时只需要登录一个平台。
1.4 准备工作
1.4.1 确定 FineBI 版本
可打开数据决策系统,选择管理系统>注册管理。查看 BI 模块版本,如下图所示:
1.4.2 确定 FineReport 版本
打开 FineReport 设计器,点击帮助>更新升级,查看当前 FineReport 版本,如下图所示:
如果实际安装的 FineReport 版本与 FineBI 版本不一致需要升级,详情参见:FineReport升级指南 。
若需升级 FineBI ,详情参见:FineBI升级指南 。
注:不仅需要大版本匹配,小版本 JAR 日期也需要一致,否则可能存在问题。
2. FineReport 不为空,FineBI 不为空编辑
2.1 必须操作
将 JAR 包拷贝覆盖后,重新启动 FineBI ,可以看到管理系统中会增加 FineReport 管理系统内已安装的节点。比如,在 FineReport 中安装了 HTML5 报表节点,那集成到 FineBI 中以后,管理系统下就会新增 HTML5 报表节点。
注:若在 FineReport 管理系统下没有单独安装自定义的节点,则在集成后,FineBI 的管理系统下没有任何变化。
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 中,如下图所示:
3)登录 FineBI 数据决策系统,在管理系统>目录管理中选择添加模板,如下图所示:
4)选择之前拷贝过去的报表模板,如下图所示:
5)点击下一步设置模板显示的名称、描述等,点击确定完成设置。如下图所示:
6)点击确定后刷新页面,即可在目录节点看到添加的 FineReport 报表。如下图所示:
注:在集成时,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中拆分出,形成单独的FR工程编辑
若用户在将 FineReport 集成到 FineBI 后需要将 FineReport 工程重新拆分出来单独使用,则需要进行如下操作:
6.1 重新部署
拷贝当前工程目录下的 webroot 文件,按照 Web服务器部署的方式 在新的服务器中进行重新部署。
6.2 删除 BI 目录节点
部署完成后启动工程,登录数据决策系统,然后删除目录管理中 BI 相关的目录节点即可。
注1:若不需要显示「数据准备」、「仪表板」节点,进入管理系统>用户管理>平台用户管理,将所有用户设置为 BI 查看用户即可。
注2:若需要进行重新授权注册,请参见:注册管理 。