EGL 报告创建过程概述

本主题概述为 EGL 项目创建和生成报告的一般过程。有关这些过程的其它详细信息包含在 EGL 报告任务帮助主题中。

要创建报告,应完成下面所述的三个过程。其中用于创建 XML 设计和编写用于生成报告的代码的两个过程是必需的。用于创建报告处理程序的第三个过程是可选的。您不一定要按描述的顺序完成这些过程。例如,如果需要,可以在创建 XML 设计文档之前创建报告处理程序,也可以同时创建它们,但在下面步骤 2 中的“报告处理程序与 XML 设计文档之间的代码相互关系”段落中描述的情况中除外。

如果没有 XML 设计文档以及用于生成报告的代码,则不能生成报告。

创建报告需要完成的三个过程包括:
  1. 创建 XML 设计文档以指定报告的布局信息。可以下列任一方式来创建此文档:
    • 通过使用第三方 JasperReport 设计工具(如 Jasper Assistant 或 iReports)。
    • 通过使用文本编辑器来将 Jasper XML 设计信息编写到新的文本文件中。

    XML 设计文档必须具有 .jrxml 扩展名。如果您创建的文件没有此扩展名,则将该文件重命名为 .jrxml 文件。此外,一定要将 XML 设计文档保存在将包含 EGL 报告处理程序和报告调用代码文件的 EGL 包中。

    您创建的 .jrxml 文件将编译成 .jasper 文件。如果未创建新的 .jrxml 文件,则必须导入先前编译的 .jasper 文件。

  2. 如果想要使用报告处理程序(该处理程序提供用于处理填写报告时发生的事件的逻辑),可以下列任一方式创建报告处理程序:
    • 通过使用 EGL 报告处理程序向导来指定报告处理程序的信息。
    • 通过创建新的 EGL 源文件并使用报告处理程序模板插入处理程序或者手工输入处理程序代码。
    报告处理程序与 EGL 设计文档之间的代码相互关系。在 .jrxml 文件中,可以指定 scriptletClass,它引用从 EGL 报告处理程序生成的报告处理程序文件。注意:
    • 如果 .jrxml 文件使用报告处理程序产生的 Java™ 代码,则必须先生成报告处理程序才能创建 .jrxml 文件。
    • 如果更改报告处理程序,则必须重新编译 .jrxml 文件。
    • 如果需要解析 .jrxml 文件中的所有编译错误或者想要在更改报告处理程序后重新编译 .jasper 文件,则必须修改 .jrxml 文件并保存它。
  3. 使用 EGL 报告库函数以在 EGL 项目中编写报告调用代码。可在创建报告调用代码时使用 EGL 程序部件向导。

要点:给定的报告处理程序和报告调用代码的文件名与 XML 设计文档的名称一定不能相同。如果不这么做,设计文件的编译会导致覆盖 Java 代码。为避免出现问题,将报告处理程序命名为 reportName_handler.egl,并将 XML 设计文档命名为 reportName_XML.jrxml。例如,可将报告命名为 abc_handler.egl 并将设计文档命名为 abc_XML.jrxml。您还必须确保 XML 设计文件具有唯一名称,不会与任何 EGL 程序文件冲突。

要在创建 XML 设计文档、报告处理程序(如果想要使用的话)和报告调用代码后构建并生成报告,应完成下列过程:
  1. 通过选择项目 > 全部构建来构建 EGL 项目。

    EGL 自动从 EGL 报告处理程序生成 Java 代码并将 XML 设计文档(.jrxml 文件)编译成 .jasper 文件。

  2. 运行具有报告调用代码的 EGL 程序。

在 EGL 程序运行后,EGL 使用的 JasperReports 程序将生成的报告自动保存在报告调用代码中的 reportDestinationFileName 指定的位置。

生成报告的 JasperReports 程序还会生成 .jprint 文件并存储它,这是一种中间文件格式,它将导出至最终报告格式(.pdf、.html、.xml、.txt 或 .csv)。

程序可将一个 .jprint 重复用于多次导出。

报告调用代码中的 exportReport() 函数使 EGL 以指定格式导出报告。例如,以下代码使 EGL 以 .pdf 格式导出报告:
 reportLib.exportReport(myReport, ExportFormat.pdf);

EGL 不会自动刷新导出的报告。如果更改报告设计或者数据更改,则必须重新填写报告并重新导出它。

注: 如果删除 EGL 报告,则必须除去对该报告的所有引用。

相关概念
EGL 报告概述

相关任务
将设计文档添加至包
使用报告模板
创建 EGL 报告处理程序
手工创建 EGL 报告处理程序
编写用于生成报告的代码
运行报告
导出报告
使用 EGL 中的内容辅助

相关参考
EGL 报告库
数据源
EGL 报告处理程序

使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.