下载文档原格式
山东电力集团公司门户项目组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基础（report报表简单设计）先下载eclipse的eclipse-reporting-galileo-SR1-win32.zip（制作报表eclipse插件）1、新建一个java project2、在这个project上新建一个report的文件如图：3、创建数据源：（在此用JDBC的数据源，并命名为student）4、创建数据连接，选择Driver Class用jdbc的Driver输入Driver URL、用户名和密码，如果在选择Driver Class时没有jdbc的Driver那点击Manager Drivers把Jdbc的jar包加载进来5、创建Data sets(可以看成是结果集)在JDBC Data Source处先可用的数据源，也就是刚创建的student数据源；选择Data Set Type 结果集的类型，这里就选择了SQL Select Query；输入Data Set Name（结果集的名称）这里输入为student写sql语句使这个结果集是可用的，下图左面显示的是可用的表，在右面输入框内输入相应的sql语句来对应这个结果集点击Finish完成结果集的创建6、现在就可以把这个结果集中的数据按照我们需要的方式显示出来了，点击eclipse窗口左面的Palette选项选择相应控件，有些控件是可以直接接收数据源的如table、Grid……，现在把一个table拖到右面的.rptdesign文件中，拖过来的时候会弹出来下图的对话框，输入columns(字段数)也就是要显示出来的字段，想显示出多少字段就输入几，选择Data Set （选择结果集）在这里就选择刚刚创建的student结果集7、选择左面的Data Explo选项，把要显示出来的选择拖到右面table中的相应位置，如图：点击下面的preview就可以看到相应的结果了：下面的结果显示出来本来是没有边框也不会居中对齐的，要设置相应的样式之后才会这样的，设置样式和css是一样的，选中这个table右击，选择style中的new style只要在里面设置border和text block就可以了；在本数据库设计中是把sex性别这个值放在数据字典里的，在这里只能显示出1或2，当然要想显示成男或女也是有办法解决的，那就要涉及到子报表功能。
BIRT是一个Eclipse-based开放源代码报表系统。
它主要是用在基于Java与J2EE的Web应用程序上。
BIRT 主要由两部分组成：一个是基于Eclipse的报表设计和一个可以加到你应用服务的运行期组件。
BIRT同时也提供一个图形报表制作引擎。
URL: /birt/这个指南将引导你设计一个简单的报表，令你对BIRT报表系统有个感性的认识，如果想进一步了解BIRT的使用可以参考BIRT在Eclipse中自带的帮助，Select Help→Help Contents from the Eclipse menu and then cli ck on the BIRT Developer Guide.∙操作界面友好大方，小图标都很漂亮：）；∙功能并不逊色与商业报表工具；∙CSS提供了强大灵活的样式定义，对于属性CSS的设计人员来说，应该可以设计出相当出色的报表样式；∙集成在Eclipse中，不用再开启别报表开发工具窗口；∙BIRE的本地化做的很好，安装以后操作界面就是中文的；∙开源的报表产品，降低开发成本，一些报表开发工具除了价格昂贵以外，还有用户限制；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 A ll-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 入门文档目录1 BIRT -前言 (1)2 BIRT -简介 (1)3 BIRT -配置安装 (2)3.1 下载 (2)3.2 安装以及汉化 (2)4 BIRT -简例 (2)4.1 创建一张报表 (3)4.2 创建报表数据源和数据集 (5)4.3 构建Table (9)4.3.1 构建明细表 (9)4.3.2设置边框，样式 (10)4.3.3创建报表参数 (11)4.3.4设定颜色标识 (13)4.3.4过滤器使用 (15)5 BIRT -小结和回顾 (16)1 BIRT -前言本文档在简介BIRT这个开源免费的报表开发工具后将引导你设计出简单的报表，如想进一步了解BIRT的使用可参考BIRT在Eclipse中自带的帮助，Help→Help Contents。
2 BIRT -简介BIRT是一个Eclipse-based开放源代码报表系统。
BIRT是Business Intelligence and Reporting Tool的简写,即商业智能与报表工具。
它主要是用在基于Java与J2EE 的Web应用程序上。
BIRT主要由两部分组成：一个是基于Eclipse的报表设计器，另一个是可以加到你应用服务的运行期组件。
BIRT同时也提供一个图形报表制作引擎。
URL: /birt/ 这个网址可以找到BIRT，可以去看看。
使用BIRT可以开发出多样化的报表应用，包含：列表（最简单的报表就是列出数据）、图标（饼图，折线图，柱状图等）、交叉表（通过二维显示数据）、字符和文档、复合报表（多个报表组成）等。
有人总结了许多它的优点。
看一下：•操作界面友好大方；•功能并不逊色与商业报表工具；•CSS提供了强大灵活的样式定义，对于属性CSS的设计人员来说，应该可以设计出相当出色的报表样式；•集成在Eclipse中，不用再开启别的报表开发工具窗口；•BIRE的本地化做的很好，安装以后，可以汉化；•开源免费的报表产品，降低开发成本，一些报表开发工具除了价格昂贵以外，还有用户限制；3 BIRT -配置安装3.1 下载在BIRT官方网站/birt/ 下载。
Birt基础（report报表简单设计）先下载eclipse的eclipse-reporting-galileo-SR1-win32.zip（制作报表eclipse插件）1、新建一个java project2、在这个project上新建一个report的文件如图：3、创建数据源：（在此用JDBC的数据源，并命名为student）4、创建数据连接，选择Driver Class用jdbc的Driver输入Driver URL、用户名和密码，如果在选择Driver Class时没有jdbc的Driver那点击Manager Drivers把Jdbc的jar包加载进来5、创建Data sets(可以看成是结果集)在JDBC Data Source处先可用的数据源，也就是刚创建的student数据源；选择Data Set Type 结果集的类型，这里就选择了SQL Select Query；输入Data Set Name（结果集的名称）这里输入为student写sql语句使这个结果集是可用的，下图左面显示的是可用的表，在右面输入框内输入相应的sql语句来对应这个结果集点击Finish完成结果集的创建6、现在就可以把这个结果集中的数据按照我们需要的方式显示出来了，点击eclipse窗口左面的Palette选项选择相应控件，有些控件是可以直接接收数据源的如table、Grid……，现在把一个table拖到右面的.rptdesign文件中，拖过来的时候会弹出来下图的对话框，输入columns(字段数)也就是要显示出来的字段，想显示出多少字段就输入几，选择Data Set （选择结果集）在这里就选择刚刚创建的student结果集7、选择左面的Data Explo选项，把要显示出来的选择拖到右面table中的相应位置，如图：点击下面的preview就可以看到相应的结果了：下面的结果显示出来本来是没有边框也不会居中对齐的，要设置相应的样式之后才会这样的，设置样式和css是一样的，选中这个table右击，选择style中的new style只要在里面设置border和text block 就可以了；在本数据库设计中是把sex性别这个值放在数据字典里的，在这里只能显示出1或2，当然要想显示成男或女也是有办法解决的，那就要涉及到子报表功能。
Birt使用技巧eclipseExcel20090512birt分组小计和增加序列号2009-05-12 18:23一、分组小计：Palette下面 Quick Tools里面有个Aggregation把这个拖到表里面这个是计算用的，你可以选择COUNT SUMAggregate On Table 或者GroupGroup里面可以拖出来看到Group名二、如何增加序号1. 点击报表的空白处，然后到script页，选择initialize，输入var num=02. 回到报表设计页，在组上加入一个data，在这个data的expression中，输入：num++; num3. 保存报表即可。
1. 线图图例移动方法线图图例默认的样式是在图的右边,要将其移动到图的下方,使用的操作如下: 在birt视图下,双击图片选择FormatChart ,点击左侧legend, 点击layout按钮,出现参数选择框:Orientation选择Vertical;Position 选择Below ; right.◊stretch 选择Horizontal ; Direction 选择 Left2. 线图取消数字显示的方法点击左侧Series 下的Value (Y) series 取消 show series Labels复选框◊Format chart3. 线图节点,鼠标滑过,显示提示的设置Values文本框中的 value series name◊Format chart 放到value date 上方, 每条线都设置一下.4. 双坐标Y轴时节点,节点形状的改变series◊Format chart 点击markers 按钮◊ value(Y) series ◊5. 百分比显示的数据类型设置birt中如果要显示百分比，则在script dateSource中必须设置相关的列的数据类型为Float ,不能为String ,否则不显示。
birt初级教程之分组报表分组报表在网格报表的基础上，我们可能还需要对数据进行进一步的处理。
比如，将同类数据显示在一个组中，并对这个组进行统计运算。
如下图所示，对数据按省份进行分组，并将同一省份数据放在一个组内进行汇总统计。
下面我们将上例的网格报表进行一下小的改进，建立一个按用户类型进行分组的报表。
创建数据源方法同上例。
构建数据集本例所用的数据集与上例完全相同，输入与上例3.4.2相同的sql语句建立数据集即可。
对报表进行布局1．做好上面的工作之后，先在布局编辑器中建立一个1列2行的Grid，2．同上例一样，从选用板“Palette”中拖拽一个5列1行的Table至第二行的网格中，3．从Data Explorer视图中的“Data Sets”项中将TYPENAME拖拽至此Table 的第一个详细信息行中，然后依次将，CUSTOMER_ID，CUSTOMER_NAME，FAX，TEL拖拽入详细信息行内。
这里不再赘述。
设定分组数据1．选中Table，在右下方的Table的属性编辑器“Property Editor-Table”中，选择Group，进入如下分组设定界面：2．点击“Add”按钮进行添加分组：从“Group on”的下拉框选择TYPENAME，其他默认，（可根据需要对“Name”项进行命名），然后选择“OK”。
完成分组设定。
3．这时Table中多出一行Group行，如下图：将详细信息栏中的TYPENAME（即Table中第三行第一列数据项，如上图标记下方的数据项）删除。
这样，一个按照用户类型建立的分组报表就建立起来了。
格式化报表进行报表格式化处理后，预览如下效果：同为比较常用的报表工具，FineReport对分组报表的解决方案和实现方法与BIRT有所不同，具体实现思路和步骤如下，供BIRT使用者借鉴：1.描述分组报表就是将报表中的数据按组显示，即将数据列中相同项合并为一组显示，如下图最简单的分组报表：2.制作步骤2.1新建报表，添加数据集新建工作簿，添加数据集，SQL语句为：SELECT*FROM[销量]。
Birt使用说明目录1.下载相关的软件2.如何创建新的报表及报表模板●创建报表●发布模板3.设置报表的属性A、设置报表的样式表●设置数据信息●设置数据源。
●设置数据集●设置输出的列●设置计算列●设置数据集的参数B、设置报表的布局●几种控件的介绍C、设置报表的样式表●倒入样式表单●设置的控件样式4.报表的相关处理A、报表参数●新加参数●参数邦定B、数据排序分组过滤高亮显示●排序●分组●过滤●格式化指定的列显示C、预览打印报表●在开发环境下点击preview即可。
●在tomcat的环境下●集成的自己的运用程序中5. 相关的网站及帮助的使用一、下载相关的软件下载地址：选择下面的连接开发环境/birt/downloads/build.php?build=R-R1-2_1_0-200606281351 Availability Platform DownloadWindows birt-report-designer-all-in-one-2_1_0.zip(md5)下面的连接运行环境Availability Platform DownloadAll birt-runtime-2_1_0.zip(md5)一、在项目中如下图新建一个报表创建报表在下面图中输入报表名称，点击下一步选择报表的类型，最后创建一个新报表。
这里面有不birt系统自带的几种类型也有自己做的模板其中testTemplate是我做的一个简单模板，这里选择特testTemplate模板，将带一些基本的属性给新的报表如下图：包括数据源,数据集,页面的样式css,分页机制等.如果选择其他的样式类型这些属性将需要自己设置。
发布模板将做好的报表可以以模板的形式发布在以后的开发中使用建好的模板。
在outline页面右击做好的报表选择publish to template 如下图进入模板发布页面进行发布二、设置报表的属性。
创建一个空白报表1、设置数据信息●设置数据源。
最近项目用上了birt，一款开源的报表制作工具，当然开源的东西总是免不了简单方便等溢美之词。
我只用到了birt的脚本化数据源和脚本化数据集，所以这里也只说下这两者的简单使用。
1.报表的集成就不说了，网上一搜一大把，我用的是3.7.2版本的birt。
2.新建一个报表项目：首先新建一个普通的java工程test，在该工程下建立一个存放报表文件的文件夹birt，如下图所示：添加所依赖的jar包：3.环境搭建好了之后，下面创建一张效果如下所示的报表：其中行和列都是可以动态变化的。
4.新建报表：右击新建报表，我的是中文版的，报表后缀名为rptdesign：5.新建数据源：双击新建的报表，进入报表设计视图，在左上角?数据源节点右击新建数据源：选择脚本化数据源，填写名称即可。
6.新建数据集，在数据集节点右击新建数据集：选择第6步建立的数据源，填写数据集名称即可。
7.将数据集拖到可视化布局面板中，修改表头名称：此时系统生成了一个一行（ps：这里的行不包括页眉和页脚）一列的表格，双击name列，可以看到基本的一个列绑定：其中dataSetRow[“name”]表明了这个name的值来自数据集。
8.创建报表资源，方便起见，直接写死：9.报表事件处理程序的添加：为了支持报表的动态渲染，我选择了实现IReportEventHandler:然后在属性编辑器选择报表：为它添加刚才编写的事件处理程序：点击浏览有类选择：10.表格动态添加列：这里的列就是Resources.properties的数目加上名字这一列。
1).获取表格：我选择了根据表格名来获取：在属性编辑器-表中的常规里可以看到名称，如果没有，自己指定一个。
获取表格代码：2).表格插入行：调用th.insertColumn(int columnNumber,int optionFlag)即可插入行，optionFlag应该控制的是左右方向。
3).设置表头文本：下面红色的就是表头文件(来自于报表文件xml源)，其实，如果不去看它的xml而直接调用java代码的话会无从下手，而看了xml文件后就非常清晰了，下面是设置表头文本的实现：4).动态添加数据集。
