Birt和Tomcat的整合

Birt和Tomcat的整合

BIRT与现有应用的集成非常简单，由于BIRT主要是web应用，本节以web应用为例进行说明。

1. 从Eclipse BIRT官方网站下载birt-runtime-2_x_x.zip。

2. 解压之后，只需要其中的web view example目录下的内容。

3. 复制以下第三方软件包到web view example目录：

  需要的jar文件 复制位置 iText 1.3

itext-1.3.jar	WEB-INF\platform\plugins\com.lowagie.itext\lib

4. 将web view example目录发布到web容器中，如tomcat，改名：birtApp。

5. 启动tomcat，并访问birtApp。在首页中选择"View Example"，如果成功发布，系统将提示成功。

6. 发布设计完成的报表文件，在birtApp中创建reports目录，用于存放报表设计文件。

7. 在应用中通过：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 __isnull __locale __report 报表参数

报表输出格式：html或pdf，缺省是html。对于frameset不起作用。

指明一个参数是null，常用于字符串类型。如果提供参数且值为空： - 对于日期和数字类型，BIRT会将它们当作null处理。 - 对于字符串，BIRT会将它作为空字符串。因此，为了说明某个字符串是null，通常写为：__isnull=参数。

本地化选项，缺省是jvm的locale。

报表设计文件路径。

报表参数参数值对，形式：参数名=参数值。对于frameset，直接在地址栏中输入参数名=参数值后回车，不会影响报表结果。虽然，此时选择"运行报表"时，弹出的参数值已经改变。