birt配置参数详解

合集下载

birt报表技巧

Birt中的分页显示报表:方法如下：1、将鼠标停在表格上，选择明细数据行(Row Detail) 。

2、选择脚本(script)标签，在onPrepare方法中加入:count=0;在onCreate方法中加入：count++;if(count % 10==0){this.getStyle().pageBreakAfter="always";}然后放到服务器上运行，则实现分页显示。

Birt中报表参数的用法(一)Birt中有两种参数，一种是数据集参数，一种是报表参数。

数据集参数一般是用于select语句中的?所代表的参数的。

而报表参数一直则是整个报表的参数，定义它的目的一方面是和数据集参数绑定，一方面是在脚本中使用它。

例如：我想设计一个报表，通过参数传递一个数据库中的表名，显示相应表中的数据，所有的表的结构一样！做法如下：先定义数据源；然后定义数据集，查询选项中的语句写select * from [要传入的表名中的任意一个]；然后定义一个报表参数table,设置一个默认值(默认表名)；然后再数据集的脚本的beforeOpen方法中加入：this.queryText="select * from "+params["table"]; ；完成。

如何在Tomcat中配置使得能显示Birt Chart报表:今天看了一本关于Birt方面的书，提到了在Tomcat中成功部署Birt的方法。

我试了一下，果然可以，即可访问普通报表，又可访问chart报表，而且方法也比较简单。

现介绍如下：1、从网上下载birt-runtime-version.zip并解压(/birt/downloads/build.php?build=R-R1-2_1_3-200707051847)。

2、将解压后根目录中的WebViewerExample文件加复制到Tomcat根目录下的webapps下面,并更名为birt_viewer2.2(因为我下的是2.2版本)3、复制第三方软件：iText.jar(复制到birt_viewer2.2\WEB-INF\platform\plugins\com.lowagie.itext_1.5.2.v20070626\lib 下)axis.jar axis-ant.jarcommons-discovery-0.2.jar jaxrpc.jar saaj.jar wsdl4j-1.5.1.jar(复制到birt_viewer2.2\WEB-INF\lib)prototype.js(复制到birt_viewer2.2\webcontent\birt\ajax\lib下)birt2.1,2.2版本下载下来后就包含了以上所有第三方软件，你只需到相应目录下确认一下，有的话就不用管了！若没有的话就复制到相应目录下即可。

Birt使用手册范本

Birt使用手册1.1简介BIRT 是一个Eclipse-based 开放源代码报表系统。

它主要是用在基于Java 与J2EE的Web 应用程序上。

BIRT 主要由两部分组成：一个是基于Eclipse 的报表设计和一个可以加到你应用服务的运行期组件。

BIRT 同时也提供一个图形报表制作引擎。

BIRT 拥有和Dreamweaver 一般的操作界面，可以像画table 一样画报表，也可以生成图片、导出Excel、html 分页，样式比script 设置简单，另外BIRT 还有OLAP 导航功能。

1.2基本概念数据源：数据的来源，或提供者。

如xml 数据源、jdbc 数据源等。

数据集：数据集合，它必须与数据源关联，可以理解为查询的结果。

报表以及报表项，报表可视为是针对一组数据集的表现形式，而报表项这是这个表现形式的某个具体的单元。

它们之间的关系，与窗体和控件的关系非常类似。

报表、数据集、数据源三者间的关系：数据源 --- 数据集 --- 报表。

报表参数：查询参数的表现形式，使用它可以构建更灵活的报表。

模板和库：主要用于复用报表设计，提高报表开发的效率。

1.3Birt报表设计器的安装与配置BIRT 的下载地址是：/birt/downloads/ 有两种下载方式：1) All-in-One 版本（birt-report-designer-all-in-one-2.2.2.zip），它包含了运行BIRT系统所需的组件，可直接应用。

2) Framework 插件版本（birt-report-framework-2.2.2.zip），安装的必要环境为Java1.4.2/1.5 JDK/JRE; Eclipse SDK 3.2, GEF 3.2 and EMF 3.2。

安装步骤如下：打开eclipse 文件夹，在文件夹中再新建一文件夹（如：birt）,然后打开birt-report-framework-2.2.2.zip 把其中的eclipse 文件夹放入新建的birt文件夹中。

