FineReport集成到FineBI

  • 文档创建者:doreen0813
  • 编辑次数:15次
  • 最近更新:Roxy 于 2020-03-26
  • 1. 概述

    1.1 版本

    在实际操作前,请确保 FineBI 和 FineReport 版本兼容。版本兼容情况如下表所示:

    FineBI 版本
    FineBI JAR 包时间FineReport 版本FineReport JAR 包时间
    4.0.2
    8.0
    4.1
    9.0
    5.0 2018-10-1210.02018-10-12
    2018-12-202018-12-20
    5.12019-01-1510.0
    2019-01-15
    2019-02-16/2019-03-062019-01-29

    2019-04-03/2019-04-24/

    2019-04-25

    2019-04-03
    2019-05-152019-5-15
    2019-06-142019-6-13
    2019-08-152019-8-15
    2019-11-292019-9-27
    注:FineBI4.1 暂时不能升级至 5.0,待后续更新,目前仅能新安装 5.0 版本。  

    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升级指南 。

    注:不仅需要大版本匹配,小版本 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

    4)选择之前拷贝过去的报表模板,如下图所示:

    222

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

    222

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

    222

    注:在集成时,FineReport 与 FineBI 的 License 需统一,统一使用 FineBI 的 License 。

    3. FineReport 为空,FineBI 不为空

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

    4. FineReport 不为空,FineBI 为空

    在集成过程中若 FineBI 为空,新安装的版本没有做任何操作,可完全按照第 2 章操作。拷贝 FineReport 文件夹 libpluginsembedlogs 直接到 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:若需要进行重新授权注册,请参见:注册管理

    附件列表


    主题:
    • 有帮助
    • 没帮助
    • 只是浏览
    • 评价文档,奖励 1 ~ 100 随机 F 豆!