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¶m1=value1¶m2=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。
birt
Birt创建
Birt集成
Birt扩展
为什么要用到报表 报表的基本概念 数据源，数据集，报表和报表项，报表参数，模板，库 报表组成
有四部分组成：数据，数据转化，业务逻辑，展现
报表种类
列表，图表，交叉表，混合报表等
报表能做什么
Birt简介
Birt是安讯公司开发的一个开源项目，是eclipse开源社区首推的开源项目。 BIRT――商业智能和报表工具。 BIRT是一个Eclipse-based开放源代码的报表系统，它主要是用在基于Java和J2ee的web应用程序上。 BIRT主要由两部分组成：一个是基于Eclipse的报表设计器和一个可以添加到应用服务器的运行组 建。BIRT同时提供一个图形报表制作引擎。 BIRT拥有和Dreamweaver一般的操作界面，可以像画table一样画报表，也可以生成图片、导出 Excel、html、pdf、ppt、xls等分页，样式比script设置简单，另外BIRT还有OLAP导航功能。
birt集成birt扩展birt创建birt简介birt创建画报表birt集成birt扩展birt创建birt简介birt创建网格报表birt集成birt扩展birt创建创建一张报表birt简介birt创建chart报表birt集成birt扩展birt创建创建一张报表birt简介birt创建分组报表birt集成birt扩展birt创建创建一张报表birt简介birt创建嵌套报表birt集成birt扩展birt创建创建一张报表birt简介birt创建交互报表birt集成birt扩展birt创建创建一张报表birt简介birt创建多层交叉报表birt创建birt扩展研究内容birt简介servicesbirt集成birt集成自建项目加入birt支持下载birtruntime230该包中有birt自带的项目把该项目放到tomcat或其它应用服务器中运行即可
Birt 报表额外需要的一些配置
Birt 报表额外需要的一些配置及一、PDF导出少字问题的配置（默认的是：Serif）（1）需要在服务器端安装CSS样式中定义的字体。
具体操作如下：（A）在birt工程路径WebRoot\WEB-INF\report-engine\platform\plugins\（org.eclipse.birt.report.engine.fonts_2.3.0.v20080606）下存在4个xml文件，分别是：fontsConfig.xml/ fontsConfig_linux.xml /fontsConfig_pdf.xml / fontsConfig_win32.xml。
由于导出PDF时出现少字的情况，需要修改fontsConfig_pdf.xml配置文件（B）在linux上安装宋体文件。
步骤如下：首先：将Windows下的宋体文件simsun.ttc,拷贝到/usr/share/fonts/chinese/TrueType/simsum其次：编辑/etc//etc/X11/fs/config 加入路径如下注：如果服务器中已经安装了CSS样式中的字体而且路径没有问题的话，则不需要配置上述操作。
二、之前出现导出Excel文件时出现错误，弹出窗口表示找不到样式。
在报表文件中使用了样式文件，我们只需要将报表文件引入到工程中，目录位置与报表放置位置相同。
三、IE高版本设置问题：（隐藏地址栏、菜单栏、状态栏实现方法）解决方法如下：第一步：IE7或者IE8 >> 工具>> Internet选项>> 安全>> Internet >> 自定义级别>> 将“允许网站打开没有地址或状态栏的窗口”和“允许由脚本初始化的窗口，不受大小和位置限制”设为启用。
第二步：IE7或者IE8 >> 工具>> Internet选项>> 安全>> 本地Intranet >> 自定义级别>>将“允许网站打开没有地址或状态栏的窗口”和“允许由脚本初始化的窗口，不受大小和位置限制”设为启用。
Birt_报表参数的使用配置说明
Birt 报表参数的使用Birt 是一款非常流行的开源报表开发工具。
本文总结了 Birt 报表中参数机制，并结合实例详细地阐述了参数的各种使用方法，最后介绍了 Birt 报表的源代码级使用。
以期为 Birt 报表使用者提供一个有益的参考。
序言参数是 birt 提供的一种很重要的机制，在 birt 中，参数具有变量的作用，它为 birt 报表的生成提供了一种灵活强大的机制。
本文基于 Birt 2.1.2 讲述 Birt 报表中一些重要的用法以及 birt 源码级的参数使用机理，为报表开发者以及报表应用程序开发者提供一个参考。
本文的示例是基于 Birt RCP designer 2.1.2 开发的，在阅读本文前，最好有 eclipse 相关经验，并且已经能够使用 Birt 插件制作一些简单报表，并了解 Birt 报表的一些基本概念，比如 Data Source（数据源），Data Set（数据集）等。
基本报表制作过程可见 developerworks 相关文章"BIRT：基于 Eclipse 的报表"。
本文示例使用 Birt 自带的 Sample 数据源，用到的数据基于图 1 所示的实体关系模型。
从这个模型中可以看出，文中示例用到三张数据库表分别为 customers，orders 和 orderdetails。
其中 customers 表的customernumber 字段作为外键出现在 orders 表中，而 orders 表的 ordernumber 字段做为外键出现在orderdetails 表中。
图 1. 实体关系模型1 标量参数(Scalar parameter)在使用 BIRT 参数的时候，首先要了解 BIRT 分为报表参数和数据集参数。
报表参数定义于整个报表内，而数据集参数定义于某个数据集（Data Set）中。
数据集参数使用的时候通常需要链接到某个报表参数或者利用绑定表（binding tab）和一个嵌套表中的某个数据元素绑定。
第一部分BIRT介绍BIRTBu...
第一部分BIRT介绍BIRT(Business Intelligenceand Reporting Tools),是为Web应用程序开发的基于Eclipse的开源报表系统，特别之处在于它是以Java和J2EE为基础。
BIRT有两个主要组件：基于Eclipse的报表设计器，以及部署到应用服务器上的运行时组件。
BIRT介绍BIRT也提供了图标引擎让你能为应用增加图标。
BIRT当前发行的版本是2.6.1。
可通过下载使用。
有了BIRT，你可以为应用程序构建丰富的报表。
列表－列表是最简单的报表。
当列表变长时，你可以把相关数据增加到同一分组（基于客户的订单分组，基于供应商的产品分组）。
如果数据是数字类型的，你可以轻松的添加到―总数‖、―平均‖、或其他汇总中。
图表－当需要图表表现时，数字型数据比较好理解。
BIRT也提供饼状、线状以及柱状图标等。
交叉表－交叉表（也叫做十字表格或矩阵）用两种维度展示数据：salesperquarterorhitsperwebpage。
（交叉表在1.0.1中没有提供，但计划在将来提供。
）信函和文档－通知、信件、以及其他文本文档都很容易通过BIRT方便建立。
文档包括正文、格式、列表、图表等。
混合报表－很多报表需要联合以上所有的报表构成单一文档。
例如，一份客户声明会列出客户所需要的信息，为当前促进(promotions)提供文本，以及提供并行的出帐和入帐列表。
一份财政报表将包括声明、图表、表格，所有这些都将进行全方位的格式化，来匹配共有的配色方案。
剖析一份报表BIRT报表包含四个部分：数据、数据转换、业务逻辑、陈述。
数据－数据库、Web服务、XML文件、Java对象等，这些都可以作为BIRT报表源。
1.0.1版本提供JDBC 支持，也支持利用编码来获取其他地方的数据。
BIRT的ODA(OpenDataAccess)框架允许任何人构建新的UI 以及运行时支持任何类型的表格式数据。
未来，单一报表可包含从任意多个数据源获取数据。
birt使用指南
birt使用指南BIRT使用指南BIRT（Business Intelligence and Reporting Tools）是一套基于开放标准的商业智能和报表工具，由Eclipse开发。
本文档将详细介绍BIRT的使用指南，包括安装、数据源、报表设计和等内容。
1、安装1.1 BIRT1.2 安装Java开发工具（JDK）1.3 安装Eclipse1.4 安装BIRT插件2、数据源2.1 连接数据库2.2 导入数据源2.3 创建数据集2.4 数据集参数设置3、报表设计3.1 新建报表3.2 报表元素添加3.3 数据绑定3.4 样式设置3.5 图表设计3.6 嵌套表设计3.7 参数设置3.8查询过滤器3.9脚本设计4、报表4.1 导出报表4.2 配置报表方式4.3 调度报表任务4.4 报表API调用附注：1、本文档涉及附件：本文档所述示例代码和演示数据已打包为附件，可以通过以下：[附件]。
2、本文所涉及的法律名词及注释：2.1 商业智能（Business Intelligence）：利用数据分析技术和工具，将企业内外部的海量数据加工分析，得出对业务决策有价值的信息。
2.2 报表（Report）：根据特定的数据和要求，结合数据分析和可视化技术，将数据以表格、图表等形式呈现，用于信息展示和决策支持。
2.3 数据源（Data Source）：报表所需的数据的来源，可以是数据库、文件、Web服务等。
2.4 数据集（Data Set）：报表中用于展示数据的集合，通常与数据源相关联。
2.5 参数（Parameter）：报表运行时可以输入的变量，用于动态筛选数据或配置报表行为。
2.6 查询过滤器（Query Filter）：用于对数据集进行过滤，筛选出满足条件的数据。
2.7 脚本（Script）：BIRT支持使用JavaScript进行报表设计，可以通过脚本实现自定义的数据处理、表达式计算及样式控制等功能。
BIRT报表中文学习手册
一、去掉Birt表格下自动生成的日期时间在报表下点击Xml Source标签，打开xml，找到<page-setup><simple-master-page name="Simple MasterPage" id="2"><page-footer><text id="3"><property name="contentType">html</property><text-property name="content"><![CDATA[<value-of>new Date()</value-of>]]></text-property></text></page-footer></simple-master-page></page-setup>把<text id="3"><property name="contentType">html</property><text-property name="content"><![CDATA[<value-of>new Date()</value-of>]]></text-property></text>这几行去掉即可。
二、Birt表格隔行换颜色1、鼠标旋停在表格上，选择Row Detail一行；2、选择script标签页，打开birt的脚本编辑窗口；3、从下拉列表中选择OnCreate，在下面加入Javascript脚本如下：if(row.__rownum % 2 == 0){this.getStyle().backgroundColor = "#E9EAEB";}else{this.getStyle().backgroundColor = "#FFFFFF";}4、保存三、Birt表格分页下面是我从网上找的方法，我试了一下不行，后来我在table里设置了Page break interval 就可以了，但是预览的时候不能看到分页1、鼠标旋停在表格上，选择Row Detail一行；2、选择script标签页，打开birt的脚本编辑窗口；3、从下拉列表中选择onPrepare，在下面加入Javascript脚本如下：var count = 0;4、从下拉列表中选择OnCreate，在下面加入Javascript脚本如下：count++;if(count % 10 == 0){style.pageBreakAfter = "always";}5、保存，使用Web Reviewer进行预览，数据可以进行分页显示了。
BIRT运行时参数说明(英文)
摘自Using the BIRT Report Viewer∙Overview∙Viewer Operations∙Run a Report∙Viewer Frameset∙Viewer Command Options∙Report Parameters∙Error ReportingOverviewThe sample BIRT viewer is optimized for use within Eclipse for the preview operation. When used outside Eclipse, it simply acts as an example of the application you might build to run and view reports. Your report viewer application must be in Java so that it has access to the BIRT engine.The Viewer performs three distinct operations, of which one is internal and not visible to your application:∙Create a parameter entry form based on the parameter definitions within the report design file.∙Given a set of report parameter values, run a report and return the output as either HTML or PDF.∙Retrieve an embedded image, or an image of a chart within the report. (Internal operation.)You can use a full-feature Viewer frameset that displays a parameter form and runs the report. Or, you can supply the parameter values and simply run the report to produce a simple HTML or PDF output page.Viewer OperationsThe BIRT viewer provides a number of URLs that control its behavior. The Viewer provides two modes of operation as given by two servlet mappings.Operation Descriptionframeset Display a frameset that has one frame that prompts the user for parameters, then displays the resulting report in another frame.run Runs the report and displays the output as a stand-alone HTML page, or as a PDF document.The servlet mapping names are case sensitive.Run a ReportThe run servlet mapping runs a report given a set of report parameters, and returns the report as an HTML page or PDF document. This servlet mapping does not provide a frameset. Use this option if you want the report to appear as a stand-alone page. Parameters must be handled in one of three ways:∙The report requires no report parameters.∙Your application already knows the values of the parameters (perhaps from a server session), and passes them along.∙Your application has created a parameter page specifically for the report.The run report URL is of the form:http://sitePrefix/birt-viewer/run?option1=value1;option2=value2;...See below for a list of available viewer command options.Viewer FramesetThe viewer command provides additional UI to work with a report. Use this URL when your report contains parameters, and you want the Viewer to display a UI so the user can enter parameter values. (You should use the run command if the caller already has the parameter values.)The frame-based viewer displays a frameset that contains three frames:∙ A left-hand navigation frame that contains the report parameters.∙ A right-hand content frame that contains the report output∙ A top toolbar frame that contains the navigation bar.The parameters frame displays a form for entering the parameters (if any) for a report. It contains a Run Report button that runs the report. The report then appears in the report frame . The user can refine the report simply by modifying parameters in the parameter frame and again by clicking Run Report.The toolbar contains a button to maximize the report. When this is done, the frameset switches to display a single frame that contains the report output.The viewer URL is of the form:http://sitePrefix/birt-viewer/frameset?option1=value1;option2=value2;...See below for a list of available command options. The command options allow you to control which of the three frames appear in the resulting web page.When you issue this command, the viewer will do one of two things:∙Run and display the report if it has no parameters, or∙Display the parameter page and ask you to enter parameters. You can then click the Run Report button to run the report.Viewer Command OptionsThe run and the frameset Viewer operations both take a set of options which include report parameters. Report parameters are defined within the report design. They appear in the URL using their internal names, not display names. Viewer options pass information to the BIRT Viewer web app. Viewer options start with a double underscore to differentiate them from report parameters. Option names and values must be encoded for use in a URL. For example:http://localhost:8080/birt-viewer/run?__report=report%5CSalesInvoice.rptdesign&Order Number=10010In the above:∙http://localhost:8080/ – The URL (including port) for your installation of the app server.∙/birt-viewer/ – The name of the BIRT Viewer servlet.∙run – The servlet mapping for running a report.∙report%5CSalesInvoice.rptdesign – Relative file system path of the report to run.The name is relative to the web app directory in which the birt-viewer wasinstalled.∙OrderNumber=10010 – The name and value of a report parameter as defined in the report design.List of OptionsThe available viewer options include:Option Description Values Default frameset run __format The output format html or pdf html Y N__isnull Identifies that a reportparameter has a nullvalueParameter name None. Required. Y Y__locale Report locale Java locale valuesuch as en, en-us orch-zh.JVM locale Y Y__report The absolute path tothe report document.None. Required. Y YreportParam Report parameter. As specified in thereport design.As specified inthe reportdesign.Y YCase-SensitivityCase-sensitivity of the options varies:∙Viewer option names and values are case-insensitive.∙Report parameter names are case-sensitive: they must match the name as defined in the design.∙The file name case sensitivity is defined by your operating system.If the URL contains a misspelled option name, or the name of report parameters are in the wrong case, then the Viewer silently ignores the parameter.The __format OptionThe type of output to produce: either html or pdf. Values are case insensitive. If a value other than pdf is provided, then the HTML format is produced.The __isnull OptionReport parameters can take a value, or can be null. (Here "null" means the database definition: the value is unknown.) By definition, date and numeric report parameters have a null value if the report parameter is provided in the URL, and the value is blank. However, string report parameters have an ambiguity: is an empty value to be considered blank (a string whose value is ""), or null? Since blank is used more often, BIRT interprets an empty report parameter value as blank. To say a string parameter is is null, just write:__isnull=yourParamWhile this option is primarily for string report parameters, it works just as well for other report parameter types as well. See the Report Parameters section below for additional details.The __locale OptionUse the __locale option to specify both the locale for report parameter values, and the locale for the report output. The locale must be a valid Java locale such as en-us, etc. as specified in the Sun Java locale guidelines. If you do not specify a locale, it defaults to the locale set in the Java virtual machine (JVM.)Values are case insensitive.The __report OptionThe __report Option names the report design to run. It can be an absolute or relative file name. If relative, the looks in the directory specified in the BIRT_VIEWER_REPORT_ROOT property in the viewer's web.xml file. The file search rules are:∙If name is absolute, use it directly.∙If BIRT_VIEWER_REPORT_ROOT is set, use this value as the base for the relative name.∙Otherwise, use the viewer web app's directory as the base for the relative name. Report ParametersReport parameters can be Boolean, Number, Date, Float or String. The values are defined as follows:DataTypeValue Encoding NotesBoolean true, false Must use the value true for a true value, all other values (including 1) are treated as false. (Uses the Java Boolean.parse() method for parsing.) Values arecase-insensitive.Number Floating point numberwith a locale-specificdecimal separator.Must not include a thousands separator, or extracharacters such as a currency symbol. Uses the Javajava.text.DecimalFormat class to parse the number.String NoneDate Locale-specific dateformat.Uses the Java java.text.SimpleDateFormat class to parsethe date.Report Parameter ValueThe rules for a given parameter foo are determined by the first rule below that takes effect:∙If __isnull=foo appears in the URL, foo's value is null.∙If foo=mumble appears in the URL, foo's value is mumble.∙If foo= appears in the URL, foo's value is blank if it is a string, and null if it is a number or date.∙If foo has a default value, foo's value is that default value.∙Otherwise, foo's value is blank for string or null for number and date.Value CheckingThe report definition provides two properties for report parameters that influence parameter validation. First, the allowNull property determines if a report parameter can benull. If a report parameter has a null value, but the allowNull property is false, then the BIRT report engine will raise an error.Second, string report parameters have a allowBlank property. If report parameter has a blank value, and allowBlank property is false, then the BIRT report engine will raise an error.Error ReportingIf an error occurs during the operation, an error page will appear.。
birt报表中文配置说明(For Maximo75)
BIRT报表配置中文说明(MX7.5)1.下载BIRT Designer 232版本（all-in-one package），如非232版本可能制作出的报表无法在maximo75中运行。
2.安装JAVA环境jdk-6u10-rc2-bin-b32-windows-i586-p-12_sep_2008.exe3.解压eclipse到任意盘符根目录（最好保持文件夹名不便，名称不要有空格）4.将\ibm\SMP\maximo\reports\birt\scriptlibrary\classes文件夹复制到：\eclipse\plugins\org.eclipse.birt.report.viewer_2.3.2.r232_20090212\birt\WEB-INF\下如：D:\eclipse\plugins\org.eclipse.birt.report.viewer_2.3.2.r232_20090212 \birt\WEB-INF\classes5.用写字板打开新的mxdatasources.properties文件，按如下格式编辑：#<DataSourceName>.<propertyName>=value# driver for ORACLE# oracle.jdbc.driver.OracleDriver# sample url for ORACLE# jdbc:oracle:thin:@<HOST>:<PORT>:<SID># driver for SQLServer# com.inet.tds.TdsDriver# sample url for SQLServer# jdbc:inetdae7a:hostname:port?database=dbname&language=us_english&nowarnings=true# driver for DB2# com.ibm.db2.jcc.DB2Driver# sample url for DB2# jdbc:db2://localhost:50000/dbaliasmaximoDataSource.url=jdbc:db2://HARRIERDB2:50000/HARRIERmaximoDataSource.driver=com.ibm.db2.jcc.DB2Driverername=maximomaximoDataSource.password=maximo# <DateSourceName>.schemaowner=value注：用绿色部分替换原文件相同位置(注意绿色部分前没有#号)，红色部分需根据系统调整，其余不用动，注意大小写敏感！！此处信息可参考文件：\ibm\smp\maximo\applications\maximo\properties\maximo.properties6.将\ibm\SMP\maximo\applications\maximo\lib中的数据库jar文件，复制到eclipse\plugins\\org.eclipse.birt.report.viewer_2.3.2.r232_20090212\birt\WEB-INF\lib中其中：ORACLE复制：oraclethin.jarSQL SERVER复制：opta.jarDB2 复制：db2jcc.jar 和db2jcc_license_cu.jar7.解压缩复制过来的JAR文件，将其中的内容解压到\eclipse\plugins\org.eclipse.birt.report.viewer_2.3.2.r232_20090212\birt\WEB-INF\classes文件夹中，覆盖COM等文件夹的内容。
birt源代码级的参数使用
Birt源代码级的参数使用清单1主要是进行报表引擎的设置和初始化，其主要目的是将Birt Home设置为Birt runtime 下ReportEngine的安装目录。
清单1//创建一个报表引擎配置对象EngineConfig config = new EngineConfig();//设置BIRT报表引擎的安装路径config.setEngineHome("C:/birt/");清单2就是打开一个报表设计文件。
报表设计文件就是指我们利用Birt报表开发工具开发的XML格式的，以.rptdesign为后缀的文件。
清单2//创建一个报表生成引擎ReportEngine engine = new ReportEngine(config);//打开一个报表设计文件IReportRunnable design = engine.openReportDesign("C:/temp/test.rptdesign");清单3、4、5是处理报表参数，清单6是创建生成报表的任务，清单7是将处理好的参数设置给报表。
清单8是进行一些输出选项的设置，比如生成什么格式（pdf，html等）的报表，结果输出到哪里（文件，输出流等），最后就是运行生成报表。
其中清单3、4、5负责处理参数。
清单3使用前面一步创建的设计文件对象生成一个IGetParameterDefinitionTask类型的paramTask，paramTask调用getParameterDefns方法获得报表中所有参数的定义，注意这里参数使用false，其效果是将报表中的parameter group 扁平化，从而以标量的形式返回所有的参数。
这样可以将参数处理的复杂性进行封装，为应用程序开发者提供简单的使用接口。
清单4是属于用户定制的步骤，因此本文没有给出相关源码。
在这一步里，用户可以通过GUI 对话框或者HTML表单动态的输入参数值，参数值一般存储到一个HashMap中。
ntp iburst参数
ntp iburst参数NTP（Network Time Protocol，网络时间协议）是一种用于同步计算机网络中各个系统的时间的协议。
它通过精确地分发时间信息来保持计算机的时间同步，以确保网络中设备间的精确协调。
在NTP中，ibtust是一种参数，它具有重要的作用。
本文将介绍ntp iburst参数的含义、作用和使用方法。
一、ntp iburst参数的含义ntp iburst参数是在NTP服务器和客户端之间交换时间信息时使用的一种标志。
iburst标志位用于加速时间同步的过程，它告知NTP客户端，如果与服务器连接失败，可以尝试更频繁地发送请求来建立连接。
二、ntp iburst参数的作用1. 加快时间同步：当客户端启动或重新与服务器连接时，使用iburst标志可以使时间同步的过程更加迅速。
默认情况下，NTP客户端会以一个相对较长的间隔发送请求，而使用iburst参数后，客户端将会以较短的间隔频繁地发送请求，从而加快时间的同步。
2. 提高时间同步成功率：由于NTP服务器通常会被广泛使用，可能会遇到连接请求的繁忙或拒绝。
使用iburst参数可以提高客户端与服务器建立连接的成功率。
当请求频率增加时，客户端更有可能在繁忙的情况下找到可用的服务器。
3. 减少启动时间：对于NTP客户端来说，与服务器建立连接并进行时间同步可能需要一定的时间。
使用iburst参数可以减少客户端的启动时间，因为通过频繁发送请求，客户端可以更快地与服务器建立连接，并加速时间的同步过程。
三、使用ntp iburst参数的方法在配置NTP客户端时，可以通过增加iburst参数来使用该标志位。
下面是一个示例配置：```server iburstserver iburstserver iburst```在这个示例配置中，`iburst`参数被添加到每个NTP服务器的配置行中。
这样一来，NTP客户端在与服务器进行时间同步时将会更频繁地发送请求，以增加连接成功的概率。
- 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_LOG_LEVEL]设置日志的level，可选的值有：ALL|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST|OFF。
级别由高到低。
[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)。