birt报表参数

birt报表参数Birt报表参数是一种用于在Birt报表中传递数据和控制报表生成的方式。

通过使用Birt报表参数，用户可以在生成报表时输入参数值，从而实现对报表内容和显示方式的灵活控制。

本文将介绍Birt 报表参数的使用方法和注意事项。

Birt报表参数可以用于多种用途，比如用于过滤数据、控制报表显示方式或格式、动态生成报表标题等。

在使用Birt报表参数时，首先需要在报表设计中定义参数。

参数可以有多种类型，比如字符串、数字、日期等，具体类型根据需求而定。

定义参数时，可以设置参数的名称、默认值、是否可为空等属性。

在报表设计中使用参数时，可以通过参数名称引用参数的值。

在SQL查询中，可以使用参数名称作为查询条件，从而实现数据过滤。

在报表模板中，可以使用参数名称作为文本框、表格、图表等组件的属性值，从而实现动态显示和控制。

使用Birt报表参数时需要注意以下几点。

首先，确保参数的名称在整个报表中唯一，避免参数名称冲突。

其次，参数的默认值应该合理设置，以便在用户不输入参数值时有一个合理的默认行为。

另外，参数的类型和数据格式要与使用场景相匹配，避免出现数据类型不匹配或格式错误的问题。

在使用Birt报表参数时，可以通过给参数赋值的方式传递参数值。

参数值可以通过多种方式传递，比如URL参数、JavaScript脚本、数据集字段等。

在使用URL参数传递参数值时，可以通过在URL中添加参数名和参数值的方式实现。

需要注意的是，URL参数的值需要进行编码，以避免特殊字符引起的问题。

除了使用URL参数传递参数值外，还可以使用JavaScript脚本来动态设置参数值。

通过在报表模板中嵌入JavaScript脚本，可以根据需要计算参数值或从其他组件中获取参数值。

使用JavaScript脚本可以实现更加复杂和灵活的参数控制逻辑。

在报表生成时，Birt报表引擎会根据参数的定义和传递的参数值来生成报表。

报表生成过程中，Birt报表引擎会根据参数值对报表进行相应的数据过滤、显示控制或格式化处理。

06-Birt工具关于使用外部数据源的配置手册

关于使用外部数据源的报表的配置问题--2010-8-27根据前期报表的设计讨论，使用外部数据源的情景如下：用户配置了一个报表，主SQL已经确定，即需要查询的数据集已经确定，但是参数的数据来源在后期需要重新变化，如ad-hoc生成的临时表。

为了不用再去重新设计一张报表，特别设计了该功能。

由于时间仓促，有些地方没有考虑全面，需要在脚本中进行一些调整，还请见谅。

外部数据源报表的配置如下：1、配置一张报表，数据集主SQL如下：图1当然，也可以添加一些其他条件。

2、设计报表参数图2对于报表参数，暂时只对字符串类型的参数进行了处理，所以，请使用字符串数据类型。

3、数据库配置图3数据库配置时，请注意图3画红色框框的地方。

表：t_birt_table_sql字段：QRY_ID 报表名称字段：QRY_FILED_NAME 即图2中参数名称字段：QRY_SQL 参数的数据来源，如果只提供一个字段，数据显示的名称和数据值将显示一样。

字段：STAFF_ID 员工编号，即用户登录系统后，系统使用的员工编号4、修改脚本在数据集的beforeOpen脚本中添加如下脚本代码//获取参数信息var userIds=params["user_id"].value;var querySQL=this.queryTextvar whereClause=" 1=1 ";//判断参数是否为空或者没有数据输入if(userIds!=null&&userIds!=''){//拼SQLwhereClause += " and user_id in ('";//如果是外部数据源数据，一般会获得一个如下格式的字符串//[a,b,c]或[a]或[]//将其按照逗号拆分var userIdArray=userIds.split(",");//如果拆分的结果为空或者没有数据，跳出if(null != userIdArray && userIdArray.length > 0){//将拆分的结果拼接起来，这里利用了js的一些自带函数//拆分结果格式 "[a","b","c]"//预期拼接结果"[a','b','c]"var str = userIdArray.join("','");//去掉数组转换时的中括号//如果首尾为一对中括号，一般是外部数据源if("["== str.substring(0,1) && "]"== str.substr(str.length-1)){//掐头去尾str = str.substring(q,str.length-1);}//补充完SQLwhereClause += str + "')"; }else{whereClause += "')"}}//拼接SQLif(whereClause!=null&&whereClause!=''){this.queryText += " where "+ whereClause; }5、测试...。

