BIRT报表开发手册详解.doc

　 开源报表BIRT开发手册北京宇信易诚科技有限公司2007-08-23宇信易诚版权所有 　 Birt报表开发手册目 录1 Birt介绍 51.1 报表介绍 51.2 基本概念 51.3 丰富的报表 51.4 BIRT报表由四部分组成 61.5 报表设计器 62 Birt插件安装 82.1 插件版本说明 82.2 插件安装 92.2.1 完全安装 92.2.2 更新安装： 92.2.3 分步安装 93 Birt报表开发实战 133.1 创建报表 133.1.1 创建报表工程 133.1.2 创建报表 143.2 数据源配置 163.3 创建数据集 193.4 网格报表 203.4.1 创建数据源 213.4.2 创建数据集 213.4.3 对报表进行布局 213.4.4 格式化与预览 233.5 分组报表 243.5.1 创建数据源 253.5.2 构建数据集 253.5.3 对报表进行布局 253.5.4 设定分组数据 253.5.5 格式化报表 273.6 交叉报表 283.6.1 构建数据源 283.6.2 构建数据集 283.6.3 在报表中加入交叉报表 283.6.4 数据准备 293.6.5 向交叉表插入数据 323.6.6 加入汇总 333.6.7 格式化报表 343.7 嵌套报表 353.7.1 构建数据源 363.7.2 构建数据集 363.7.3 布局嵌套报表 383.7.4 将Table绑定数据集 393.7.5 设定主表数据 393.7.6 设定子表数据 403.8 交互报表 423.8.1 创建报表、数据源 433.8.2 创建数据集 433.8.3 加入响应参数 453.8.4 布局报表 473.8.5 插入报表数据 483.8.6 格式化与预览 493.9 报表钻取 513.9.1 设定响应参数 513.9.2 预览结果 543.10 图表报表 553.10.1 为报表插入图表 553.10.2 设定图表属性 553.10.3 图表预览 603.11 多层交叉报表 613.11.1 构建数据源 613.11.2 构建数据集 613.11.3 在报表中加入交叉报表 623.11.4 数据准备 633.11.5 向交叉表插入数据 633.11.6 格式化与预览 643.12 多层交叉汇总报表 653.12.1 加入汇总 653.12.2 格式化与预览 663.13 其他 673.13.1 格式化报表 673.13.1.1 表头与标题 673.13.1.2 设定单元格格式 683.13.1.3 样式套用 683.13.1.4 数据元素格式化 693.13.2 分页、页眉与页脚 703.13.2.1 设置分页显示 703.13.2.2 设置分页打印 703.13.2.3 设置页眉页脚 713.13.3 隔行高亮度显示 733.13.4 对报告进行布局 763.13.4.1 添加|删除行或列 763.13.4.2 指定行高或列宽 763.13.4.3 添加图像 773.13.5 数据绑定 794 Birt报表script 824.1 avascript脚本编写 824.1.1 隔行高亮度显示 824.1.2 多参数查询 844.1.3 脚本创建数据源 854.2 java脚本编写 884.2.1 创建java类 884.2.2 java类与报表交互 924.3 BIRT脚本参考 985 Birt报表部署 995.1 直接使用运行birt-runtime-2_2_0包中的WebViewerExample 995.2 集成到已有web应用 1005.3 数据库驱动位置 1075.4 报表url说明 1075.5 web.xml配置 1135.6 viewer.properties说明 1155.7 BIRT在jsp中tag使用 1165.8 关于BIRT编码 1231 Birt介绍1.1 报表介绍BIRT――商业智能和报表工具。

BIRT是一个Eclipse-based开放源代码的报表系统，它主要是用在基于Java和J2ee的web应用程序上BIRT主要由两部分组成：一个是基于Eclipse的报表设计器和一个可以添加到应用服务器的运行组建BIRT同时提供一个图形报表制作引擎BIRT拥有和Dreamweaver一般的操作界面，可以像画table一样画报表，也可以生成图片、导出Excel、html、pdf、ppt等分页，样式比script设置简单，另外BIRT还有OLAP导航功能1.2 基本概念l 数据源：数据的来源，或提供者如xml数据源、jdbc数据源等 l 数据集：数据集合，它必须与数据源关联，可以理解为查询的结果 l 报表以及报表项，报表可视为是针对一组数据集的表现形式，而报表项这是这个表现形式的某个具体的单元它们之间的关系，与窗体和控件的关系非常类似报表、数据集、数据源三者间的关系：数据源 --- 数据集 --- 报表 l 报表参数：查询参数的表现形式，使用它可以构建更灵活的报表 l 模板和库：主要用于复用报表设计，提高报表开发的效率1.3 丰富的报表列表 － 列表是最简单的报表当列表变长时，你可以把相关数据增加到同一分组（基于客户的订单分组，基于供应商的产品分组）。

