BIRT中文指南

BIRT 中文指南

BIRT -简介

BIRT是一个Eclipse-based开放源代码报表系统。它主要是用在基于Java与J2EE的Web应用程序上。BIRT主要由两部分组成：一个是基于Eclipse的报表设计和一个可以加到你应用服务的运行期组件。BIRT同时也提供一个图形报表制作引擎。

URL: https://www.360docs.net/doc/b712346532.html,/birt/

前言

这个指南将引导你设计一个简单的报表，令你对BIRT报表系统有个感性的认识，如果想进一步了解BIRT的使用可以参考

BIRT在Eclipse中自带的帮助， Select Help→Help Contents from the Eclipse menu and then click on the BIRT Developer Guide.

个人体验

操作界面友好大方，小图标都很漂亮：）；

功能并不逊色与商业报表工具；

CSS提供了强大灵活的样式定义，对于属性CSS的设计人员来说，应该可以设计出相当出色的报表样式；

集成在Eclipse中，不用再开启别报表开发工具窗口；

BIRE的本地化做的很好，安装以后操作界面就是中文的；

开源的报表产品，降低开发成本，一些报表开发工具除了价格昂贵以外，还有用户限制；

BIRT -指南目录

BIRT Tutorial

Introduction

Creating a Report

Brief UI Tour

Building a Data Source

Building a Data Set

Building a Table

Testing Your Report

Setting Visual Properties

Setting Data Properties

Using Styles

Cascading Styles

Using a Grid

Using a Text Item

Next Steps

BIRT -安装指南

如何安装BIRT

BIRT 安装指南

安装方式一

下载一个BIRT All-in-one版本的 Eclipse，包含了运行BIRT系统所需的组件，最方便了（如果是将报表工具培训一下让非开发人员参与定制话可以这样做：））

URL:birt-report-designer-all-in-one-2_0_1.zip

安装方式二

假设你已经知道如何安装Eclispe插件(建议采用Link的方式安装插件，不至于全部一股脑的将各种插件都解压到Eclipse的目录中去)

运行BIRT报表系统需要以下软件或插件

Java 1.4.2/1.5 JDK/JRE

Eclipse-SDK-3.1.2-win32

Graphics Editor Framework (GEF) runtime

Eclipse Modeling Framework (EMF) runtime

BIRT

iText 1.3 - 复制 itext-1.3.jar 文件到 plugins/org.eclipse.birt.report.engine.emitter.pdf_version/lib 目录.

prototype.js v1.4.0 - 复制prototype.js 文件到 plugins/org.eclipse.birt.report.viewer_version/birt/ajax/lib 目录其他

BIRT提供的一个Flash格式的安装演示，也可以照着这个演示来安装：）

BIRT 网站提供的安装指南

BIRT 指南－介绍

介绍

这个简要的指南将引导你用BIRT建立一个简单的报表。它介绍了主要的UI 特点和大多数 BIRT 报表元素。完成这份教学指南, 您应该能开始使用自己的数据库建立自己的报表。

我们将创造一个简单的顾客目录报表, 报表通过州和城市对用户进行分组。对于每一名顾客, 我们将显示他的名字和电话号码。

报表效果如下：

安装BIRT

如果您还没有这样做, 请先安装Eclipse、GEF 、EMF 和BIRT 。您会在 BIRT 的安装页面发现完整的安装介绍。

打开BIRT

BIRT 在Eclipse中以透视图（perspective ）的方式显示。使用Eclipse主菜单的（Window ）选项打开它。选择“打开透视图”（Open Perspective）, 然后是“报表设计”（Report Design）。如果“报表设计”（Report Design）没直接出现在“打开视图”（Open Perspective）选项卡中, 可以选择其他（other）... 所有的 Perspective 名单将会列出来。选择“报表设计”（Report Design）。

Eclipse将切换显示BIRT视图。

报表样板

如果您想要立即看到一份已经完成的报表, 只需要简单地下载下面那个链接:

使用您的浏览器下载报表: customers.rptdesign.

保存文件到一个Eclipse的项目目录。 (如果您没有建立一个项目，请参见下一章节（将引导你如何建立一个项目）。)

您的浏览器可能会将它作为一个XML 文件保存。如果那样的话, 将其重命名为上面的名称（customers.rptdesign）。

在Eclipse中, 在Navigator View中选择您的项目，并通过鼠标右键单击弹出菜单，选择 Refresh 选项（将刚才复制到项目里面的customers.rptdesign文件刷新显示出来）。

双击报表将会用 BIRT 报表设计器打开它。

From SixSun - Date:2006-4-27

BIRT 指南－创建一个报表

创建一个报表

创建一个项目

创建一个报表

选择模板

创建一个项目

Eclipse 使用项目组织您的文件。因此, 第一步将创建一个新项目。作为演示, 我们创建项目叫做"My Reports":选择 File->New->Project 。新项目（new project ）对话出现。

打开"业务智能和报表工具”（Business Intelligence and Reporting Tools）组，并选择"报表项目" 。

点击下一步（next）。

输入"My Reports" (不要有引号) 作为项目名字。

点击结束（Finish）。

点击 OK ，提示你切换到报表设计视图。

创建一个报表

我们现在准备好创建我们的第一份报表:

选择File->New->Report 。新建报表（new report ）对话出现。

在Tree View中选择我们之前创建的项目：My Reports

接下来在文件名字段输入: Customers.rptdesign

点击 next。

您能创建一个报表用三种方式: 一个空白的报表, 使用BIRT 定义的报表模板, 或复制您之前已经设计好的报表。在这份教学指南中我们将使用报表模板创建报表。

选择模板

新建报表对话框显示了一些现成的模板模板。在我们选择使用哪个报表模板之前, 我们先来了解一下它们。

My First Report(我的第一份报表)

空白报表- 创建一个无预定义内容的空白报表。

简易列表- 使用数据源中的字段创建列表报表。

分组列表- 创建一个根据某些字段分组的列表报表。分组列表不会显示重复的记录。并且分组允许您创建一个子统计。

双列列表- 创建带两个子组的分组报表。

图表和类标- 创建分组报表，并附带直观表示每个组数据的图表。

双列图表和列表- 创建带两个“图表和列表”子组的分组报表

并排图表和列表- 创建一个分组报表，其中，每个组都并排包含一个图表和一个列表

信件- A form letter in which database data is "mail-merged" into the text. The letter text can be formatted using a subset of HTML.

我们现在准备选择我们需要的模板：

选择Grouped Listing.（分组列表）。

点击 Finish。

BIRT 在Eclipse工作区打开您新建的报表。

From SixSun - Date:2006-4-27

BIRT 指南－ UI 漫游

UI 漫游

Brief UI Tour

Cheat Sheets

Layout Editor（布局编辑器）

Views

Displaying Views

在我们开始在报表的工作之前, 我们快速介绍一下BIRT的开发界面。我们会接触到构建报表时候需要的大多数操作界面。

Cheat Sheets

注意在您的Eclipse工作区右边(这是默认配置)有一个Cheat Sheets View。"这个 View 会根据您所选择的模板引导你如何构建报表。（BIRT做的很人性化，操作界面也是国际化的，安装后你会发现界面是中文的:)）

布局编辑器(Layout Editor)

中心地区是布局编辑器。这是您进行报表设计的主要地方。编辑器有三个分页:

布局- 您做报表设计的地方。

预览- 运行您的报表并在输出设备显示出来。

脚本- 增加 JavaScript 脚本到您的报表来定制它的行为。

Views

在编辑器附近有多个View: View可以部署在布局编辑器附近。

调色板（Palette）- 显示标准的报表可视控件，您能够通过拖曳的方式添加到你的报表上。

概述（Outline）- 使用tree view的形式显示您的报表结构。