birt入门文档(自己整理)

Birt 入门文档目录1 BIRT -前言 (1)2 BIRT -简介 (1)3 BIRT -配置安装 (2)3.1 下载 (2)3.2 安装以及汉化 (2)4 BIRT -简例 (2)4.1 创建一张报表 (3)4.2 创建报表数据源和数据集 (5)4.3 构建Table (9)4.3.1 构建明细表 (9)4.3.2设置边框，样式 (10)4.3.3创建报表参数 (11)4.3.4设定颜色标识 (13)4.3.4过滤器使用 (15)5 BIRT -小结和回顾 (16)1 BIRT -前言本文档在简介BIRT这个开源免费的报表开发工具后将引导你设计出简单的报表，如想进一步了解BIRT的使用可参考BIRT在Eclipse中自带的帮助，Help→Help Contents。

2 BIRT -简介BIRT是一个Eclipse-based开放源代码报表系统。

BIRT是Business Intelligence and Reporting Tool的简写,即商业智能与报表工具。

它主要是用在基于Java与J2EE 的Web应用程序上。

BIRT主要由两部分组成：一个是基于Eclipse的报表设计器，另一个是可以加到你应用服务的运行期组件。

BIRT同时也提供一个图形报表制作引擎。

URL: /birt/ 这个网址可以找到BIRT，可以去看看。

使用BIRT可以开发出多样化的报表应用，包含：列表（最简单的报表就是列出数据）、图标（饼图，折线图，柱状图等）、交叉表（通过二维显示数据）、字符和文档、复合报表（多个报表组成）等。

有人总结了许多它的优点。

看一下：•操作界面友好大方；•功能并不逊色与商业报表工具；•CSS提供了强大灵活的样式定义，对于属性CSS的设计人员来说，应该可以设计出相当出色的报表样式；•集成在Eclipse中，不用再开启别的报表开发工具窗口；•BIRE的本地化做的很好，安装以后，可以汉化；•开源免费的报表产品，降低开发成本，一些报表开发工具除了价格昂贵以外，还有用户限制；3 BIRT -配置安装3.1 下载在BIRT官方网站/birt/ 下载。

birt报表参数

birt报表参数BIRT报表参数是一种用于生成动态报表的工具，它可以根据用户的需求来动态地改变报表的内容和显示方式。

在本文中，我将介绍BIRT报表参数的一些基本概念和使用方法。

让我们来了解一下什么是BIRT报表参数。

BIRT报表参数是一种用于传递数据给报表的方式，它可以让用户在生成报表时输入一些参数值，从而影响报表的生成结果。

比如，我们可以通过报表参数来过滤数据、排序数据、设置报表的标题等等。

在BIRT中，报表参数的定义是在数据源上的，我们可以在数据源中定义一些参数，并在报表设计中使用这些参数。

当用户生成报表时，系统会提示用户输入参数值，并根据参数值来生成报表。

在使用BIRT报表参数时，首先需要在报表设计中定义参数。

定义参数的方式是在报表设计的参数视图中添加一个新的参数，并设置参数的名称、数据类型、默认值等属性。

参数的数据类型可以是字符串、整数、日期等，根据实际需求来设置。

定义好参数后，我们可以在报表设计的其他地方使用这个参数。

比如，我们可以将参数值作为过滤条件来过滤数据，或者将参数值作为标题的一部分来显示在报表上。

在使用BIRT报表参数时，我们可以通过多种方式来传递参数值。

一种常见的方式是通过URL传递参数值。

在URL中，我们可以使用参数名和参数值的键值对来传递参数值。

比如，我们可以使用以下URL来传递参数值：```http://localhost:8080/birtviewer/frameset?__report=report.rpt design&param1=value1&param2=value2```在上面的URL中，param1和param2是参数的名称，value1和value2是参数的值。

