开源报表birt

   　

 

 

                      

开源报表BIRT开发手册

 

 

 

目  录

 

1     Birt介绍...5

1.1      报表介绍... 5

1.2      基本概念... 5

1.3    丰富的报表... 5

1.4    BIRT报表由四部分组成... 6

1.5    报表设计器... 6

2     Birt插件安装...8

2.1      插件版本说明... 8

2.2      插件安装... 9

2.2.1       完全安装...9

2.2.2       更新安装：...9

2.2.3       分步安装...9

3     Birt报表开发实战...13

3.1    创建报表... 13

3.1.1       创建报表工程...13

3.1.2       创建报表...14

3.2    数据源配置... 16

3.3    创建数据集... 19

3.4    网格报表... 20

3.4.1       创建数据源...21

3.4.2       创建数据集...21

3.4.3       对报表进行布局...21

3.4.4       格式化与预览...23

3.5    分组报表... 24

3.5.1       创建数据源...25

3.5.2       构建数据集...25

3.5.3       对报表进行布局...25

3.5.4       设定分组数据...25

3.5.5       格式化报表...27

3.6    交叉报表... 28

3.6.1       构建数据源...28

3.6.2       构建数据集...28

3.6.3       在报表中加入交叉报表...28

3.6.4       数据准备...29

3.6.5       向交叉表插入数据...32

3.6.6       加入汇总...33

3.6.7       格式化报表...34

3.7    嵌套报表... 35

3.7.1       构建数据源...36

3.7.2       构建数据集...36

3.7.3       布局嵌套报表...38

3.7.4       将Table绑定数据集...39

3.7.5       设定主表数据...39

3.7.6       设定子表数据...40

3.8    交互报表... 42

3.8.1       创建报表、数据源...43

3.8.2       创建数据集...43

3.8.3       加入响应参数...45

3.8.4       布局报表...47

3.8.5       插入报表数据...48

3.8.6       格式化与预览...49

3.9    报表钻取... 51

3.9.1       设定响应参数...51

3.9.2       预览结果...54

3.10  图表报表... 55

3.10.1     为报表插入图表...55

3.10.2     设定图表属性...55

3.10.3     图表预览...60

3.11  多层交叉报表... 61

3.11.1     构建数据源...61

3.11.2     构建数据集...61

3.11.3     在报表中加入交叉报表...62

3.11.4     数据准备...63

3.11.5     向交叉表插入数据...63

3.11.6     格式化与预览...64

3.12  多层交叉汇总报表... 65

3.12.1     加入汇总...65

3.12.2     格式化与预览...66

3.13  其他... 67

3.13.1     格式化报表...67

3.13.1.1         表头与标题... 67

3.13.1.2         设定单元格格式... 68

3.13.1.3         样式套用... 68

3.13.1.4         数据元素格式化... 69

3.13.2     分页、页眉与页脚...70

3.13.2.1         设置分页显示... 70

3.13.2.2         设置分页打印... 70

3.13.2.3         设置页眉页脚... 71

3.13.3     隔行高亮度显示...73

3.13.4     对报告进行布局...76

3.13.4.1         添加|删除行或列... 76

3.13.4.2         指定行高或列宽... 76

3.13.4.3         添加图像... 77

3.13.5     数据绑定...79

4     Birt报表script82

4.1    avascript脚本编写... 82

4.1.1       隔行高亮度显示...82

4.1.2       多参数查询...84

4.1.3       脚本创建数据源...85

4.2    java脚本编写... 88

4.2.1       创建java类...88

4.2.2       java类与报表交互...92

4.3    BIRT脚本参考... 98

5     Birt报表部署...99

5.1    直接使用运行birt-runtime-2_2_0包中的WebViewerExample.99

5.2    集成到已有web应用... 100

5.3    数据库驱动位置... 107

5.4    报表url说明... 107

5.5    web.xml配置... 113

5.6    viewer.properties说明... 115

5.7    BIRT在jsp中tag使用... 116

5.8    关于BIRT编码... 123

 

1   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 报表源