birt使用指南

山东电力集团公司门户项目组2007年1月修订页目录1.简介 (4)2.功能介绍 (4)2.1支持的报表 (4)2.2体系组成 (4)2.3J2EE应用中的BIRT (5)3.软件下载 (5)4.报表制作 (6)4.1简单的例子 (6)4.2设计细节 (19)4.3子报表设计 (23)4.4图表设计 (25)4.5图表细节 (27)4.6项目应用 (35)5.应用部署 (39)Birt 使用文档1.简介BIRT是一个Eclipse-based开放源代码报表系统。

是基于J2EE的Web应用程序上。

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

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

目前正式版本是2.1.1，2.2版已经在发布中已经有2.2M4版可以下载，中文版暂时还没有，项目中使用2.1.1的中文版本。

2.功能介绍2.1支持的报表1)列表列表是最简单的报表。

当列表变长时，你可以把相关数据增加到同一分组（基于客户的订单分组，基于供应商的产品分组）。

如果数据是数字类型的，你可以轻松的添加到“总数”、“平均”、或其他汇总中。

2)图表当需要图表表现时，数字型数据比较好理解。

BIRT 也提供饼状、线状以及柱状图标等。

3)信函和文档通知、信件、以及其他文本文档都很容易通过BIRT 方便建立。

文档包括正文、格式、列表、图表等。

4)混合报表很多报表需要联合以上所有的报表构成单一文档。

例如，一份客户声明会列出客户所需要的信息，为当前促进(promotions)提供文本，以及提供并行的出帐和入帐列表。

一份财政报表将包括声明、图表、表格，所有这些都将进行全方位的格式化，来匹配共有的配色方案。

2.2体系组成BIRT 报表包含四个部分：数据、数据转换、业务逻辑、陈述。

1)数据Web 服务、Java 对象，这些都可以作为BIRT 报表源。

2.1 版本提供JDBC 支持，也支持利用编码来获取其他地方的数据。

BIRT 的ODA(Open Data Access) 框架允许任何人构建新的UI 以及运行时支持任何类型的表格式数据。

未来，单一报表可包含从任意多个数据源获取数据。

2)数据转换报表通过对数据的分类、统计、过滤以及分组来适应用户需求。

当然，数据库能实现这些功能，当遇到普通文件和Java 对象时BIRT 必须以"simple" 数据源方式处理。

BIRT 允许复杂的操作，比如总合分组、整体共计的百分比，等等。

3)业务逻辑真实世界的数据很少提供理想的结构良好的报表。

许多报表要求用具体逻辑把原始数据转换成用户的有用信息。

如果该逻辑仅仅用于该报表，可以用BIRTJavaScript 脚本支持。

如果程序中已包含这些逻辑，可以调用已有的Java 代码。

4)表现数据准备好了，可以在很大的范围内选择表现形式。

表格、图表、文字等等都可以。

单一数据集可以有多种方式表现，而单一报表可以表现多个数据集。

2.3J2EE应用中的BIRTBIRT 报表引擎以JAR 文件方式打包，可以方便的添加到J2EE 应用中。

报表引擎是一系列的POJO，便于可以在JSP 页面集成报表。

1)UI 参数多数报表允许用户指定一些输入，这些数据叫做"报表参数"。

例如，客户报表要求显示客户数据。

参数页面可能是静态的：为每个报表进行用户定制设计。

或者可以使用参数元数据提供的动态页面，以便该单一页面为所有的报表提供服务。

2)运行报表用户提交表单参数时，你的web 应用通过这些参数向BIRT 报表引擎说明读取哪个报表设计文件，并读取数据，再产生报表输出。

当引擎运行报表时BIRT 的术语称为“工厂”。

3)数据访问报表如何从你的应用获得数据已在上面解释了。

Java 程序通常利用Java 对象为BIRT 工厂提供数据。

4)显示附加的JSP 页面，叫做阅读器，允许用户查看报表输出。

一个报表应用程序包含一个参数页，你可以为每个报表创建自定义的UI，或者使用BIRT 带来的参数元数据提供单一报表来处理多种不同报表。

3.软件下载BIRT的相关文件可以在以下地址下载：/callisto/birt/Eclipse%20BIRT%20download.htmBIrt设计器共用3个版本：1)All_in_One：在Windows平台上设计BIRT报表最快的方法，包括完整的Eclipse SDK等所有你需要的。

你还需要安装：Java 1.4.2/1.5 JDK/JRE2)FrameWork：如果你已经安装了Eclipse 3.2，你只需下载BIRT插件到你的Eclipse环境即可。

你还需要安装：Java 1.4.2/1.5 JDK/JRE; Eclipse SDK 3.2, GEF3.2 and EMF 3.23)RCP Designer：如果你需要一个专门的报表设计器而无需其他功能，那么你只需下载BIRT报表设计器的RCP版本即可。

你还需要安装：Java 1.4.2/1.5JDK/JRE。

可以视情况而定，一般只需要下载RCP Designer版本就可以了，是一个独立的设计器。

上述设计器是英文版本，中文界面还需要一个汉化包：/callisto/birt/Eclipse%20BIRT%202.1.1%20NLP%20d ownload.htm下载完成后，将其中的features和plugins包覆盖RCP Designer根目录下覆盖原目录即可完成汉化，需重新启动设计器。

