1、BIRT -简介BIRT 是一个 Eclipse-based 开放源代码报表系统。它主要是用在基于 Java 与 J2EE 的 Web应用程序上。BIRT 主要由两部分组成：一个是基于 Eclipse 的报表设计和一个可以加到你应用服务的运行期组件。BIRT 同时也提供一个图形报表制作引擎。 URL: http:/www.eclipse.org/birt/ 前言这个指南将引导你设计一个简单的报表，令你对 BIRT 报表系统有个感性的认识，如果想进一步了解 BIRT 的使用可以参考 BIRT 在 Eclipse 中自带的帮助， Select HelpHelp Contents from the
2、Eclipse menu and then click on the BIRT Developer Guide.如图个人体验 操作界面友好大方，小图标都很漂亮：） ； 功能并不逊色与商业报表工具； CSS 提供了强大灵活的样式定义，对于属性 CSS 的设计人员来说，应该可以设计出相当出色的报表样式； 集成在 Eclipse 中，不用再开启别报表开发工具窗口； BIRE 的本地化做的很好，安装以后操作界面就是中文的； 开源的报表产品，降低开发成本，一些报表开发工具除了价格昂贵以外，还有用户限制； BIRT 安装指南安装方式一下载一个 BIRT All-in-one 版本的 Eclipse，包含了
3、运行 BIRT 系统所需的组件，最方便了（如果是将报表工具培训一下让非开发人员参与定制话可以这样做：） URL:birt-report-designer-all-in-one-2_1_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
4、 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 网站提供的安装
5、指南 运行报表（tomcat/weblogic/jboss）Birt 使用入门1. 环境 报表设计器：可以到 http:/download.eclipse.org/birt/downloads/下载最新版本，当前的最新版是 birt-rcp-report-designer-2_1_1。将下载来的 zip 压缩包解压到相应的目录，如：E:birt-rcp-report-designer-2_1_1。 可运行环境：可以到 http:/download.eclipse.org/birt/downloads/下载最新版本，当前的最新版是 birt-runtime-2_1_1。将其解压到相应目录，如：E
6、:birt-runtime-2_1_1。 可运行服务器：本人采用的是 Tomcat5.0weblogic8.1.4 及以上版本，jdk1.4.2。其他：下载所需要的 jar 包 itext-1.3.jar，iTextAsian.jar 和，Copy itext-1.3.jar, iTextAsian.jar to brit/WEB-INF/platform/plugins/com.lowagie.itext/lib.2. 简单报表例子步骤如下： 打开报表设计器：运行 E:birt-rcp-report-designer-2_1_1 目录下的 birt.exe文件。报表设计器页面如下图所示： 新
7、建报表：打开菜单“文件新建新建报表” ，如图所示：弹出新报表属性设置框口，如下图所示：在文件名输入框中输入报表名称：如：test.rptdesign.同时也可以设置报表文件的存放路径，本人采用默认设置：E:birt-rcp-report-designer-2_1_1workspace。电击“next”进入下一步设置，如图所示：选择新建报表所要采用的报表模板：空白报表。到此报表的基本信息已经设置完，如果不需要设置其他内容，则可以点击“Finish”按钮，如果还需要设置其他内容，点击“Next”按钮，进入下一步设置，如图所示：此步的作用是：将报表内容转换成模板时所需要的信息，输入相应信息。也可以不
8、用填写，点击“Finish”按钮完成新报表的基本信息设置。这样就建好了一张空白的报表。如图所示 设置报表选择“数据库资源管理器”视图，如果没有，可以点击菜单“窗口”“显示视图”“数据库资源管理器” ，同样也可以打开“数据库资源管理器” 。如图所示：1) 设置数据源：即连接数据库右键单击“数据源” ，选择“新建数据源” 。弹出数据源属性窗口，如图：选择相应的数据源类型，如“JDBC Data Source”，输入数据源名称“Test” ，电击“Next”按钮进入下一步设置，如图：选择所需驱动程序类，如果所需驱动不存在，则可以点击“管理驱动程序”按钮，如图：点击“添加”按钮选择所需驱动程序所在的
9、jar 包。本人用的是“ojdbc14.jar”，此包为 oracle 数据的驱动包。添加完后点击“ok”进入到设置数据源的主页面，电击“驱动程序类”下拉框选择驱动程序类，刚添加的驱动已经存在，如图：选择“oracle.jdbc.driver.OrableDriver(v1.0)”项，输入数据库 URL、用户名及密码。输入完后，点击“测试连接”按钮，检测是否正确连上。点击“Finish”按钮完成数据源的设置。2) 设置数据集：即设置查询的数据集右键单击“数据集” ，选择“新建数据集” ，如图：弹出设置数据集属性的对话框，如图：输入数据集名称（Test） 、选择数据源（Test） 、选择数据集类
10、型（SQL Select Query）.。点击“Finish”按钮，弹出编辑数据集窗口，如下所示：在右边的空白编辑区输入查询 SQL 语句，点击左边的“预览结果” ，可以看到查询处的结果集。如图：点击左边“输出列” ，设置输出列的显示名称，如图：点击“ok”按钮完成数据集的设置。进入设计器页面。3) 建报表项：右键单击右边编辑区，选择“插入”“表” ，如图所示：弹出表属性框：如图：设置表的列数（3）及明细数据数（1） ，点击“ok”按钮完成插入表操作。在编辑区出现了表，如：此表包含了页眉（表头） ，明细数据行（数据） ，页脚行。拖动左边数据集“Test”下的列到表的相应明细数据行，如图：拖完后
11、点击“预览” ，在编辑区就可以看到报表数据，如图：这样一个简单的报表就做出来了。 运行报表（tomcat5.0 以上）1) 将 E:birt-runtime-2_1_1Web Viewer Example 文件夹拷贝到应用服务器的E:Tomcat5.0webapps目录下，并修改此文件夹名为“birt” 。2) 将驱动程序包“或 classes12.jar”拷贝到 E:Tomcat5.0webappsbirtWEB-INFlib下。3) Copy itext-1.3.jar to brit/WEB-INF/platform/plugins/com.lowagie.itext/lib.4) Co
12、py iTextAsian.jar to / brit /WEB-INF/platform/plugins/com.lowagie.itext/lib. 5) 将 E:birt-rcp-report-designer-2_1_1workspace包下的 test.rptdesign 文件拷贝到 E:Tomcat5.0webappsbirt下。6) 启动服务器：运行 E:Tomcat5.0binstartup.bat 文件7) 打开浏览器，在地址栏输入：http:/127.0.0.1:8080/birt/frameset?_report=test.rptdesign，即可以看到数据，如图：到此一
13、张简单的报表完成。 运行报表（weblogic8.1.4 以上）8) 将 E:birt-runtime-2_1_1WebViewerExample 部署到应运服务器，并修改此文件夹名为“birt” 。9) 将驱动程序包“ojdbc.jar 或 classes12.jar”以及拷贝 commons-logging.jar到 E:birt-runtime-2_1_1birtWEB-INFlib下。10) Copy itext-1.3.jar to brit/WEB-INF/platform/plugins/com.lowagie.itext/lib.11) Copy iTextAsian.jar
14、to / birt /WEB-INF/platform/plugins/com.lowagie.itext/lib. 12) 启动服务器：运行 weblogic13) 打开浏览器，在地址栏输入：http:/127.0.0.1:7001/birt/frameset?_report=test.rptdesign，即可以看到数据BIRT 指南介绍介绍这个简要的指南将引导你用 BIRT 建立一个简单的报表。 它介绍了主要的 UI 特点和大多数 BIRT 报表元素。 完成这份教学指南, 您应该能开始使用自己的数据库建立自己的报表。 我们将创造一个简单的顾客目录报表, 报表通过州和城市对用户进行分组。 对
15、于每一名顾客, 我们将显示他的名字和电话号码。 报表效果如下： 安装 BIRT如果您还没有这样做, 请先安装 Eclipse、GEF 、EMF 和 BIRT 。 您会在 BIRT 的安装页面发现完整的安装介绍 。 打开 BIRTBIRT 在 Eclipse 中以透视图（perspective ）的方式显示。 使用 Eclipse 主菜单的（Window ）选项打开它。 选择“打开透视图”（Open Perspective）, 然后是“报表设计” （Report Design）。 如果“报表设计” （Report Design） 没直接出现在“ 打开视图” （Open Perspective）选
16、项卡中, 可以选择其他（other）. 所有的 Perspective 名单将会列出来。 选择“ 报表设计”（Report Design）。 Eclipse 将切换显示 BIRT 视图。 BIRT 指南创建一个报表创建一个报表 创建一个项目 创建一个报表 选择模板 创建一个项目Eclipse 使用项目组织您的文件。 因此, 第一步将创建一个新项目。 作为演示, 我们创建项目叫做“My Reports“: 选择 File-New-Project 。 新项目（new project ）对话出现。 打开“业务智能和报表工具”（Business Intelligence and Reporting T
17、ools）组，并选择“报表项目“ 。 点击下一步（next ） 。 输入“My Reports“ (不要有引号) 作为项目名字。 点击结束（Finish） 。 点击 OK ，提示你切换到报表设计视图。 创建一个报表我们现在准备好创建我们的第一份报表: 选择 File-New-Report 。 新建报表（new report ）对话出现。 在 Tree View 中选择我们之前创建的项目：My Reports 接下来在文件名字段输入: Customers.rptdesign 点击 next。 您能创建一个报表用三种方式: 一个空白的报表, 使用 BIRT 定义的报表模板, 或复制您之前已经设计好
18、的报表。 在这份教学指南中我们将使用报表模板创建报表。 选择模板新建报表对话框显示了一些现成的模板模板。 在我们选择使用哪个报表模板之前, 我们先来了解一下它们。 My First Report(我的第一份报表 ) 空白报表- 创建一个无预定义内容的空白报表。 简易列表- 使用数据源中的字段创建列表报表。 分组列表- 创建一个根据某些字段分组的列表报表。 分组列表不会显示重复的记录。 并且分组允许您创建一个子统计。 双列列表- 创建带两个子组的分组报表。 图表和类标- 创建分组报表，并附带直观表示每个组数据的图表。 双列图表和列表- 创建带两个“图表和列表” 子组的分组报表 并排图表和列表-
19、创建一个分组报表， 其中，每个组都并排包含一个图表和一个列表 信件- 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 工作区打开您新建的报表。 报表样板如果您想要立即看到一份已经完成的报表, 只需要简单地下载下面那个链接: 使用您的浏览器下载报表: cu
20、stomers.rptdesign . 保存文件到一个 Eclipse 的项目目录。 (如果您没有建立一个项目，请参见下一章节（将引导你如何建立一个项目） 。) 您的浏览器可能会将它作为一个 XML 文件保存。 如果那样的话, 将其重命名为上面的名称（customers.rptdesign） 。 在 Eclipse 中, 在 Navigator View 中选择您的项目，并通过鼠标右键单击弹出菜单，选择 Refresh 选项（将刚才复制到项目里面的 customers.rptdesign 文件刷新显示出来） 。 双击报表将会用 BIRT 报表设计器打开它。 BIRT 指南UI 漫游UI 漫游
21、Brief UI Tour Cheat Sheets Layout Editor（布局编辑器） Views Displaying Views 在我们开始在报表的工作之前, 我们快速介绍一下 BIRT 的开发界面。 我们会接触到构建报表时候需要的大多数操作界面。 Cheat Sheets注意在您的 Eclipse 工作区右边 (这是默认配置) 有一个 Cheat Sheets View。“这个 View 会根据您所选择的模板引导你如何构建报表。 （BIRT 做的很人性化，操作界面也是国际化的，安装后你会发现界面是中文的:)） 布局编辑器(Layout Editor)中心地区是布局编辑器。 这是您
22、进行报表设计的主要地方。 编辑器有三个分页: 布局- 您做报表设计的地方。 预览- 运行您的报表并在输出设备显示出来。 脚本- 增加 JavaScript 脚本到您的报表来定制它的行为。 Views在编辑器附近有多个 View: View 可以部署在布局编辑器附近。 调色板（Palette）- 显示标准的报表可视控件，您能够通过拖曳的方式添加到你的报表上。 概述（Outline）- 使用 tree view 的形式显示您的报表结构。 导航（Navigator）- Eclipse 将显示你的项目和项目内的报表文件。 数据资源管理器 - BIRT View 显示您的数据源(连接), 数据集 (qu
23、eries) 和报表参量。 您也可以使用这个 View 增加数据集字段到您的报表布局（report layout） 。 属性编辑器 - 显示报表项目所需的 properties。 它拥有标签和分组，用分类的形式来组织 properties。 PropertiesView - 显示和报表相关 Properties ，这个 view 是可选的，我们在这个指南里面不会用到它。 Displaying Views您能安排您的 Views 已任意的方式布局。 您能点击 “X“ 按钮掩藏他们。 如果您不小心隐藏了一个 View, 您能再次显示它，使用 Window-Show View 菜单选项。 许多人发现
24、一种方便的布局方式，将调色板（Palette）, Navigator, Outline , 数据资源管理器 (Data Explorer)放在您的工作区左边缘,属性编辑器（Property Editor）和属性 View(Properties View)靠在工作区的底部。 BIRT 指南建立数据源 建立数据源 编辑您的数据源 关于数据源和数据集 关于数据源和数据集BIRT 报表使用一个数据源连接到数据库或其它数据提供者。 BIRT 使用一个数据集从数据提供者处的检索数据。 可以将数据源理解为连接, 数据集作为 query。 建立数据源让我们建立一个数据源: 打开数据资源管理器。 选择数据源节点
25、。 用鼠标右键单击打开弹出菜单。 选择新建数据源。 新建数据源对话出现。 选择 Classic Models Inc. 示例数据库 在数据源名称输入框, 输入“Sample“ 。 点击 next。 点击 Finish。 您的新建的数据源出现在数据资源管理器(Data Explorer) 内。 编辑您的数据源作为将来的参考, 我们回顾一下您将如何改变数据源: 打开数据资源管理器 打开数据源节点。 双击数据源。 数据源编辑器被打开。 您能做所有有需要的更改。 点击 OK 保存您的变动。 BIRT 指南建立数据集 建立数据集 数据集编辑器页 数据库浏览器 创造 Query 测试 Query 编辑一个
26、数据集 建立数据集现在我们准备好建立和测试我们的数据集。 打开数据资源管理器 选择数据集节点。 用鼠标右键单击打开弹出菜单。 选择新建数据集。 新建数据集对话将出现。 “在数据集名称” 输入框，输入“Customers“ 。 确保数据源下拉框显示的是我们之前创建的 Sample 数据源。 确保数据集类型下拉框选中的是“SQL Select Query“ 。 点击 Finish。 数据集编辑器页数据集编辑器现在打开了。 我们将使用它来定义我们的 quary。 数据集编辑提供以下选项: 查询 - 显示您的 SQL Select 的语句。 这是您创造和改变您的 SQL quary 的地方。 一旦您有
27、基本的 quary, 您能增加 WHERE 子句, 调整所选择的字段集，等等。 使用 SQL 编辑器增加计算字段，由数据库引擎负责计算。 使用 SQL 别名子句给这样的字段命一个名字。 数据源- 显示这个数据集所属的数据源名字，您能查看或改变它。 预览结果- 测试您的查询和观看输出的结果的地方。 可以在您继续进行报告设计之前确保数据是正确的。 计算列- 计算字段由 BIRT 来实现计算， 您能使用 JavaScript 表达式, 及调用业务逻辑。 参数- SQL SELECT 语句能包含输入参数，传递数据到查询语句。 在查询语句中他们被标记为 SQL 的 “?“ 符号。 你可以各参数设置一个名
28、字，设置一个默认值等操作。参数必须与你的 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 测试查询打开数据集编辑器, 跟着下面来做: 点击预览结果选项。 预览页将出现。 这页显示了您在查询中选择的字段和查询结果。 核实一下顾客名单列表是否正确。
