birt配置参数详解

《birt配置参数详解》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、BIRT参数设置详解2010-08-2516:30    在使用birt报表的时候感觉页面的BIRTReportViewer头标题没有用，想去掉在网上一查原来有详细的参数设置，看来birt的功能还是很强大啊。现在转帖如下：  BIRT作为一款功能强大的开源报表工具，其版本的升级更新速度也非常快，从1.0到2.0，一直到最新的2.2.1版本，无论从功能上还是性能上都得到了极大的提高和扩充。BIRT也提供了一个标准的J2EE实现组件，可以发布到支持J2EE应用的webserver服务器上，可以对生成的报表进行预览等操作。在大

2、家使用BIRTViewer的时候，可能会对它日益纷繁的参数设置如云里雾里，在网上论坛里也有很多人碰到这样哪样的问题，同时官方的文档也不细致不全。所以我就对这些参数进行了一个简单系统的总结，希望能对大家的BIRT开发有所帮助。这些参数以2.2.1版本为准，请大家特别注意。1.Servlet模式说明查看BIRTViewer自带的web.xml文件，可以看到有以下几个pattern：frameset----采用Ajax框架，可以显示工具条，导航条和TOC面板，实现复杂的操作，如分页处理，导出数据，导出报表，打印等等。该模式下会

3、自动生成reportdocument文件(预览reportdesign文件)到特定的目录(用户可以用参数指定，也可以定义在web.xml里)。采用Ajax，速度较慢。run----也采用Ajax框架，但不实现frameset的复杂功能，不会生成临时的reportdocument文件(预览reportdesign文件)，也不支持分页，这个主要是应用在BIRTDesigner里的previewtab里，可以支持cancel操作，其它不怎么常用。采用Ajax，速度较慢。preview---没有用到Ajax框架，直接调用底层En

4、gineAPI对报表进行render，把生成的报表内容直接输出到浏览器。这种模式和run模式调用的是相同的EngineAPI，唯一区别在于run采用Ajax获取报表内容，而preview直接输出到浏览器。如果要支持分页，用户需要在URL上定义__page和__pagerange参数，这两个参数也会在后面详细说明。需要特别说明的是，在这几种预览模式中，preview的速度是最快的。document---该模式主要是为了从reportdesign文件生成reportdocument文件。用户可以在URL上提定document

5、文件生成存放的路径(存放在server端)，如果未指定，会直接生成rptdocument发送到客户端浏览器，用户可以下载到客户端。output---该模式类似于frameset，会自动生成reportdocument文件(预览reportdesign文件)，区别在于output不采用Ajax，而是将生成的报表内容直接输出到浏览器。parameter---该模式主要用于生成一个参数对话框，一般用户不常用，用户可以直接通过提供的JSPTag--parameterPage去实现参数对话框，不需要直接调用。download---

6、用于导出报表数据为CSV格式，当你使用frameset工具条里的导出数据功能时，会用到这个模式。2.web.xml里的参数设置web.xml文件里有许多参数，用户应该根据自已的需求出发对这些参数有一个深入的了解。下面我会对这些参数一一做以说明。[BIRT_VIEWER_LOCALE]设置默认的Locale信息，暂时没有太大意义。因为Locale的信息，首先以URL上定义的__locale为准，如果没有定义，会找到当前浏览器的Locale信息，最后才会用到这里定义的信息。[BIRT_VIEWER_WORKING_FOLDE

7、R]设置BIRTViewer的工作目录。用户可以把reportdesign或是reportdocument文件存放在这个目录下，这样就可以在URL上采用相对路径去预览这些报表文件了。默认是当前根目录。当前支持三种形式：相对路径---这个相对当前的WEB应用的contextroot.绝对路径JAVA系统变量---可以在启动服务器时，定义JVM的系统变量，如java–Dmyworkingfolder=D:/reports。这样就可以在web.xml中用${myworkingfolder}进行引用了。[BIRT_VIEWER_

8、DOCUMENT_FOLDER]设置生成的document文件的存放路径。默认是documents目录。路径设置同上。[WORKING_FOLDER_ACCESS_ONLY]简单的报表访问限制控制实现，如果设为true,哪就只能预览存放在工作目录下的报表文件。默认值是false。[BIRT_VIEWER_IMAGE_