报表执行

1.1 应用场景

由引擎 API 概述可以知道，报表分为两种情况：

模板和结果

• 没有执行过的工作薄或者报表都为模板，模板中包含数据集，数据列没有扩展且公式未计算；

• 模板执行后就成了结果，结果中所有数据列都已经扩展，因此结果中不再保存数据集。

如下图所示，给模板传递参数值后就可以执行生成结果，以下具体介绍该过程的实现步骤。

1.2 实现原理

1）首先需要定义执行所在的环境，这样才能正确读取数据库信息：

String envpath = "C:\\FineReport_10.0\\webapps\\webroot\\WEB-INF";//工程路径
SimpleWork.checkIn(envpath);
module.start();

2）定义模板路径，读取模板： 

TemplateWorkBook workbook = TemplateWorkBookIO.readTemplateWorkBook("\\doc\\Primary\\Parameter\\Parameter.cpt");

3）注入参数值，执行生成结果：

/*
* 生成参数map，注入参数与对应的值，用于执行报表 该模板中只有一个参数地区，给其赋值华北
* 若参数在发送请求时传过来，可以通过req.getParameter(name)获得
* 获得的参数put进map中，paraMap.put(paraname,paravalue)
*/
java.util.Map paraMap = new java.util.HashMap();
paraMap.put("地区", "华北");
// 使用paraMap执行生成结果  
ResultWorkBook result = workbook.execute(paraMap, new WriteActor());

4）执行后的结果我们可以进行各种操作，比如导出至 Excel、PDF 文件，实现方法可参考 导出 API，这里选择导出至 Excel：

FileOutputStream outputStream = new FileOutputStream(new File(
"C:\\test\\Parameter.xls"));
ExcelExporter excelExporter = new ExcelExporter();
excelExporter.export(outputStream, result);

以下示例读取内置模板 Parameter.cpt 后注入参数值执行结果后，将结果导出成 Excel 文件。

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 程序 ExcuteDemo.java，即读取内置模板 Parameter.cpt 后注入参数值执行结果后，将结果导出成 Excel 文件。完整代码可参见：

注：用户使用时，注意将示例代码中的工程路径、模板名称和导出路径替换为用户自己工程下的。

https://code.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/io/ExcuteDemo.java

2.3 编译 Java 文件

Java 程序编写完成后，在编译器中编译 ExcuteDemo.java ，编译通过后，就会在代码中导出路径的文件夹下生成 Excel 文件，这样就实现了读取模板执行后导出结果。如下图所示：