如果数据是数字类型的，你可以轻松的添加到“总数”、“平均”、或其他汇总中图表 － 当需要图表表现时，数字型数据比较好理解BIRT 也提供饼状、线状以及柱状图标等交叉表 － 交叉表（也叫做十字表格或矩阵）用两种维度展示数据：sales per quarter or hits per web page交叉表在 1.0.1 中没有提供，但计划在将来提供信函和文档 － 通知、信件、以及其他文本文档都很容易通过 BIRT 方便建立文档包括正文、格式、列表、图表等混合报表 － 很多报表需要联合以上所有的报表构成单一文档例如，一份客户声明会列出客户所需要的信息，为当前促进(promotions)提供文本，以及提供并行的出帐和入帐列表一份财政报表将包括声明、图表、表格，所有这些都将进行全方位的格式化，来匹配共有的配色方案1.4 报表由四部分组成数据 － 数据库、Web 服务、Java 对象，这些都可以作为 BIRT 报表源1.0.1 版本提供 JDBC 支持，也支持利用编码来获取其他地方的数据BIRT 的 ODA(Open Data Access) 框架允许任何人构建新的 UI 以及运行时支持任何类型的表格式数据。

未来，单一报表可包含从任意多个数据源获取数据数据转换 － 报表通过对数据的分类、统计、过滤以及分组来适应用户需求当然，数据库能实现这些功能，当遇到普通文件和 Java 对象时 BIRT 必须以 "simple" 数据源方式处理BIRT 允许复杂的操作，比如总合分组、整体共计的百分比，等等业务逻辑 － 真实世界的数据很少提供你理想的结构良好的报表许多报表要求用具体逻辑把原始数据转换成用户的有用信息如果该逻辑仅仅用于该报表，你可以用 BIRT 的 JavaScript 脚本支持如果你的程序中已包含这些逻辑，你可以调用已有的 Java 代码表现 － 一旦数据准备好了，你可以在很大的范围内选择表现形式表格、图表、文字等等都可以单一数据集可以有多种方式表现，而单一报表可以表现多个数据集1.5 报表设计器数据浏览器 － 把你的数据源（连接）以及数据集（查询）组织起来数据集编辑器允许你测试数据集，以确保报表接收数据的正确性布局视图（Layout） － 所见即所得编辑器为你的报表提供以拽方式来创建表现内容包含一个标准报表条目调色板属性编辑器（Property Editor） － 以便利的格局表现大多数通用的用户属性使编辑更快速和容易。

BIRT 也集成了标准 Eclipse 属性视图，为每个条目提供详细的属性列表报表预览（Preview） － 你可以在任何时间采用真实数据测试你的报表预览窗口直接内嵌在 Eclipse 中代码编辑器(Script) － 在访问数据以及报表生成或浏览时，脚本把业务逻辑添加给报表在编辑脚本时代码编辑器提供标准的 Eclipse 特性：语法加色、自动完成等等BIRT 用很简单的脚本来表达，expression builder 能更容易的创建这些表达略图（OutLine） － BIRT 报表被组织为一个树型结构作为整体报表的根，并且为样式、报表内容、数据源、数据集、报表参数等分类略图视图提供你整个报表结构紧凑的预览Cheat Sheets － 学习新工具永远是种挑战，但是 Eclipse 提供一种创新方案：cheat sheets它们是一些帮助你完成新任务的文档2 Birt插件安装2.1 插件版本说明EMF, GEF 和 BIRT 都是需要通过 Eclipse download page下载的请注意以下的配置要求：Ø BIRT 2.1.3 Ø Eclipse 3.2. Ø GEF 3.2. Ø EMF 2.2. Ø JRE 1.4.2/JRE 1.5.Ø BIRT 2.2 Ø Eclipse 3.3. Ø GEF 3.3. Ø EMF 2.3. Ø JRE 1.5. Ø DTP 1.5. Ø WTP 2.0GEF：Graphical Editing Framework，图形编辑框架，是一个通过 BIRT UI 使用的Eclipse 插件。

EMF：Eclipse Modeling Framework，用来制作图表的框架DTP: DataTools Platform，管理数据源驱动程序，以及访问特殊数据源实例的配置WTP: Web Tools Platform，另外，本手册中介绍实例使用的derby数据库2.2 插件安装2.2.1 完全安装到Eclipse的官方网站http://download.eclipse.org/birt/downloads去下载 带有BIRT 插件的Eclipse平台（birt-report-designer-all-in-one-2_2_0），解压后，它就是一个拥有 BIRT插件的Eclipse，您可以直接使用下载所在网页：http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/R-R1-2_2_0-200706261010/birt-report-designer-all-in-one-2_2_0.zip   Download from: Eclipse downloads - mirror selection2.2.2 更新安装：BIRT 2.1开始，可以在 Eclipse 里直接下载。