通过这种方式，我们可以在生成报表时动态地传递参数值。

除了通过URL传递参数值，我们还可以通过其他方式来传递参数值。

比如，我们可以在程序中使用API来设置参数值，或者在报表生成界面上手动输入参数值。

03-Birt工具设计器配置手册

Birt报表设计器配置手册Birt是安讯公司开发的一个优秀的报表插件, 是一个Eclipse-based开放源代码的报表系统，它主要是用在基于Java和J2ee的web应用程序上。

使用Birt报表工具拥有和Dreamweaver相似的操作界面，可以通过简单的拖拽和属性设置来制作各种式样和类型的报表；且很方便的在一个报表中混合展现概要数据和详细数据；同时提供了灵活的CSS样式支持，可以设计出相当漂亮美观的报表；生成的报表完全是XML格式，扩展性好；也可以生成多种类型图片、导出Excel、html、PDF、PPT、XLS 等多种类型文档；提供了本地化的语言包，更新后操作界面为中文。

1. Birt设计工具获取与安装Birt的官方下载地址是：/birt/downloads/，目前的最新版本为2.5.2。

官方提供了两种下载方式：1)All-in-One 版本，它包含了运行Birt系统所需的组件，可直接应用。

2)Framework插件版本，安装的必要环境为Java 1.4.2/1.5 JDK/JRE; Eclipse SDK 3.2,GEF 3.2 and EMF 3.2。

安装步骤如下：打开Eclipse文件夹，在文件夹中再新建一文件夹（如：Birt）,然后打开birt-report-framework-2.5.2.zip把其中的eclipse文件夹放入新建的Birt文件夹中。

然后在同文件夹的links文件夹中，新建一个.link文件（如：birt.link），且修改.link文件路径（如：path=D:\Eclipse\Birt）;或者把Framework包解压，然后和其它plugin一样放到Eclipse的plugins和features目录下即可，完成后目录结构如下：注意：Birt的运行依赖于GEF和EMF，所以你的Eclipse平台要正确安装GEF和EMF。

2. 插件的获取与安装如果需要输出PDF格式显示报表结果，需要下载itext.jar支持包和prototype.js：itext-1.3.jar: /itext/itext-1.5.4.jarprototype.js: /repos/prototype/dist/prototype.js下载完成后将itext-1.3.jar拷贝到plugins\com.lowagie.itext_version\lib\目录下;将prototype.js拷贝到如下目录：plugins\org.eclipse.birt.report.viewer_version\birt\webcontent\birt\ajax\lib\如果输出PDF要显示亚洲语言，需要下载iTextAsian.jar支持包：/itext/itextasian-1.5.2.jar下载完成后将itext-1.3.jar拷贝到plugins\com.lowagie.itext_version\lib\目录下。

birt报表初级教程之数据源配置

birt报表初级教程之数据源配置数据源配置在布局编辑器中开始设计报表之前，构建BIRT数据源以将报表连接至数据库或其他类型的数据源。

构建数据源时，要指定驱动程序类、数据源名称和其他连接信息（例如，用户名和密码）。

Birt自带一个已经配置为与BIRT报表设计器配合使用的样本数据库Classic Models，对于本教程使用的是Derby数据库。

1.选择数据资源管理器(Data Explorer)。

如果使用缺省报表设计透视图，则数据资源管理器位于布局编辑器的左边，在选用板（Palette）的旁边，如图所示。

如果它尚未打开，则选择窗口->显示视图->数据资源管理器。

2.右键单击Data Sources然后从上下文菜单中选择新建数据源。

新建数据源显示可以创建的数据源的类型，如图所示。

●Classic Models Inc.Sample DataBase———上面说过是BIRT样本数据库。

●Flat File Data Source———从CSV、SSV、TSV、PSV四种格式的文件获取数据源。

●JDBC Data Source———通过配置jdbc连接数据库。

●Script Data Source———通过编写脚本获取数据源。

●Web Services Data Source———通过web service方式获取数据源。

●XML Data Source———从xml文件获取数据源。

3.这里我们介绍通过JDBC Data Source配置数据源。