导航（Navigator）- Eclipse将显示你的项目和项目内的报表文件。

数据资源管理器 - BIRT View 显示您的数据源(连接), 数据集 (queries) 和报表参量。您也可以使用这个View增加数据集字段到您的报表布局（report layout）。

属性编辑器 - 显示报表项目所需的properties。它拥有标签和分组，用分类的形式来组织properties。

PropertiesView - 显示和报表相关Properties ，这个view是可选的，我们在这个指南里面不会用到它。

Displaying Views

您能安排您的Views已任意的方式布局。您能点击 "X" 按钮掩藏他们。如果您不小心隐藏了一个View, 您能再次显示它，使用Window->Show View 菜单选项。许多人发现一种方便的布局方式，将调色板（Palette）, Navigator, Outline , 数据资源管理器(Data Explorer)放在您的工作区左边缘,属性编辑器（Property Editor）和属性View(Properties View)靠在工作区的底部。

From SixSun - Date:2006-4-27

BIRT 指南－建立数据源

建立数据源

编辑您的数据源

关于数据源和数据集

关于数据源和数据集

BIRT 报表使用一个数据源连接到数据库或其它数据提供者。 BIRT 使用一个数据集从数据提供者处的检索数据。可以将数据源理解为连接, 数据集作为query。

建立数据源

让我们建立一个数据源:

打开数据资源管理器。

选择数据源节点。

用鼠标右键单击打开弹出菜单。

选择新建数据源。新建数据源对话出现。

选择 Classic Models Inc. 示例数据库

在数据源名称输入框, 输入"Sample" 。

点击 next。

点击 Finish。

您的新建的数据源出现在数据资源管理器(Data Explorer) 内。

编辑您的数据源

作为将来的参考, 我们回顾一下您将如何改变数据源:打开数据资源管理器

打开数据源节点。

双击数据源。

数据源编辑器被打开。您能做所有有需要的更改。

点击 OK 保存您的变动。

From SixSun - Date:2006-4-27

BIRT 指南－建立数据集

建立数据集

数据集编辑器页

数据库浏览器

创造Query

测试Query

编辑一个数据集

建立数据集

现在我们准备好建立和测试我们的数据集。

打开数据资源管理器

选择数据集节点。

用鼠标右键单击打开弹出菜单。

选择新建数据集。新建数据集对话将出现。

“在数据集名称”输入框，输入"Customers"。

确保数据源下拉框显示的是我们之前创建的 Sample 数据源。

确保数据集类型下拉框选中的是"SQL Select Query" 。

点击Finish。

数据集编辑器页

数据集编辑器现在打开了。我们将使用它来定义我们的quary。数据集编辑提供以下选项:

查询 - 显示您的SQL Select的语句。这是您创造和改变您的 SQL quary 的地方。一旦您有基本的quary, 您能增加WHERE 子句, 调整所选择的字段集，等等。使用 SQL 编辑器增加计算字段，由数据库引擎负责计算。使用SQL 别名子句给这样的字段命一个名字。

数据源- 显示这个数据集所属的数据源名字，您能查看或改变它。

预览结果- 测试您的查询和观看输出的结果的地方。可以在您继续进行报告设计之前确保数据是正确的。

计算列- 计算字段由 BIRT 来实现计算，您能使用 JavaScript 表达式, 及调用业务逻辑。

参数- SQL SELECT 语句能包含输入参数，传递数据到查询语句。在查询语句中他们被标记为SQL的 "?" 符号。你可以各参数设置一个名字，设置一个默认值等操作。参数必须与你的SQL "?" 符号一一对应。

过滤器- 附加的过滤器将应用于您的数据。过滤器约束传递到报表上的数据。 Where 子句也是过滤器: 由数据库执行。这个选项卡让您使用BIRT 的 JavaScript 脚本语言定义附加的过滤器。

