作者：ajun
版本：2006-11-10 1.0
一 Excel Report简介： ................................................................................................................... 2
1.1 什么是Excel Report？ ...................................................................................................... 2 1.2 它具有那些功能？ ............................................................................................................ 2 1.3 Excel Report的灵活性: ...................................................................................................... 2 1.4 它与普通报表工具的区别： ............................................................................................ 3 二 体验生成一个简单报表的制作过程： ..................................................................................... 3
2.1 运行环境配置 .................................................................................................................... 3 2.2 开始制作一个简单的报表 ................................................................................................ 4 三 ReportConfig.xml配置 .............................................................................................................. 5
3.1 设计一个报表需要配置那些信息？ ................................................................................ 5 3.2 datasource 节点 .................................................................................................................. 5 3.3 report节点 .......................................................................................................................... 7 3.4 配置文件配置信息规范建议 ............................................................................................ 9 四 报表模板文件配置 ..................................................................................................................... 9
4.1 报表模板中的基本元素 .................................................................................................. 10 4.2 Excel Report模板文件的构成 ......................................................................................... 12 4.3 报表模板配置规范建议 .................................................................................................. 16 4.4 格式化输出控制 .............................................................................................................. 16 4.5 通过$V{}(Excel函数模板)来使用excel的函数 .......................................................... 17 4.6 示例： .............................................................................................................................. 18 4.7 常见问题： ...................................................................................................................... 18 五 设计报表嵌入对象 ................................................................................................................... 19
5.1 为什么需要设计报表嵌入对象？ .................................................................................. 19 5.2 我们可以在嵌入对象里面做些什么？ .......................................................................... 19 5.3 一个嵌入对象实例： ...................................................................................................... 21 六 使用Excel Report的高级特性： ............................................................................................ 21
6.1 扩充你自己的数据源。 .................................................................................................. 21 6.2 使用变量别名。 .............................................................................................................. 22 6.3 设计模板是使用$V{}调用excel函数时的注意事项。 ............................................... 22 6.4 在web容器中配置Excel Report（ExcelReportServlet） ............................................ 22 6.5 在非web容器环境下使用excel report. ........................................................................ 22 七 一个完整的报表示例： ........................................................................................................... 23
7.1 配置reportConfig.xml ..................................................................................................... 23 7.2 配置模板文件 .................................................................................................................. 23 7.3 设计嵌入对象 .................................................................................................................. 23 结束语：......................................................................................................................................... 23
一 Excel Report简介：
1.1 什么是Excel Report？
Excel Report是一款基于Excel的报表生成工具，它通过用户定义报表模板文件，定义数据源，并配置相应的配置文件，就可以通过页面向指定Servlet请求输出报表，其生成的报表是一个excel文件。通过模板文件的方式来生成Excel文件，可以让程序员从生成特定格式的Excel文件的输出格式控制以及Excel文件读写等纷繁复杂而又容易出错的细节中解放出来，使得程序员只需组装自己的数据源，而根本不需要关心如何去生成Excel文件，如何去控制最终的文件输出效果等细节，从而大大减轻了制作一个Excel报表的工作量，并增强了程序的可维护性，因为很多的报表的修改只需通过模板文件的修改就可以实现，而无需改动程序。同时该报表工具又提供一些灵活的特性来使得用户可以自由控制报表的输出过程。
1.2 它具有那些功能？
1. 卡片式报表的支持。 2. 列表式报表的支持。 3. 主从式报表的支持。 4. 分组式报表的支持。（注：主从式和分组式之间可以任意嵌套，即一个主从式报表中我们可以嵌套一个分组从而实现对主记录或从记录进行分组的功能，反之也如此。） 5. 格式化的数据输出，该报表工具支持所有Excel的格式化输出控制。 6. 支持所有Excel的函数。
1.3 Excel Report的灵活性:
3.1 数据源的自定义：
用户可以自己定义数据源以替代默认实现，例如，我们可以编写一个自己的数据库数据源，通过定义该数据源我们可以利用现有系统的数据库连接及数据检索框架等。
3.2 嵌入报表数据处理类：
用户可以嵌入自己报表数据处理类（通过配置文件配置），通过嵌入用户自己的报表数据处理类，报表工具给用户提供了一个入口让用户参与报表的生成过程。比如，用户可以在生成报表前来组合自己的数据源，在这里用户完全可以充分利用现有系统的相关业务类来生成自己的数据源。
3.3 插入查询监听器：
用户可以插入自己的查询监听器，通过监听数据源的查询请求来做相关数据的检索及处理等工作（该功能在主从报表中尤其有用）。
3.4 插入字段监听器： 通过插入字段监听器，使得用户可以参与报表的输出过程，控制报表的具体输出的数据。（对于数据库自动检索数据类数据源的应用场合尤其有用） 这些特性在后面的章节我们会做详细的介绍。
1.4 它与普通报表工具的区别：
4.1 Excel Report是一个完全基于excel的报表工具，其最大的特点是完全依赖于excel。这是其于其他任何报表工具的最大区别。
4.2 通过依赖于Excel它具备了以下优点： A. 省略了专门的报表模板定义工具，应为该工具就是Excel本身，相信Excel的强大功能可以胜过任何其他报表工具模板定义工具。 B. 可以充分利用Excel的强大功能，如Excel函数库及其相关的脚本技术，Excel的图表(暂未提供支持)以及其对打印功能的强大控制能力。
二 体验生成一个简单报表的制作过程：
计算机世界里面大多数语言类的教程，在起始部分都会有一个经典的Hello World小程序，作为整个书的开篇，当然这样一个用例放在全文的开始，一来可以使读者可以快速的感受下所学东西的功能，二来也可以让读者快速上手，通过成功运行一个简单例子，而获得一定的成就感，从而增强继续学习下去的信心。 在这里我们也不想免俗，让大家感受一下，制作一个Excel报表是多么的简单。
当然在开始这个简单例子之前，一些必要的环境必须得提前准备好。(注：你可以在example/tomcat5.0下找到一个已经配置好的基于tomcat5.0的web应用。可以把它直接拷贝到本地的tomcat应用目录下运行例子程序)
本手册只针对ExcelReport的功能及其使用方法进行介绍，并未涉及报表制作相关的知识说明，因此在阅读此文档前必须要求读者具备一定报表制作相关的基础知识，且具备一定报表制作的经验，并了解普通报表设计的一般流程。
2.1 运行环境配置
首先你得准备一个WEB服务器（推荐用Tomcat5.0），
1. 拷贝example\\tomcat5.0\\目录下的excelreport.xml文件到你的TOMCAT_HOME\\
conf\\Catalina\\localhost目录下
2. 拷贝example\\tomcat5.0\\ excelreport目录到你的TOMCAT_HOME\\webapps目录下
3．启动数据库――找到TOMCAT_HOME\\webapps\\excelreport\\dababase\\server.bat,双击该文件启动HSQL数据库服务器。（Windows环境） 4. 拷贝excelreport对应的运行库文件到目录： TOMCAT_HOME\\webapps\\excelreport\\WEB-INF\\lib
5. 拷贝TOMCAT_HOME\\webapps\\excelreport\\dababase\\ hsqldb.jar 到TOMCAT_HOME\\common\\lib目录下
截止到目前，运行环境已经搭建完成。
2.2 开始制作一个简单的报表
1． 配置ReportConfig.xml
在我们example例子数据库中已经存在一个user的表。在配置文件中加入下面配置信息：
2． 配置helloworld.xls模板文件
如图红线圈住地方配置你的数据集字段要输出的位置。
初接触配置文件会比较麻烦，因为配置的信息比较多，在后续的章节我们会详细介绍具体每个配置信息的具体功能。为了避免出现不必要的错误，你最好从例子附带的模板文件拷贝配置信息。这样可以减少不必要的失误带来的麻烦。
3． 启动tomcat服务器
4． 请求报表：http://localhost:8080/excelreport/report?report=helloworld 具体信息可以根据你web服务器的具体配置做相应调整。
如果能看到文件下载对话框，那么恭喜你，第一个例子程序运行成功了。
三 ReportConfig.xml配置
在上一章节我们来快速地体验了一下Excel Report的具体功能，从这样一个简单的报表当中相信你也应该能体验到Excel Report的真正功能：通过分离报表数据和报表生成逻辑，使得程序员可以不用关心报表的具体如何生成，而只要准备自己的数据源和模板文件，仅此而已。这能给我们的程序带来什么样的好处呢？它能为我们的程序带来更好的灵活性和可维护性。我们可以很方便地通过更改模板文件来更改报表的具体输出效果，而这一过程可以做到尽可能小的影响到数据源的相关业务逻辑。你再也看不到业务数据相关的代码和excel文件生成的代码交叉在一起的痛苦场面了，当然你也再也不需要去写那些麻烦的Excel输出格式控制的代码了。
我们在上一章节Hello World Report例子里面其中很关键得一步就是配置一个ReportConfig.xml的配置文件(注意：这个文件名称本身也是可配置的)，在该配置文件里面我们配置了datasource和report两个节点，接下来的这一章节我们就来详细介绍该配置信息的具体功能和配置项的具体使用方法。
3.1 设计一个报表需要配置那些信息？
相信每一个刚接触到这个工具的人头脑里面都会问的一个问题，当然这要看，不同的报表有不同的实现（废话:）），但不管什么报表有两个配置项目是必不可少的，datasource和report。
其中detasource是用来描述一个数据源的信息，由它来告诉报表工具如何去生成一个具体的数据源对象实例，我们在这个配置项你们需要回答报表工具以下几个问题：
1．我需要一个什么类型的数据源？ 2．这个数据源如何取数据（取决于1）。 3．数据源应该接收那些输入参数？（可选） 4．数据源有那些字段？字段的类型是什么等等。（可选） 5．如果是database型的数据源的话，查询的sql是什么？
Report是用来告诉报表生成工具，生成一个报表需要用到那些资源？从那去取？比如：报表模板文件名称，报表中用到的数据源名称等等信息。报表生成工具通过这些配置信息，去取得相应的资源，并生成用户想要的报表文件。
3.2 datasource 节点
上面我们说过datasource是用来描述一个数据源，该节点定义一个全局的数据源信息，当定义好一个全局的数据源之后，就可以在我们具体的报表里面应用该数据源。
在详细介绍该节点配置信息之前，我们看一个比较典型的实例，参照该实例来具体介绍一个数据源的配置信息需要使用到那些配置项目，他们具体的意思是什么？ 下面是一个数据源的配置信息实例：
百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读，免费范文网，提供经典小说教育文库Excel的报表生成器使用手册在线全文阅读。
相关推荐：