选择JDBC Data Source，输入数据源名称，点击Next,配置Jdbc信息。

如下图：●首先，单击Manage Drivers添加驱动包。

如下图：单击add，选择derby数据库的derbyclient.jar驱动包。

点击ok，驱动完成添加。

●配置信息：Driver Class:org.apache.derby.jdbc.ClientDriver(v10.1)(通过下拉菜单可以找到)Database URL:jdbc:derby://【host】:1527/【database】User Name：用户名Password：密码4.测试连接，测试前查看derby数据库是否启动；点击Test Connection。

1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。

BIRT参数设置详解2010-08-25 16:30在使用birt报表的时候感觉页面的 BIRT Report Viewer头标题没有用，想去掉在网上一查原来有详细的参数设置，看来birt的功能还是很强大啊。

现在转帖如下：BIRT作为一款功能强大的开源报表工具，其版本的升级更新速度也非常快，从1.0到2.0，一直到最新的2.2.1版本，无论从功能上还是性能上都得到了极大的提高和扩充。

BIRT也提供了一个标准的J2EE实现组件，可以发布到支持J2EE 应用的web server服务器上，可以对生成的报表进行预览等操作。

在大家使用BIRT Viewer的时候，可能会对它日益纷繁的参数设置如云里雾里，在网上论坛里也有很多人碰到这样哪样的问题，同时官方的文档也不细致不全。

所以我就对这些参数进行了一个简单系统的总结，希望能对大家的BIRT开发有所帮助。

这些参数以2.2.1版本为准，请大家特别注意。

1. Servlet模式说明查看BIRT Viewer自带的web.xml文件，可以看到有以下几个pattern：frameset ---- 采用Ajax框架，可以显示工具条，导航条和TOC面板，实现复杂的操作，如分页处理，导出数据，导出报表，打印等等。

该模式下会自动生成report document文件(预览report design文件)到特定的目录(用户可以用参数指定，也可以定义在web.xml里)。

采用Ajax，速度较慢。

run ---- 也采用Ajax框架，但不实现frameset的复杂功能，不会生成临时的report document文件(预览report design文件)，也不支持分页，这个主要是应用在BIRT Designer里的preview tab里，可以支持cancel操作，其它不怎么常用。

采用Ajax，速度较慢。

preview --- 没有用到Ajax框架，直接调用底层Engine API对报表进行render，把生成的报表内容直接输出到浏览器。

这种模式和run模式调用的是相同的Engine API，唯一区别在于run采用Ajax获取报表内容，而preview直接输出到浏览器。

如果要支持分页，用户需要在URL上定义__page和 __pagerange参数，这两个参数也会在后面详细说明。

需要特别说明的是，在这几种预览模式中，preview的速度是最快的。

document --- 该模式主要是为了从report design文件生成report document 文件。

用户可以在URL上提定document文件生成存放的路径(存放在server端)，如果未指定，会直接生成 rptdocument发送到客户端浏览器，用户可以下载到客户端。

output --- 该模式类似于frameset，会自动生成report document文件(预览report design文件)，区别在于output不采用Ajax，而是将生成的报表内容直接输出到浏览器。

parameter --- 该模式主要用于生成一个参数对话框，一般用户不常用，用户可以直接通过提供的JSP Tag--parameterPage去实现参数对话框，不需要直接调用。

download --- 用于导出报表数据为CSV格式，当你使用frameset工具条里的导出数据功能时，会用到这个模式。

2. web.xml里的参数设置web.xml文件里有许多参数，用户应该根据自已的需求出发对这些参数有一个深入的了解。

下面我会对这些参数一一做以说明。

[BIRT_VIEWER_LOCALE]设置默认的Locale信息，暂时没有太大意义。

因为Locale的信息，首先以URL 上定义的__locale为准，如果没有定义，会找到当前浏览器的Locale信息，最后才会用到这里定义的信息。

[BIRT_VIEWER_WORKING_FOLDER]设置BIRT Viewer的工作目录。

用户可以把report design或是report document 文件存放在这个目录下，这样就可以在URL上采用相对路径去预览这些报表文件了。

默认是当前根目录。

