`
laorer
  • 浏览: 435709 次
  • 性别: Icon_minigender_1
  • 来自: 深圳
社区版块
存档分类
最新评论

<转>BIRT:基于 Eclipse 的报表

    博客分类:
  • j2EE
阅读更多

BIRT:基于 Eclipse 的报表

 

http://www.ibm.com/developerworks/cn/opensource/os-ecl-birt/

级别: 初级

键 胡 (jianhgreat@hotmail.com), 西安交通大学硕士

2006 年 3 月 22 日

几乎在各种应用中,报表都具有其不可替代的作用。各类报表软件也是争奇斗艳,如今Eclipse也推出了自己的报表框架:BIRT。现在,让我们不妨看看它到底提供了什么样的功能,以及特点是什么。
<!----><!----><!---->

安装介绍

对于扩展 Eclipse 的功能,首先当然就是去下载对应的 plugin,BIRT 也不能例外。BIRT 的下载地址:http://download.eclipse.org/birt/downloads/,当前版本是2.0。BIRT 依赖于 Eclipse 的其它几个 plugin(GEF 和 EMF),由于我使用的是 Eclipse WTP(这是 Eclipse 的 WEB 开发工具),在这个工具中那些 plugin 都已预装,因此直接下载 birt-report-framework-2_0_0.zip 就好了。如果没有这些 plugin,请下载。

下载之后,安装非常简单:只需解压然后将对应的features和plugins目录中的内容复制到Eclipse对应的目录下即可。且慢,这只是完成了对于BIRT的基本安装。下一步就是去下载BIRT需要的第三方软件包:

  需要的jar文件 复制位置(都在plugins目录下) Apache AxisiText 1.3prototype.js v1.4.0
axis.jar
axis-ant.jar
commons-discovery-0.2.jar
jaxrpc.jar
saaj.jar
wsdl4j-1.5.1.jar
org.eclipse.birt.report.viewer_version/birt/WEB-INF/Lib
itext-1.3.jar org.eclipse.birt.report.engine.emitter.pdf_version/lib
prototype.js v1.4.0 org.eclipse.birt.report.viewer_version/birt/ajax/lib

自此,BIRT的安装大功告成。启动Eclipse,在"project wizard"中会出现一个BIRT的项目类型。





回页首


典型使用

在使用之前,了解一些关于BIRT的基本概念,将会对使用非常有益:

  • 数据源:数据的来源,或提供者。如xml数据源、jdbc数据源等。
  • 数据集:数据集合,它必须与数据源关联,可以理解为查询的结果。
  • 报表以及报表项,报表可视为是针对一组数据集的表现形式,而报表项这是这个表现形式的某个具体的单元。它们之间的关系,与窗体和控件的关系非常类似。报表、数据集、数据源三者间的关系:数据源 --- 数据集 --- 报表。
  • 报表参数:查询参数的表现形式,使用它可以构建更灵活的报表。
  • 模板和库:主要用于复用报表设计,提高报表开发的效率。

本文中的例子都采用jdbc数据源,这是最常见的使用情形,其中涉及的数据关系是一个典型的多对多关系:



1. 简单报表

首先,让我们来看看一个"Hello World"级别的应用:"列出所有用户",以便可以快速的了解BIRT。为了完成这一任务,我们需要:

A. 通过项目向导,创建BIRT工程。工程创建完毕之后,显示BIRT的"报表设计"视图。由于此时没有报表,其它几个视图,如"数据资源管理器",不可用。



B. 在项目上点鼠标右键,选择:"new -> 报表"。在报表类型中,选择"空白报表"。

C. 创建新报表后,数据视图可用。在"数据资源管理器"中创建报表所需要的jdbc数据源。根据向导,可以方便的添加jdbc驱动、数据库url、用户名和密码。

D. 在指定的数据源上,创建数据集,这一步完成产生数据集的查询。在BIRT中支持2种数据集:基于查询语句和基于存储过程。在本例中使用前者,对应的查询语句是:select user.userid, user.username, user.addr from user

E. 选择刚刚创建的数据集,将它拖至空白报表页上。BIRT会自动为其创建一个报表项,此处是"表"。如下图:



F. 选择预览,就可以看到报表运行的实际结果了。或在报表上点击鼠标右键,选择:"报表 -> 运行报表"。

非常简单,一个显示所有用户信息的报表就完成了。在此基础之上,让我们再来完成一些其它具有挑战性的任务:

1.格式化:这是一个内容广泛的主题,常见的需求:

需求 解决办法(以上为例) 显示报表列头为中文 设置报表外观 对于报表数据列进行处理 分页 页眉和页脚
如:将userid显示为"用户标识"。
选择"userid",输入"用户标识"。
选择对应的报表项,通过"属性编辑器"调整。
如:将userid和username,显示成:userid:username。双击row["userid"],出现"表达式生成器",输入: row["userid"]+":"+ row["username"]
选择"表":在"属性编辑器"中,选择"分页符",在"分页符间隔"中输入分页大小。
在报表设计页,选择"主页",在其中设置页眉和页脚。

2.排序:一种变通的做法是:将数据集排序之后,如在对应的SQL语句中使用order by,再显示。除此之外,也可以在报表设计时来完成:

A. 选择表,此时属性编辑器下方会出现与表相关的选择页。



B. 选择"排序",在对应的页面中选择"添加"按钮之后,出现:



C. 选择需要进行排序的列,以及排序方式。

3.计算列:通过"数据集编辑器"来完成。进入"数据集编辑器后",选择"计算列":输入对应的"列名称"、"数据类型"和"表达式"。

4.报表参数:它为报表的产生带来了极大的灵活性。报表参数一定是与含参数的查询对应的,否则失去了意义。现在,将以上需求改为列出"用户标识大于某一输入的所有用户":

A. 编辑数据集,修改SQL:select user.userid,user.username,user.addr from user where user.userid>?

B. 在数据集编辑窗体内选择"参数",然后输入对应的"名称"、"数据类型"、"方向"和"默认值"(必须给出默认值)。其中"方向"表示"输入"或"输出"。对于参数,一般选"输入"。完毕之后:



C. 在"数据资源管理器"视图,创建报表参数:"用户标识"。

D. 选择"表",在"属性编辑器"中选择"绑定"。此时,会出现刚才在数据集中定义的参数"id"。在"值"列,选择报表参数"用户标识":



E. 运行报表时,此时会出现报表参数的输入框,填写值后即出现报表结果。

本例虽然只定义了一个报表参数,但是BIRT并没有这样的限制。我们可以创建多个参数,做法很简单:首先,查询有多个参数;定义数据集的参数时,按照查询中参数出现的顺序定义;最后,添加需要的报表参数。

5.分组:以上为例:将用户按地址分组。

A. 选择"表",点击鼠标右键,选择"插入组"。这里有两个选择:"在上面"和"在下面"。

B. 选择任意一种,弹出分组资料窗体。填写其中的:"名称"和"分组依据"。在本例中,"分组依据"是addr列。

C. 选择预览,或运行报表,查看结果。

2. 子报表

子报表是另一种最常见的报表,以上为例:列出所有用户,并列出每个用户所购买的项目,以及项目数。为了完成这种父子关系的报表,需要:

A. 创建新报表和数据源。

B. 创建数据集user,使用SQL:select user.userid,user.username,user.addr from user。

C. 创建数据集items,使用SQL:


select item.itemid,item.itemdesc,item.price,user_item.count from item,user_item
where item.itemid= user_item.itemid
  and user_item.userid= ?
  

同时在数据集items上创建参数user,它对应SQL中的参数。

D. 从"Palette"视图拖入"列表"到报表中,在"属性编辑器"的"绑定"页中,选择数据集为user。它用来显示主表的信息,在本例中是用户信息。

E. 从"Palette"视图拖入"网格"到"列表"的"明细数据"中,设置网格为1行2列,它用来存放"用户姓名"和"用户地址"。在"数据资源管理器"视图,选择数据集user,将username和addr分别拖入网格的2列中。

F. 在"数据资源管理器"视图,选择数据集items,将它拖入"列表"的"明细数据"中,位于刚刚插入的网格下方。此时,BIRT会生成数据集items对应的"表"。

G. 选择刚刚生成的"表",在"属性编辑器"的"绑定"页中,会出现在items中定义的参数。修改它的值:row["userid"]。于是,父子报表就发生了联系。

H. 选择预览,或运行报表,就可以看到结果了。

很遗憾,到目前为止,另一种最常见的报表"交叉表"还不被BIRT支持。但是,BIRT的官方网站已明确表示,将在未来的版本中支持它。

3. 统计图表

俗话说,"一图顶千言"。没有图的报表是枯燥,且缺乏表现力的。在本例中,我们将使用图表来表示:每个用户的消费总数。

A. 创建新报表和数据源。

B. 创建数据集chart,使用SQL:


select user.username,round(sum(item.price*user_item.count),2)
from item, user_item, user
where item.itemid= user_item.itemid
  and user.userid= user_item.userid
group by user.username

C. 从"Palette"视图拖入"图表"到报表中,此时会弹出"编辑图表"窗体。

D. 在"选择图表类型"页,选择图表类型为"条形图"。在"选择数据"页,使用数据集chart,同时选中username列,将其拖入"类别x系列"。对于统计列,同样将其拖入"类别y系列"。在"图表格式"页,分别为x和y系列,填写相应的显示名称。

E. 选择预览,或运行报表,即可看到统计图表。

4. 使用脚本

可以使用脚本,是BIRT的一大特色。在BIRT中,数据源、数据集和报表项,都可以书写脚本。具体做法:选择数据源、数据集和报表项任意一种对象,然后选择"脚本"页面。如选择数据源user后,对应的脚本输入页面:



选择对应的事件,然后在下方的脚本输入框中输入脚本即可。如对于第一个例子,我们需要统计用户地址是"No.5 St."的用户数:

A. 选择数据集,然后选择"脚本",进入数据集的脚本编辑窗口。

B. 选择事件"afterOpen",在脚本窗口内输入:count=0;

C. 选择事件"onFetch",在脚本窗口内输入:if( row["addr"]== "No.5 St.") count++;

D. 选择报表,在脚本窗口选择事件"onRender",输入:this.caption=count;

E. 预览,或运行报表后,会在报表的标题输出count的数值。

另外,BIRT也支持使用java来作为报表项的事件处理程序。具体做法,请参见BIRT的帮助文档。

5. 库和模板

除了脚本使开发者可以自定义报表的行为外,BIRT还提供了库和模板机制来重用设计,加快报表的开发。在TheServerSide上有一篇相当详细的文档:Using Eclipse BIRT Report Libraries and Templates





回页首


应用集成

BIRT与现有应用的集成非常简单,由于BIRT主要是web应用,本节以web应用为例进行说明。

1. 从Eclipse BIRT官方网站下载birt-runtime-2_0_0.zip。

2. 解压之后,只需要其中的web view example目录下的内容。

3. 复制以下第三方软件包到web view example目录:

  需要的jar文件 复制位置 Apache AxisiText 1.3prototype.js v1.4.0
axis.jar
axis-ant.jar
commons-discovery-0.2.jar
jaxrpc.jar
saaj.jar
wsdl4j-1.5.1.jar
WEB-INF/Lib
itext-1.3.jar Plugins/org.eclipse.birt.report.engine.emitter.pdf/lib
prototype.js v1.4.0 ajax/lib

4. 将web view example目录发布到web容器中,如tomcat,改名:birtApp。

5. 启动tomcat,并访问birtApp。在首页中选择"View Example",如果成功发布,系统将提示成功。

6. 发布设计完成的报表文件,在birtApp中创建reports目录,用于存放报表设计文件。

7. 在应用中通过:http://localhost:8080/birtApp/frameset?__report=报表文件路径,就可以访问报表了。

这个web应用支持2个动作:

  • frameset,以frameset的形式显示报表。这个界面包含一些frame,如页面导航,报表主体在其中的一个frame中显示;使用形式:
    http://localhost:8080/birtApp/frameset?__report=报表文件路径&参数=........
  • run,报表以一个单独的html页面或pdf显示,由于这种形式没有frmaeset,因此使用者必须自己提供相应的参数,如报表参数,页号等。使用形式:
    http://localhost:8080/birtApp/run?__report=报表文件路径&参数=........

对于以上2个动作,以下列出可用的参数:

选项 说明 __format __isnull __locale __report 报表参数
报表输出格式:html或pdf,缺省是html。对于frameset不起作用。
指明一个参数是null,常用于字符串类型。如果提供参数且值为空: - 对于日期和数字类型,BIRT会将它们当作null处理。 - 对于字符串,BIRT会将它作为空字符串。因此,为了说明某个字符串是null,通常写为:__isnull=参数。
本地化选项,缺省是jvm的locale。
报表设计文件路径。
报表参数参数值对,形式:参数名=参数值。对于frameset,直接在地址栏中输入参数名=参数值后回车,不会影响报表结果。虽然,此时选择"运行报表"时,弹出的参数值已经改变。

虽然本节所说的是针对web应用的集成,但是这种方法同样也可与非web应用集成。此时,我们可以采取一种变通的方法:在非web应用中使用内嵌的web容器,如jetty,也可达到同样的效果。这种做法和Eclipse的做法类似。还记得在报表设计时使用"报表 -> 运行报表"吗?那个弹出的窗体,实际就是一个web页面。





回页首


结论

与一些老牌报表软件相比,BIRT可能仍显稚嫩。然而,它也不乏其独到之处,如脚本控制、库和模板。加之有世界领先的报表厂商Actuate支持,实际上BIRT的ROM(Report Object Model)就是Actuate捐献的,我们有充分的理由对BIRT的前景表示乐观。



参考资料



关于作者

 

胡键,西安交通大学硕士,2000 年毕业后一直从事软件开发。2002 年开始使用 Java,在平时的项目开发中经常采用 OpenSource 的工具,如 Ant、Maven、Hibernate、Struts 等,目前正在研究信息集成方面的规范和技术。可以通过jianhgreat@hotmail.com与他取得联系,或访问个人 blog:http://blog.donews.com/foxgem/


分享到:
评论
3 楼 laorer 2008-11-18  
xiaobin268 写道

我今天试了试Birt,感觉没有report易用


我现在在用 jasperReport
birt 只是转过来的,却没用。。。。

2 楼 xiaobin268 2008-11-12  
我今天试了试Birt,感觉没有report易用
1 楼 dlut_zxf 2008-07-31  
安讯中国官方论坛开通,论坛地址http://www.actuatechina.com/index.php。欢迎大家去踊跃提问与交流关于BIRT等安讯所有产品的问题,我们的工程师会在第一时间回答。

相关推荐

    BIRT:基于 Eclipse 的报表

    BIRT:基于 Eclipse 的报表 简单上手,绝对不错

    BIRT报表开发手册

    BIRT Business Intelligence and Reporting Tools 是为 Web 应用程序开发的基于 Eclipse 的开源报表系统 特别之处在于它是以 Java 和 JavaEE 为基础 BIRT 有两个主要组件:基于 Eclipse 的报表设计器 以及部署到应用...

    Java Web项目集成开源报表工具BIRT

    &lt;display-name&gt;Eclipse BIRT Report Viewer&lt;/display-name&gt; &lt;context-param&gt; &lt;param-name&gt;BIRT_VIEWER_LOCALE&lt;/param-name&gt; &lt;param-value&gt;en-US&lt;/param-value&gt; &lt;/context-param&gt; &lt;context-param&gt; &lt;param-name&gt;...

    birt报表的部署(对birt-eclipse开发的报表文件进行部署)

    **BIRT** (Business Intelligence and Reporting Tools) 是一个基于Eclipse平台的开源报表系统,主要为Java和J2EE应用程序提供报表设计和集成的功能。它不仅提供了一个强大的报表设计器,还提供了用于发布和集成报表...

    Eclipse报表插件birt

    BIRT(Business Intelligence and Reporting Tools)是一款基于Eclipse平台的开源报表系统,它为开发者提供了强大的报表设计工具以及灵活的报表运行环境。BIRT 主要针对 Java 和 J2EE 平台上的 Web 应用程序,其核心...

    解析BIRT-Eclipse商业智能和报表工具(全)

    BIRT(Business Intelligence and Reporting Tools,商业智能与报表工具)是一个基于Eclipse框架的开源报表系统。它为开发者提供了一整套完整的报告设计工具及运行时组件,允许开发者创建专业级别的报表并将其集成到...

    解析BIRT-Eclipse商业智能和报表工具

    **BIRT(Business Intelligence and Reporting Tools)是Eclipse基金会下的一个开源项目,专门用于开发商业智能和报表解决方案。本文将深入解析BIRT的功能、特点以及如何在Eclipse环境中使用它来构建高效的数据可视...

    birt培训(Eclipse-based开放源代码的报表系统)

    Birt的核心组成部分包括一个基于Eclipse的报表设计器,用于创建和编辑报表,以及一个可嵌入到应用服务器中的运行时组件,负责报表的生成和展示。\n\n报表的基本概念是理解Birt的关键。数据源是指报表数据的来源,...

    BIRT:A Field Guide to Report (Second Edition)

    BIRT(Business Intelligence and Reporting Tools)是一个基于Eclipse的开源的报表工具。它的核心是由著名的报表供应商Actuate(安讯)公司贡献。 BIRT主要是用在基于Java与J2EE的Web应用程序上,同时可以与PHP很好...

    Birt基础(report报表简单设计)

    设计时使用BIRT Report Designer,一个基于Eclipse的集成开发环境,用于创建和编辑报表;运行时则是在应用程序中展示报表的部分。 **2. 安装BIRT** 要开始使用BIRT,首先需要下载并安装Eclipse IDE和BIRT插件。通过...

    eclipse birt 报表

    BIRT(Business Intelligence and Reporting Tools)是一款基于Eclipse的开源报表系统,它为开发者提供了一个强大的报告设计和展示平台。BIRT的主要优势在于其易用性、灵活性以及与Eclipse IDE的无缝集成,使得开发...

    eclipse报表插件BIRT中文教程及示例

    **BIRT(Business Intelligence and Reporting Tools)是Eclipse开源项目的一部分,主要用于开发数据报表和商业智能解决方案。在本文中,我们将深入探讨BIRT的基本概念、安装步骤、报表设计过程以及如何利用Eclipse...

    eclipse的报表插件BIRT

    "eclipse报表插件BIRT中文教程及示例html"可能包含以下内容: 1. **安装与配置**:指导如何在Eclipse中安装BIRT插件,设置工作空间和数据源。 2. **报表设计基础**:介绍如何创建新报表,添加数据集,使用控件和样式...

    eclipse集成birt报表时,用到的文件

    在本文中,我们将深入探讨如何在Eclipse集成Business Intelligence and Reporting Tools (BIRT)来创建和管理报表。BIRT是一款开源的报告系统,用于生成基于Web的和离线的报表,它提供了强大的数据可视化和分析功能。...

    eclipse 4.5birt插件

    BIRT (Business Intelligence and Reporting Tools), 是为 Web 应用程序开发的基于 Eclipse 的开源报表系统,特别之处在于它是以 Java 和 JavaEE 为基础。BIRT 有两个主要组件:基于 Eclipse 的报表设计器,以及部署...

    birt4.4.1导出报表中文名称

    &lt;filter-class&gt;org.eclipse.birt.report.servlet.SetCharacterEncodingFilter&lt;/filter-class&gt; &lt;init-param&gt; &lt;param-name&gt;encoding&lt;/param-name&gt; &lt;param-value&gt;UTF-8&lt;/param-value&gt; &lt;/init-param&gt; &lt;/filter&gt; ...

    eclipse3.7 birt 汉化包

    总的来说,Eclipse 3.7 Birt汉化包是中文用户在开发基于BIRT报表的应用程序时的一大助手,它显著提升了用户体验,使得操作更加直观易懂。通过充分利用BIRT的这些功能,开发者可以快速高效地创建出高质量、富有洞察力...

    eclipse整合birt开发web

    BIRT 是一个开源的报表系统,它基于强大的 Eclipse IDE,旨在为Java和J2EE应用程序提供丰富的图形和报表功能。 **步骤一:准备开发环境** 首先,你需要从官方站点http://www.eclipse.org/downloads/下载Eclipse IDE...

    birt报表详细中文文档

    1. **设计环境**:BIRT Report Designer是基于Eclipse IDE的集成开发环境,允许用户通过拖放方式创建复杂的报表布局。它支持多种图表类型、表格、图像、文本和自定义组件。 2. **数据源与查询**:BIRT支持多种数据...

    Eclipse商业智能与报表工具(birt)简介

    1. **BIRT设计师**:这是一个基于Eclipse IDE的报表构建工具,提供了拖放功能,使用户能够快速设计报表。报表以XML格式存储,便于理解和编辑。设计师包括多个视图,如报表编辑器、数据浏览视图等,提供了一站式的...

Global site tag (gtag.js) - Google Analytics