admin 管理员组文章数量: 1086019
2024年4月19日发(作者：html设置button的背景颜色)
在使用birt报表的时候感觉页面的BIRTReportViewer头标题没有用，想去掉在网上一查原
来有详细的参数设置，看来birt的功能还是很强大啊。现在转帖如下：
BIRT作为一款功能强大的开源报表工具，其版本的升级更新速度也非常快，从1.0到2.0，
一直到最新的2.2.1版本，无论从功能上还是性能上都得到了极大的提高和扩充。BIRT也提
供了一个标准的J2EE实现组件，可以发布到支持J2EE应用的webserver服务器上，可以
对生成的报表进行预览等操作。在大家使用BIRTViewer的时候，可能会对它日益纷繁的参
数设置如云里雾里，在网上论坛里也有很多人碰到这样哪样的问题，同时官方的文档也不细
致不全。所以我就对这些参数进行了一个简单系统的总结，希望能对大家的BIRT开发有所
帮助。这些参数以2.2.1版本为准，请大家特别注意。
t模式说明
查看BIRTViewer自带的文件，可以看到有以下几个pattern：
frameset----采用Ajax框架，可以显示工具条，导航条和TOC面板，实现复杂的操作，如
分页处理，导出数据，导出报表，打印等等。该模式下会自动生成reportdocument文件(预
览reportdesign文件)到特定的目录(用户可以用参数指定，也可以定义在里)。采用
Ajax，速度较慢。
run----也采用Ajax框架，但不实现frameset的复杂功能，不会生成临时的reportdocument
文件(预览reportdesign文件)，也不支持分页，这个主要是应用在BIRTDesigner里的preview
tab里，可以支持cancel操作，其它不怎么常用。采用Ajax，速度较慢。
preview---没有用到Ajax框架，直接调用底层EngineAPI对报表进行render，把生成的报
表内容直接输出到浏览器。这种模式和run模式调用的是相同的EngineAPI，唯一区别在于
run采用Ajax获取报表内容，而preview直接输出到浏览器。如果要支持分页，用户需要在
URL上定义__page和__pagerange参数，这两个参数也会在后面详细说明。需要特别说明
的是，在这几种预览模式中，preview的速度是最快的。
document---该模式主要是为了从reportdesign文件生成reportdocument文件。用户可以在
URL上提定document文件生成存放的路径(存放在server端)，如果未指定，会直接生成
rptdocument发送到客户端浏览器，用户可以下载到客户端。
output---该模式类似于frameset，会自动生成reportdocument文件(预览reportdesign文件)，
区别在于output不采用Ajax，而是将生成的报表内容直接输出到浏览器。
parameter---该模式主要用于生成一个参数对话框，一般用户不常用，用户可以直接通过提
供的JSPTag--parameterPage去实现参数对话框，不需要直接调用。
download---用于导出报表数据为CSV格式，当你使用frameset工具条里的导出数据功能
时，会用到这个模式。
里的参数设置
文件里有许多参数，用户应该根据自已的需求出发对这些参数有一个深入的了解。
下面我会对这些参数一一做以说明。
[BIRT_VIEWER_LOCALE]
设置默认的Locale信息，暂时没有太大意义。因为Locale的信息，首先以URL上定义的
__locale为准，如果没有定义，会找到当前浏览器的Locale信息，最后才会用到这里定义的
信息。
[BIRT_VIEWER_WORKING_FOLDER]
设置BIRTViewer的工作目录。用户可以把reportdesign或是reportdocument文件存放在这
个目录下，这样就可以在URL上采用相对路径去预览这些报表文件了。默认是当前根目录。
当前支持三种形式：
相对路径---这个相对当前的WEB应用的contextroot.
绝对路径
JAVA系统变量---可以在启动服务器时，定义JVM的系统变量，如java
–Dmyworkingfolder=D:/reports。这样就可以在中用${myworkingfolder}进行引用了。
[BIRT_VIEWER_DOCUMENT_FOLDER]
设置生成的document文件的存放路径。默认是documents目录。路径设置同上。
[WORKING_FOLDER_ACCESS_ONLY]
简单的报表访问限制控制实现，如果设为true,哪就只能预览存放在工作目录下的报表文件。
默认值是false。
[BIRT_VIEWER_IMAGE_DIR]
设置生成的临时图片的存放路径。默认是report/images目录。路径设置同工作目录设置。
[BIRT_VIEWER_LOG_DIR]
设置生成的日志文件存放路径。默认是logs目录。路径设置同工作目录设置。
[BIRT_VIEWER_LOG_LEVEL]
设置日志的level，可选的值有
ALL|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST|OFF。级别由高到低。
：
[BIRT_VIEWER_SCRIPTLIB_DIR]
设置用户scriptlib文件的存放目录(在报表中用到的JavaEventHandlerClass)。默认值是
scriptlib。路径设置同工作目录设置。
[BIRT_RESOURCE_PATH]
设置用户资源存放路径，这些资源包括library文件，image文件等。默认是当前根目录。路
径设置同工作目录设置。
[BIRT_VIEWER_MAX_ROWS]
设置获取dataset的最大记录数。主要应用于设计报表的时候，预览报表如果记录数太多，
会花费很多的时间，也可能会引起outofmemory问题。默认是不限制。
版权声明：本文标题：BIRT参数设置详解 内容由网友自发贡献，该文观点仅代表作者本人， 转载请联系作者并注明出处：http://www.roclinux.cn/p/1713540422a639807.html， 本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容，一经查实，本站将立刻删除。
发表评论