FineReport集成到FineBI

  • 文档创建者:doreen0813
  • 编辑次数:12次
  • 最近更新:Roxy 于 2019-12-31
  • 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 包即可。

    附件列表


    主题:
    • 有帮助
    • 没帮助
    • 只是浏览