带参程序数据集

  • 文档创建者:印然
  • 编辑次数:42次
  • 最近更新:RosieY 于 2021-02-24
  • 1. 概述

    1.1 应用场景

    在实际应用中,可能需要根据表名动态地改变数据源,比如在程序数据集中,通过传进的表名参数,到数据库取出对应的表作为数据源。

    1.2 实现原理

    FineReport 是通过 AbstractTableData 抽象类来读取数据源的,所有的数据来源都继承实现其抽象方法。因此用户只要实现了 AbstractTableData 抽象类,就可以用自定义类型的数据源,FineReport 报表引擎就能够读取定义的数据源作为报表数据源使用。

    自定义 Java 代码思路为:

    1) 定义数据表结构

    2)实现 AbstractTableData 抽象类

    3)将获取到的数据放入到定义的表中

    4)获取数据库连接

    5)释放一些资源,将上次查询的结果释放掉

    2. 示例

    示例将以 FRDemo 数据连接为例,参数为数据表名,不同的参数值,程序数据集将获取到 FRDemo 中不同的表数据。

    2.1 准备编译环境

    编译程序前,需先创建一个 Java 工程环境,并且需要一个 Java 编辑器,如 Eclipse 或 idea 。

    在编辑器工程中导入 FineReport 工程 JAR 包。包括安装的报表工程

    %FR_HOME%/lib下的所有的包,

    %FR_HOME%/server/lib 下的所有包,

    %FR_HOME%/webapps/webroot/WEB-INF/lib下的所有包,

    还要引入 JDK 下的的 tools.jar。详细操作可参考:编译Java程序 

    2.2 编写Java文件

    在编译器中编写 Java 文件 ParamTableDataDemo.java, 完整代码可参见:

    注:若 java 文件包位置不同,需要手动引入 AbstractTableData,即代码中加入 import com.fr.data.AbstractTableData; 

    https://code.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/data/ParamTableDataDemo.java

    2.3 编译Java文件

    Java 文件编写完成后,在编译器中编译 ParamTableDataDemo.java ,编译通过后,将会在对应工程下生成ParamTableDataDemo.class 类文件。

    2.4 导入class文件

    将编译后生成的 ParamTableDataDemo.class 类文件复制到 %FR_HOME%\webapps\webroot\WEB-INF\classes\com\fr\data 工程目录下。如下图所示:

    点击下载 class 文件:ParamTableDataDemo.rar

    2.5 配置程序数据集

    1)新建普通报表,数据集管理面板新建程序数据集,选择我们已经定义好的 class 文件,如下图所示:

    Snag_6597dcb.png

    2)添加默认参数,参数名为tableName,如下图所示:

    Snag_65bb471.png

    2.6 使用程序数据集

    1)选中新建的程序数据集,点击预览按钮,输入参数值,如下图所示:

    Snag_65dd3b7.png

    2)查询出的销量表如下图所示,将字段拖入报表中即可用作报表数据。

    Snag_65eee7e.png

    注:如果预览不出数据,请确认代码段里面定义数据库连接时 URL 的地址是否正确,如下图所示:

    Snag_66158d7.png

    3. 注意事项

    3.1 决策报表中程序数据集参数名冲突

    问题描述:

    决策报表中创建了多个程序数据集,每个数据集的参数名都是一样的,只是参数值不同,在PC端预览时出现展示的数据都是相同的。

    原因分析:

    决策报表中如果多个程序数据集的参数名一样,会产生冲突。

    解决方案:

    决策报表中程序数据集的名称不能相同,如果存在相同的名称需要修改成不同的。

    附件列表


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