部署一个BIRT报告到你的应用服务器(转自ECLIPSE中国社区)

 

最近使用BIRT作为自己项目中的报告生成工具,看到论坛上有很多朋友在部署时有问题。希望这篇文章对你有所帮助,基本以BIRT1.0.1的开发者文档翻译为主。2.0刚刚发布,还没有使用过。

这里主要介绍的是部署一个已经存在的BIRT报告,也就是说你已经设计好的.reptdesign文件,本文并不介绍如何设计BIRT报告。

Deploying a BIRT report to an application server

这里BIRT说明了目前版本没有在高于JRE1.4的环境中测试过,如果你需要发布到JRE1.5的环境中,可能会有问题。以下内容使用TOMCAT为例

1.Placing the BIRT report viewer on the application server

拷贝ECLIPSE_INSTALL/plugins/org.eclipse.birt.report.viewer_1.0.1/birt到你的$TOMCAT_INSTALL/webapps,这个BIRT其实就是一个完整web应用,不需要再添加什么JAR包了。你也可以通过在TOMCAT中指定目录<Context />来添加,具体内容可以查看文档。

2.Viewing a report using a browser

添加完birt的应用后,启动你的TOMCAT,然后你就可以通过浏览器访问BIRT。这里有2种方式

http://localhost:8080/birt/run?parameter_list
http://localhost:8080/birt/frameset?parameter_list

    2.1 Understanding the run servlet

如果使用run servlet,BIRT会显示一个单独的Web页面或者一个PDF文件

    2.2 Understanding the frameset servlet

如果使用frameset servlet,BIRT将会显示3个Frame,一个显示输入报告参数的表单,一个显示报告,一个显示导航条。

    2.3 Understanding the URL parameters

下表为servlet可以支持的参数,需要注意的是_frame参数仅对frame servlet有效,reportParam参数是指你自己的report中定义的参数。

Parameter
Values
Required/default
__report
path to report design file
Yes, no default
__format
html or pdf
Optional /default to html
__frame
true or false
Optional /default to true
__locale
locale
Optional /defaults to JVM locale
__navigation
hide or parameter
Optional /default to auto
__toolbar
true or false
Optional /default to true
__isnull
any user-defined report parameter values
Optional /no default value
reportParam
User-defined
As specified in the report design / As specified in the report design

          2.3.1 Understanding the __report parameter

__report参数有3种定义方式

a.绝对路径

http://localhost:8080/birt/run?__report=C:\myReport.rptdesign

你的rptdesin文件存放在C:\myReport.rptdesign

b.相对路径,但是你的web.xml中没有定义BIRT_VIEWER_REPORT_ROOT

http://localhost:8080/birt/run?__report=Report\myReport.rptdesign

你的rptdesin文件存放在$TOMCAT_INSTALLl\webapps\birt\Report\myReport.rptdesign

c.相对路径,但是你的web.xml中定义了BIRT_VIEWER_REPORT_ROOT为C:\Reports

http://localhost:8080/birt/run?__report=myReport.rptdesign

你的rptdesin文件存放在C:\Reports\myReport.rptdesign

其他的参数都很简单,就不一一介绍了。

部署的过程其实很简单,我遇到的问题主要有

1.路径不对

2.自定义参数未定义

3.__locale参数未加,显示中文有问题

4.所有参数前面是两个下划线

希望能对你的项目有所帮助。如有问题,请回复

ko4java

你可能感兴趣的:(eclipse)