输出列- 根据查询显示Columns, 并让您定义一个Column别名给报表使用。注意这个view显示的Columns 将是报表所能看见的。查询选项卡显示着能能从数据库选择的Columns。

数据库浏览器

切换到查询页。这个选项卡提供一个简单的数据库浏览器。

展开Sample的数据源查看这个数据库的schemas 。有一个: "CLASSICMODELS" 。

展开"CLASSICMODELS" 查看数据库的tables 列表。

展开table看它的column。

可以拖拽一个table或column 增加它的名字到SQL 编辑器。

创造查询

我们的查询非常简单, 因此我们将键入:

简单的查询

SELECT *

FROM CUSTOMERS

WHERE COUNTRY = 'USA'

测试查询

打开数据集编辑器, 跟着下面来做:

点击预览结果选项。

预览页将出现。这页显示了您在查询中选择的字段和查询结果。

核实一下顾客名单列表是否正确。

点击OK关闭数据集编辑器。

如果错误对话出现, 检查以下:

您的Eclipse被安装在空间不足的目录。

您是否依照上面输入正确的SQL 语句。

您未用分号结束您的语句。

编辑一个数据集

您新建的数据集与您的数据源一起出现在数据资源管理器。我们能使用数据集编辑器改变数据集, 并且测试它确保它返回正确的数据。

找到或打开数据资源管理器。

打开数据集节点。

双击 Customers 数据集。数据集编辑被打开。

From SixSun - Date:2006-4-27

BIRT 指南－构建Table

报表布局

报表项

构建Table细节

构建State Group

构建City Group

增加Table Column

构建列标题（Column Headings）

报表布局

我们的customer listing report 将以“表”的形式显示客户信息: 类似HTML Table, 附加了能够循环显示报表数据的能力。我们选择的Grouped Listing 模板预先为我们构建了一个“表”, 我们只需要再填装一些细节。在开发报表之前, 让我们介绍一下BIRT 的报表项。

报表项

BIRT 提供各种各样的报表项用于构建我们的报表。报表项出现在Palette view。报表项有:

标签- 插入一个静态的文本。

