本主题概述为 EGL 项目创建和生成报告的一般过程。有关这些过程的其它详细信息包含在 EGL 报告任务帮助主题中。
要创建报告,应完成下面所述的三个过程。其中用于创建 XML 设计和编写用于生成报告的代码的两个过程是必需的。用于创建报告处理程序的第三个过程是可选的。您不一定要按描述的顺序完成这些过程。例如,如果需要,可以在创建 XML 设计文档之前创建报告处理程序,也可以同时创建它们,但在下面步骤 2 中的“报告处理程序与 XML 设计文档之间的代码相互关系”段落中描述的情况中除外。
如果没有 XML 设计文档以及用于生成报告的代码,则不能生成报告。
XML 设计文档必须具有 .jrxml 扩展名。如果您创建的文件没有此扩展名,则将该文件重命名为 .jrxml 文件。此外,一定要将 XML 设计文档保存在将包含 EGL 报告处理程序和报告调用代码文件的 EGL 包中。
您创建的 .jrxml 文件将编译成 .jasper 文件。如果未创建新的 .jrxml 文件,则必须导入先前编译的 .jasper 文件。
要点:给定的报告处理程序和报告调用代码的文件名与 XML 设计文档的名称一定不能相同。如果不这么做,设计文件的编译会导致覆盖 Java 代码。为避免出现问题,将报告处理程序命名为 reportName_handler.egl,并将 XML 设计文档命名为 reportName_XML.jrxml。例如,可将报告命名为 abc_handler.egl 并将设计文档命名为 abc_XML.jrxml。您还必须确保 XML 设计文件具有唯一名称,不会与任何 EGL 程序文件冲突。
EGL 自动从 EGL 报告处理程序生成 Java 代码并将 XML 设计文档(.jrxml 文件)编译成 .jasper 文件。
在 EGL 程序运行后,EGL 使用的 JasperReports 程序将生成的报告自动保存在报告调用代码中的 reportDestinationFileName 指定的位置。
生成报告的 JasperReports 程序还会生成 .jprint 文件并存储它,这是一种中间文件格式,它将导出至最终报告格式(.pdf、.html、.xml、.txt 或 .csv)。
程序可将一个 .jprint 重复用于多次导出。
reportLib.exportReport(myReport, ExportFormat.pdf);
EGL 不会自动刷新导出的报告。如果更改报告设计或者数据更改,则必须重新填写报告并重新导出它。
相关概念
EGL 报告概述
相关任务
将设计文档添加至包
使用报告模板
创建 EGL 报告处理程序
手工创建 EGL 报告处理程序
编写用于生成报告的代码
运行报告
导出报告
使用 EGL 中的内容辅助
相关参考
EGL 报告库
数据源
EGL 报告处理程序