BIRT插件的使用

birt初级教程http://www.doc88.com/p-210659649320.html

 

BIRT是一个优秀的报表插件，本文将涉及它的安装到简单使用的整个过程。

一，安装

1：到http://download.eclipse.org/birt/downloads下载相应版本（我的Eclipse是3.2，所以BIRT的版本是2.1M5）的Framework和runtime两个包。把Framework包解压，然后和其它plugin一样放到Eclipse的plugins和features目录下；把runtime解压到任意目录下，如C:"birtruntime。这里说明一点：BIRT的runtime在有些时候并不需要，比如但plugin导出为rcp发布后，在其它的机器上就不需要安装runtime来运行报表了。

2：BIRT要依赖GEF和EMF，所以你的Eclipse平台要正确安装GEF和EMF。

3：如果想用pdf格式显示报表结果，我们还要做以下两件事情：到http://prdownloads.sourceforge.net/itext/itext-1.3.jar下载itext，然后拷贝到plugins/org.eclipse.birt.report.engine.emitter.pdf_version/lib目录下；到http://dev.conio.net/repos/prototype/dist/prototype.js下载prototype.js，然后拷贝到/org.eclipse.birt.report.viewer_version/birt/ajax/lib目录下。

二，创建报表

0：配置BIRT环境，因为例子将要使用jdbc做为数据源，birt本身并布提供这样数据库的驱动，所以要把所使用的数据库驱动文件放到相应的目录。

下载derby.jar，derbyclient.jar，derbynet.jar，derbytools.jar四个jar，然后把他们拷贝到以下两个目录：

"plugins"org.eclipse.birt.report.data.oda.jdbc_2.1.0.M20060303-0920"drivers

"birt-runtime-2_1_0"ReportEngine"plugins"org.eclipse.birt.report.data.oda.jdbc"drivers

      1 ：创建一个报表工程
 

2：创建一个report文件，最后一步选空模板。

       3 ：创建数据源。 BIRT 支持多种数据源，这里选择比较复杂的 JDBC 数据库数据源，数据库使用 Derby 做为例子。假定你的 derby 数据库已经配置正确并已运行，然后在 Data Explore navigator 视图下创建新的数据源，配置如下图，如果数据库访问有用户名和密码也正确填写：

        4：创建数据集。选择创建数据集后会有一个如下的窗口弹出，第一个是数据集的属性操作切换页，第二个窗口列出所有的数据表，第三个是编辑框，可以在里面手写或者在第二个框里拖动我们需要的数据库的某一列。

5：设计报表。这一步开始按照自己的需求来设计报表，birt提供了丰富的报表格式，如：柱状图、饼状图、chart、表等，这里我们用表做为例子，假设数据库有一个consignee的表，表有ID，name和location三列，我们设计一个报表，用户可以在报表上选择一个location，然后报表给出在这个location的所有用户。

       5 ． 1 ：按照需求，用户可以在报表上选择一个地点来统计结果，所以这里用到 BIRT 的 parameter （参数）的技术，双击 Data set 数据源，选择 parameters ，创建一个新的参数，如图：

然后切换到Query界面，添加一句sql语句where location = ?，如下：

5.2创建一个叫做Parameter的新数据集，此数据集只提供动态参数的数据来源（这个作用稍后会更清晰的看见）

SQL语句为：

select  DISTINCT  APP.CONSIGNEE.LOCATION

from  APP.CONSIGNEE

      5 ． 3 创建一个新的 Report Parameter （报表参数）。

5．4设计报表的表格。

       5 ． 4 ． 1 拖动一个默认属性的 table 到界面上，然后点右键，选择“ Edit Data Binding ”，如下图设置：

        5．4．2把Data Set数据集里的三列分别拖到table的第一到第三列，效果如图：

        5．5预览。到这里，简单的应用都有了，点击一下preview看一下效果，首先点击“show Report Parameter”，出现这个：


这个combobox里面的内容就来自数据集Parameter，是动态的。选择一个参数运行就能看见结果了。


三，使用设计好的报表

如果想在另外一个项目中使用设计好的报表文件，有两种方式，一个是用web的方式查看结果，另一个是用pdf的方式，这里介绍web方式，例子是一个单独运行起来的birt报表。

在想显示报表的地方使用如下语句：

DtpManifestExplorer.getInstance().getExtensionManifests();
String path  =  filePath  +  " filename.rptdesign " ;
WebViewer.display(path, WebViewer.HTML,  true );

注意最后一句的最后一个参数，如果想在报表中使用参数就为 true 否则为 false 。

四，总结birt的功能很强大，还有柱状图等很图形可供使用，原理都很相似，可以在使用种慢慢摸索。