ExcelReport报表生成器使用手册.doc

一 Excel Report简介： 2
什么是Excel Report？ 2
它具有那些功能？ 2
Excel Report的灵活性: 2
它与普通报表工具的区别： 3
二 体验生成一个简单报表的制作过程： 3
运行环境配置 3
开始制作一个简单的报表 4
三配置 4
设计一个报表需要配置那些信息？ 5
datasource 节点 5
report节点 7
配置文件配置信息规范建议 9
四 报表模板文件配置 9
报表模板中的基本元素 10
Excel Report模板文件的构成 12
报表模板配置规范建议 16
格式化输出控制 16
通过$V{}(Excel函数模板)来使用excel的函数 17
示例： 18
常见问题： 18
五 设计报表嵌入对象 18
为什么需要设计报表嵌入对象？ 18
我们可以在嵌入对象里面做些什么？ 19
一个嵌入对象实例： 19
六 使用Excel Report的高级特性： 19
扩充你自己的数据源。 19
使用变量别名。 19
设计模板是使用$V{}调用excel函数时的注意事项。 19
在web容器中配置Excel Report（ExcelReportServlet） 20
在非web容器环境下使用excel report. 20
七 一个完整的报表示例： 20
配置 20
配置模板文件 20
设计嵌入对象 20
结束语： 20
一 Excel Report简介：
什么是Excel Report？
Excel Report是一款基于Excel的报表生成工具，它通过用户定义报表模板文件，定义数据源，并配置相应的配置文件，就可以通过页面向指定Servlet请求输出报表，其生成的报表是一个excel文件。通过模板文件的方式来生成Excel文件，可以让程序员从生成特定格式的Excel文件的输出格式控制以及Excel文件读写等纷繁复杂而又容易出错的细节中解放出来，使得程序员只需组装自己的数据源，而根本不需要关心如何去生成Excel文件，如何去控制最终的文件输出效果等细节，从而大大减轻了制作一个Excel报表的工作量，并增强了程序的可维护性，因为很多的报表的修改只需通过模板文件的修改就可以实现，而无需改动程序。同时该报表工具又提供一些灵活的特性来使得用户可以自由控制报表的输出过程。
它具有那些功能？
1. 卡片式报表的支持。
2. 列表式报表的支持。
3. 主从式报表的支持。
4. 分组式报表的支持。（注：主从式和分组式之间可以任意嵌套，即一个主从式报表中我们可以嵌套一个分组从而实现对主记录或从记录进行分组的功能，反之也如此。）
5. 格式化的数据输出，该报表工具支持所有Excel的格式化输出控制。
6. 支持所有Excel的函数。
Excel Report的灵活性:
数据源的自定义：
    用户可以自己定义数据源以替代默认实现，例如，我们可以编写一个自己的数据库数据源，通过定义该数据源我们可以利用现有系统的数据库连接及数据检索框架等。
嵌入报表数据处理类：
    用户可以嵌入自己报表数据处理类（通过配置文件配置），通过嵌入用户自己的报表数据处理类，报表工具给用户提供了一个入口让用户参与报表的生成过程。比如，用户可以在生成报表前来组合自己的数据源，在这里用户完全可以充分利用现有系统的相关业务类来生成自己的数据源。
插入查询监听器：
    用户可以插入自己的查询监听器，通过监听数据源的查询请求来做相关数据的检索及处理等工作（该功能在主从报表中尤其有用）。
插入字段监听器：
 通过插入字段监听器，使得用户可以参与报表的输出过程，控制报表的具体输出的数据。（对于数据库自动检索数据类数据源的应用场合尤其有用）
这些特性在后面的章节我们会做详细的介绍。
它与普通报表工具的区别：
Excel Report是一个完全基于excel的报表工具，其最大的特点是完全依赖于excel。这是其于其他任何报表工具的最大区别。
通过依赖于Excel它具备了以下优点：
    A. 省略了专门的报表模板定义工具，应为该工具就是Excel本身，相信Excel的强大功能可以胜过任何其他报表工具模板定义工具。
    B. 可以充分利用Excel的强大功能，如Excel函数库及其相关的脚本技术，Excel的图表(暂未提供支持)以及其对打印功能的