BIRT要部署到J2EE应用程序中，需要下载Runtime部件：/callisto/birt/Eclipse%20BIRT%20download.htm4.报表制作4.1简单的例子4.1.1打开报表设计器运行BIRT.exe文件。

报表设计器页面如下图所示：4.1.2新建报表打开菜单“文件——新建——新建报表”，如图所示：弹出新报表属性设置框口，如下图所示：在文件名输入框中输入报表名称：如：test.rptdesign.同时也可以设置报表文件的存放路径，本人采用默认设置：点击“next”进入下一步设置，如图所示：选择新建报表所要采用的报表模板：空白报表。

其他报表模版可以自己定制在后面的创建模版中会提到。

到此报表的基本信息已经设置完。

点击 Finish。

4.1.3创建数据源右击数据源，点击新建数据源选择JDBC数据源，并对数据源名称命名，本人采用默认命名：数据源。

点击next，如下图：点击管理驱动程序，为BIRT添加新的驱动程序类。

如下图。

点击添加按钮，添加数据库驱动程序类，下图添加了mssql2005 和orcl9i的驱动类。

添加完成后，点击驱动程序（上图所示），选中刚才添加的驱动类，点击编辑。

如下图：添加url模版，点击ok 。

完成驱动类的添加。

如下图：选择刚才添加的驱动类，下图中的数据源是mssql2005。

用户名和密码后点击测试连接。

连接通过后点击 Finish。

这样就完成了一个数据源的添加。

4.1.4创建数据集选择刚才创建的数据源，以及数据集类型后点击next。

如下图：在可用数据项中会显示数据库中的表，将表拖到右边筐即可，也可以直接在右边写入sql语句。

点击Finish。

（注意：这里因为加入参数的愿意有可能会报错。

你可以不管它直接继续后面步骤。

等完成报表参数后错误就会消失。

）如下图：上面点击Finish后出现下图，在这里我们可以点击新建添加列填写新列的列名已经数据类型，数据类型可以不写，采用他默认生产的数据类型。

点击红色框中按钮，如图在弹出的表达式生成器里面写入新列的表达式，点OK。

如下图：到这里，我们就基本上完成了一个数据集。

由于上面例子中的sql加入了参数，下面就让我们来看下参数的定义和应用。

4.1.5报表参数根据刚才新建的数据集，创建相对应的报表参数,点击红色框中的按钮。

如下图:弹出报表参数编辑窗口，这里我们应该注意：在显示类型的下拉框中右文本框和列表框等选项，在后面的应用中我们会具体讲到他们的区别，这里我们先选用文本框，点ok。

如下图：4.1.6制作简单表格:我们从左边Palette窗口中拖出一个标签和一个表，放到右边的窗口中。

如下图：从右边数据集中拖出相应的数据放到表格中。

形成下图：选中表格，右击选择新建样式，这样我们可以对整个表格定义一个整体的样式风格。

根据自己需要创建好样式，点OK。

应用样式：这样我们就基本上完成了一个简单的报表，点击下图中的按钮，查看我们的成果。

输入查询参数条件。

这样就可以看到我们需要的东西了。

如下图：4.2设计细节上面我们已经通过练习制作了一个简单的报表，下面我们来看下表报制作中的一些细节问题。

4.2.1报表样式我们可以由美工制作一些专业的漂亮的样式，导入到BIRT中。

方便我们制作更加美观的表报。

如下图：4.2.2数据属性其中一个数据，对其属性编辑，我们可以解决很多细节上的问题。

双击下图中的红色部分，展开属性编辑器。

如下图：通过属性编辑器，我们可以完成许多的操作，比如：字体，格式，超链接等。

后面我们会说到运用超链接做子表。

这里我们简单介绍下映射和突出显示的作用。

具体的应用在以后的实践中掌握。

映射：例如：在数据库存储中我们用0、1代表性别。

这样通过映射我们就可以把（0、1）转换为（男、女）。

突出显示：当我们需要将低于0的数字用红色显目显示的时候就可以用到这个功能。

4.2.3参数编辑上面的例子中，我们在编辑参数的时候选用的显示类型是文本框，下面我们来看下列表框和文本框的区别。

编辑上面例子中的参数，选择列表框，动态。

新建数据集。

（注意：不可采用原来数据集）创建好新的数据集后选项新的数据集，选择参数对应的列。

点击OK，保存。

让我们看看经过参数改动后的预览情况。

它增加了参数选择的下拉框。

4.2.4去除多余空格在表格预览的时候，你或许会发现一些你不需要的空格跟在数据后面。

就和下面的情况一样碰到类似的问题我们可以用下面的办法去掉空格。

打开数据的表达式编辑器。

用以下代码就可以消除空格。

function trim(s){if (s!=null)return s.replace(/(^\s*)|(\s*$)/g, "");return s;}trim(dataSetRow["dq"])4.3子报表设计这里我们简单介绍下子报表的设计，以上面的例子做为子报表。

首先，我们需要将子报表的参数重新编辑，改为文本框的输入，否则母报表将不能把参数传入子报表中。

下面我们来设计一个简单的母报表，让它与子报表相连接。

（1）、创建下面报表（2）、选择【dq】，打开它的属性编辑器。

选择超级链接。

在超级链接选项中a)选择追溯类型b)选择例子一中制作完成的报表c)选择例子一中的参数，在必需上打勾，然后为参数选择一个母表上的传入值。