文本- 插入文本块(纯文本或HTML格式）和计算列值。常用来创建标题, 信格式, "邮件合并" 等。

动态文本- 插入带有可选 CLOB 数据表达式的文本块。支持通过表达式对 advanced CLOB 数据进行操作。

数据- 插入数据集列或表达式结果。

图象- 任何由浏览器支持的图象。图象可能被内嵌在一个报表文件中, 或链接到你的网络服务器上的一个文件。

网格- 提供报表项的表格布局, 很象HTML Table。

列表- 在页眉、详细信息、页脚区段中插入数据集行的灵活格式表示。

表- 以Table的形式呈现数据集中的数据。

图表- 显示商业图表，如饼图、折线图, 等。

这个指南将使用到大多数元素,除了列表、图表和动态文本。

构建明细表

新建报表对话构建了一个已经包含“表”的初始报表和一级分组。如果我们选择创建一个空白的报表, 我们也能够通过简单地由palette扯拽得到Table。

下步将增加内容到“表”。我们将用明细数据行（detail band）显示数据集中的每一条记录。:

浏览数据资源管理器，如果它还没有打开的话。

展开数据集节点。

展开我们构建的 Customers 数据集实体。这将显示数据集中可用到的 columns 。

选择CUSTOMERNAME column。

在“表”中找到明细数据行。 (它是一个灰色"明细数据行" 标签。)

然后扯拽CUSTOMERNAME column 到明细数据行的左边第二个单元格。注意, 报表设计器自动地增加对应的表头。

扯拽PHONE column 到明细数据行的最右边的单元格。

构建 State 分组

我们想要我们的客户报表根据State字段分组, 然后按照 city字段分组。使用组将导致所有具有同样 State 的数据行出现在一起。

在“表”里面找到“组页眉行”。它有一个浅灰色的"组页眉行" 标签。

扯拽STATE column 到 “组页眉行” 的最左边的单元格。

构建你自己的分组

我们之前使用的分组是报表模板自动为我们添加的。如果我们从palette扯拽得到Table, 需要我们自己来添加分组，下面将会解释如何添加一个分组。在你添加一个分组之前您必须将Table绑定到一个数据集。绑定会自动发生在当我们将第一个数据集字段添加到表的时候。但是, 如果您自己构建了一个表, 您能够在属性编辑器中使用 “绑定” 面板将一个表绑定到数据集。

构建 City 分组

其次, 我们还将构建一个 City 分组。这样将会先按照State 对数据进行分组，然后是City。

将光标悬停在表上将会有一个“表”图表显示出来。

点击“表”图标将显示出表的脚手架（就是最左和最顶端淡紫色的部分）。

用鼠标右键单击 state 组页眉的 “行标题”，出现一个弹出菜单

从弹出菜单选择“插入组->在下面”，弹出“新建组”对话框

选择了“分组依据”中选择 "CITY" ，在名字字段输入 "City"。

点击OK。

增加表列

我们需要另一个表列来显示我们的组页眉:

确保表的脚手架出现。用鼠标右键单击第一列的标题上方的阴影部分。

在弹出菜单中选择“插入->往右侧插入列”。将出现一个新的列。

拖拽row["CITY" ]表达式，移动到第二个“组页眉行”的第二列，

构建列标题

我们需要重新定义一下我们的列标题。通常BIRT 会为我们的每一个列增加一个默认的列标题。

双击在第一列标题的文本改变它。输入"州" ，按回车确定。

从palette 扯拽一个标签到第二个列标题, 键入"城市"，按回车确定。

将第三个列标题改为"名字" 。

将第最后一个列标题改为"电话" 。

From SixSun - Date:2006-4-28

BIRT 指南－测试您的报表

测试您的报表

以HTML格式预览

以PDF格式预览

测试您的报表

我们现在准备好测试报表布局。我们之前已经核实过数据集了, 我们现在要做的就是验证一下报表是否向我们期望的那样将数据显示出来。

我们点击报表编辑器左下角的“览预”分页。这个报表没有参量, 如果有的话可以选择“显示报表参量”按钮来修改。

这时会出现一个嵌入式的浏览器窗口,以HTML 格式显示报表。报表只显示为一页。运行时最好使用较小的数据集。因为示例数据库有相当多的数据, 所以我们之前使用了一个WHERE 子句限制结果的输出。我们还能够使用报表参量和数据集过滤器限制数据每次的输出量。

以下方式能改变报表的外观：

在报表的上面增加一个标题。

给列标题增加一些颜色。

缩进 city 和 state 列。

给city 和 state的主页眉行增添一些颜色。

格式化电话号码。

根据顾客名称排序。

在我们做这些外观改进之前, 我们看一下其它的报表预览方式。

以HTML格式预览

预览分页能够快速的预览你的报表。每当你切换至预览界面，BIRT将运行报表。但是, 布局和预览分页一次只能显示一个，不能同时打开（不能向 Dreamweaver等工具那样拆分设计窗口和预览窗口）。

我们能在一个独立的窗口预览报表。在工具栏找到预览按钮。使用下拉箭头将它展开。你能够在一个独立的窗口以HTML形式预览报表。这允许您的布局编辑器和预览页面之间反复切换，而不用重新启用报表。

在Web查看器中预览

这个选项与上面相类似。它允许报表使用BIRT 的Web Viewer在一个独立的窗口以HTML形式预览报表。Web Viewer提供强有力的导航功能，比如 TOC, Previous Page, Next Page, Goto Page 以及search 和 export 功能。

预览报表在网观察者使用工具栏预览按钮和选择网观察者选择或供选择地祈求文件>Preview 在网观察者。

以PDF格式预览

您能以PDF格式的形式预览。这将布局转换成一个多页PDF 格式。