1、先下载birt-runtime-2.1.3.zip 地址:http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/R-R1-2_1_3-200707051847/birt-runtime-2.1.3.zip
2、将其解压,把目录下的WebViewerExample文件夹复制到Tomcat主目录下的webapps目录下,并改名为birtApp.
3、复制第三方软件:
- itext-1.5.2.jar:复制到birtApp/WEB-INF/platform/plugins/com.lowagie.itext/lib
- 数据库驱动(mysql为例)mysql-connector-java-5.0.5-bin.jar:复制到birtApp/WEB-INF/platform/plugins/org.eclipse.birt.report.data.oda.jdbc_2.1.1.v20070705-1847/drivers
不过我用的2.1.3版本不用复制itext-1.5.2.jar,相应目录下面都有,也不用复制其他的jar文件。但数据库驱动的jar文件一定要复制(不过报表中没用到数据库访问的话就不用了)!
如果是用tomcat6的版本,需要在工程的Web-INF/lib下放置一个commons-logging-api-1.1.1.jar的包,这个包在tomcat5.5里有,6.0取消了这个包
4、启动Tomcat,在浏览器中输入http://lcoalhost:8080/birtApp/ 在首页中点击"View Example",若正常进入,则说明成功。
5、发布做好的报表文件:将制作好的报表文件如test.rptdesign复制到birtApp下,在浏览器中输入:
http://localhost:8080/birtApp/run?__report=test.rptdesign 就可以访问了。
6、访问报表:http://localhost:8080/birtApp/frameset?__report=报表文件路径
这个web应用支持2个动作:
- frameset,以frameset的形式显示报表。这个界面包含一些frame,如页面导航,报表主体在其中的一个frame中显示;使用形式:
http://localhost:8080/birtApp/frameset?__report=报表文件路径&参数=........ - run,报表以一个单独的html页面或pdf显示,由于这种形式没有frmaeset,因此使用者必须自己提供相应的参数,如报表参数,页号等。使用形式:
http://localhost:8080/birtApp/run?__report=报表文件路径&参数=........
对于以上2个动作,以下列出可用的参数:
- __format:报表输出格式:html或pdf,缺省是html。对于frameset不起作用。
- __isnull:指明一个参数是null,常用于字符串类型。如果提供参数且值为空: - 对于日期和数字类型,BIRT会将它们当作null处理。 - 对于字符串,BIRT会将它作为空字符串。因此,为了说明某个字符串是null,通常写为:__isnull=参数。
- __locale:本地化选项,缺省是jvm的locale。
- __report:报表设计文件路径。
- 报表参数:报表参数参数值对,形式:参数名=参数值。对于frameset,直接在地址栏中输入参数名=参数值后回车,不会影响报表结果。虽然,此时选择"运行报表"时,弹出的参数值已经改变。
我使用的是