当前支持三种形式：相对路径 --- 这个相对当前的WEB应用的context root.绝对路径JAVA系统变量 --- 可以在启动服务器时，定义JVM的系统变量，如java–Dmyworkingfolder=D:/reports。

这样就可以在web.xml中用${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_SCRIPTLIB_DIR]设置用户script lib文件的存放目录( 在报表中用到的Java Event Handler Class )。

默认值是scriptlib。

路径设置同工作目录设置。

[BIRT_RESOURCE_PATH]设置用户资源存放路径，这些资源包括library文件，image文件等。

默认是当前根目录。

路径设置同工作目录设置。

[BIRT_VIEWER_MAX_ROWS]设置获取dataset的最大记录数。

主要应用于设计报表的时候，预览报表如果记录数太多，会花费很多的时间，也可能会引起out of memory问题。

默认是不限制。

[BIRT_VIEWER_MAX_CUBE_LEVELS]设置CUBE查询的最大级数。

和前面的参数作用类似。

默认是不限制。

[BIRT_VIEWER_CUBE_MEMORY_SIZE]设置在生成CUBE时，可以写在memory中的最大值，单位是MB。

可以提高效率，写在内存会比直接写在硬盘快很多。

但同时也要注意内存占用的问题。

[BIRT_OVERWRITE_DOCUMENT]该参数主要用于frameset/output模式，它们会生成临时的document文件上。

如果设为true，则每次刷新页面时，都会重新去生成document文件，如果为false，则不会重新生成，只会用原来的document文件去生成报表内容。

[BIRT_VIEWER_CONFIG_FILE]定义properties文件的路径，不可以修改。

[BIRT_VIEWER_PRINT_SERVERSIDE]在frameset工具条上，提供有后台服务器打印的功能，该参数可以设置是打开还是关闭后台打印的功能。

默认是打开。

可选值为: ON 和 OFF。

[HTML_ENABLE_AGENTSTYLE_ENGINE]这个参数是会传递给Engine的，主要用于一些CSS的兼容性方面的问题。

默认值是true。

3. viewer.properties参数设置viewer.properties文件主要是定义一些扩展的参数。

# configurable variable for JSP base href. Please uncomment the below line.#base_url=http://127.0.0.1:8080该设置主要应用于代理服务器的情况下，在使用代理服务器后，从request里获取的URI并非真正的URI，需要在这里定义。

# [EXTENSION SETTING]viewer.extension.html=htmlviewer.extension.pdf=pdfviewer.extension.postscript=psviewer.extension.doc=docviewer.extension.xls=xlsviewer.extension.ppt=ppt定义输出的报表文件的后缀名，和format相关联。

# [OUTPUT FORMAT LABEL NAME]bel.html=HTMLbel.pdf=PDFbel.postscript=PostScriptbel.doc=Wordbel.xls=Excelbel.ppt=PowerPoint定义导出报表对话框里的报表格式列表，和format相关联，这样名字会更有意义。

# [CSV SEPARATOR]viewer.sep.0=,viewer.sep.1=;viewer.sep.2=:viewer.sep.3=|viewer.sep.4=\t支持多种CSV分隔符，用户也可以增加新的分隔符(只支持char，而不是string)。

但同时需要修改JSP文件和Messages.properties文件。

# [LOGGERS]# "logger."+class=level# if no level is specified or the text "DEFAULT",# then the default level from the web.xml will be used.eclipse.datatools.connectivity.oda=DEFAULT.eclipse.datatools.enablement.oda=DEFAULT当前的日志都是通过Engine输出的，如果需要其它组件的日志输出，可以在这里定义。

注意格式必须为……。

而且该组件必须实现了java的logger。

可以单独为该组件设置日志级别，如果设为DEFAULT，就会使用web.xml里的设置。

4. URL参数下面是一些主要用到的URL参数。

“__report”定义要预览的rptdesign文件路径，支持相对路径和绝对路径，相对路径是相对于web.xml中定义的工作目录。

“__document”定义要预览的rptdocument文件路径，同样支持相对和绝对路径。

相对路径是相对于web.xml中定义的工作目录。

在同时定义了__report 和__document参数时，以__document为优先，如未找到相应的document文件，才会从design文件生成document文件 (frameset/output)或是直接去render这个design文件(preview/run)。