Birt部署在tomcat下的方法

Birt部署在tomcat下的方法

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，直接在地址栏中输入参数名=参数值后回车，不会影响报表结果。虽然，此时选择"运行报表"时，弹出的参数值已经改变。