BIRT开发手册1.docx
- 文档编号:17026571
- 上传时间:2023-07-21
- 格式:DOCX
- 页数:81
- 大小:2.53MB
BIRT开发手册1.docx
《BIRT开发手册1.docx》由会员分享,可在线阅读,更多相关《BIRT开发手册1.docx(81页珍藏版)》请在冰点文库上搜索。
BIRT开发手册1
目录
1Birt介绍5
1.1报表介绍5
1.2基本概念5
1.3丰富的报表5
1.4BIRT报表由四部分组成6
1.5报表设计器6
2Birt插件安装8
2.1插件版本说明8
2.2插件安装9
2.2.1完全安装9
2.2.2更新安装:
9
2.2.3分步安装9
3Birt报表开发实战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
4Birt报表script82
4.1avascript脚本编写82
4.1.1隔行高亮度显示82
4.1.2多参数查询84
4.1.3脚本创建数据源85
4.2java脚本编写88
4.2.1创建java类88
4.2.2java类与报表交互92
4.3BIRT脚本参考98
5Birt报表部署99
5.1直接使用运行birt-runtime-2_2_0包中的WebViewerExample99
5.2集成到已有web应用100
5.3数据库驱动位置107
5.4报表url说明107
5.5web.xml配置113
5.6viewer.properties说明115
5.7BIRT在jsp中tag使用116
5.8关于BIRT编码123
1Birt介绍
1.1报表介绍
BIRT――商业智能和报表工具。
BIRT是一个Eclipse-based开放源代码的报表系统,它主要是用在基于Java和J2ee的web应用程序上。
BIRT主要由两部分组成:
一个是基于Eclipse的报表设计器和一个可以添加到应用服务器的运行组建。
BIRT同时提供一个图形报表制作引擎。
BIRT可以像画table一样画报表,也可以生成图片、导出Excel、html、pdf、ppt等分页,样式比script设置简单,另外BIRT还有OLAP导航功能。
1.2基本概念
●数据源:
数据的来源,或提供者。
如xml数据源、jdbc数据源等。
●数据集:
数据集合,它必须与数据源关联,可以理解为查询的结果。
●报表以及报表项,报表可视为是针对一组数据集的表现形式,而报表项这是这个表现形式的某个具体的单元。
它们之间的关系,与窗体和控件的关系非常类似。
报表、数据集、数据源三者间的关系:
数据源---数据集---报表。
●报表参数:
查询参数的表现形式,使用它可以构建更灵活的报表。
●模板和库:
主要用于复用报表设计,提高报表开发的效率
1.3丰富的报表
列表-列表是最简单的报表。
当列表变长时,你可以把相关数据增加到同一分组(基于客户的订单分组,基于供应商的产品分组)。
如果数据是数字类型的,你可以轻松的添加到“总数”、“平均”、或其他汇总中。
图表-当需要图表表现时,数字型数据比较好理解。
BIRT也提供饼状、线状以及柱状图标等。
交叉表-交叉表(也叫做十字表格或矩阵)用两种维度展示数据:
salesperquarterorhitsperwebpage。
(交叉表在1.0.1中没有提供,但计划在将来提供。
)
信函和文档-通知、信件、以及其他文本文档都很容易通过BIRT方便建立。
文档包括正文、格式、列表、图表等。
混合报表-很多报表需要联合以上所有的报表构成单一文档。
例如,一份客户声明会列出客户所需要的信息,为当前促进(promotions)提供文本,以及提供并行的出帐和入帐列表。
一份财政报表将包括声明、图表、表格,所有这些都将进行全方位的格式化,来匹配共有的配色方案。
1.4报表由四部分组成
数据-数据库、Web服务、Java对象,这些都可以作为BIRT报表源。
1.0.1版本提供JDBC支持,也支持利用编码来获取其他地方的数据。
BIRT的ODA(OpenDataAccess)框架允许任何人构建新的UI以及运行时支持任何类型的表格式数据。
未来,单一报表可包含从任意多个数据源获取数据。
数据转换-报表通过对数据的分类、统计、过滤以及分组来适应用户需求。
当然,数据库能实现这些功能,当遇到普通文件和Java对象时BIRT必须以"simple"数据源方式处理。
BIRT允许复杂的操作,比如总合分组、整体共计的百分比,等等。
业务逻辑-真实世界的数据很少提供你理想的结构良好的报表。
许多报表要求用具体逻辑把原始数据转换成用户的有用信息。
如果该逻辑仅仅用于该报表,你可以用BIRT的JavaScript脚本支持。
如果你的程序中已包含这些逻辑,你可以调用已有的Java代码。
表现-一旦数据准备好了,你可以在很大的范围内选择表现形式。
表格、图表、文字等等都可以。
单一数据集可以有多种方式表现,而单一报表可以表现多个数据集。
1.5报表设计器
数据浏览器-把你的数据源(连接)以及数据集(查询)组织起来。
数据集编辑器允许你测试数据集,以确保报表接收数据的正确性。
布局视图(Layout)-所见即所得编辑器为你的报表提供以拽方式来创建表现内容。
包含一个标准报表条目调色板。
属性编辑器(PropertyEditor)-以便利的格局表现大多数通用的用户属性使编辑更快速和容易。
BIRT也集成了标准Eclipse属性视图,为每个条目提供详细的属性列表。
报表预览(Preview)-你可以在任何时间采用真实数据测试你的报表。
预览窗口直接内嵌在Eclipse中。
代码编辑器(Script)-在访问数据以及报表生成或浏览时,脚本把业务逻辑添加给报表。
在编辑脚本时代码编辑器提供标准的Eclipse特性:
语法加色、自动完成等等。
BIRT用很简单的脚本来表达,expressionbuilder能更容易的创建这些表达。
略图(OutLine)-BIRT报表被组织为一个树型结构作为整体报表的根,并且为样式、报表内容、数据源、数据集、报表参数等分类。
略图视图提供你整个报表结构紧凑的预览。
CheatSheets-学习新工具永远是种挑战,但是Eclipse提供一种创新方案:
cheatsheets。
它们是一些帮助你完成新任务的文档。
2Birt插件安装
2.1插件版本说明
EMF,GEF和BIRT都是需要通过Eclipsedownloadpage下载的。
请注意以下的配置要求:
ØBIRT2.1.3
ØEclipse3.2.
ØGEF3.2.
ØEMF2.2.
ØJRE1.4.2/JRE1.5.
ØBIRT2.2
ØEclipse3.3.
ØGEF3.3.
ØEMF2.3.
ØJRE1.5.
ØDTP1.5.
ØWTP2.0
GEF:
GraphicalEditingFramework,图形编辑框架,是一个通过BIRTUI使用的Eclipse插件。
EMF:
EclipseModelingFramework,用来制作图表的框架。
DTP:
DataToolsPlatform,管理数据源驱动程序,以及访问特殊数据源实例的配置。
WTP:
WebToolsPlatform,
另外,本手册中介绍实例使用的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
Downloadfrom:
Eclipsedownloads-mirrorselection
2.2.2更新安装:
BIRT2.1开始,可以在Eclipse里直接下载。
在Eclipse里按照:
[Help]—>[SoftwareUpdates]—>[FindAndInstall]的路径来进行即可。
2.2.3分步安装
首先下载安装JRE1.5;
1、下载安装Eclipse3.3
下载地址:
http:
//download.eclipse.org/eclipse/downloads/drops/R-3.3-200706251500/winPlatform.php#EclipseSDK
打开网页:
http:
//download.eclipse.org/eclipse/downloads/drops/R-3.3-200706251500/index.php
点击下图中的“EclipseSDK”链接即可下载。
下载到文件eclipse-SDK-3.3-win32.zip,解压至安装目录,比如我们把它安装到C:
\ProgramFiles中;
2、下载安装插件WTP2.0,
下载地址:
http:
//www.eclipse.org/downloads/download.php?
file=/webtools/downloads/drops/R2.0/R-2.0-200706260303/wtp-R-2.0-200706260303.zip&url=
打开下面的网页点击网页中DownloadFrom后的链接即可进行下载。
http:
//www.eclipse.org/downloads/download.php?
file=/webtools/downloads/drops/R2.0/R-2.0-200706260303/wtp-R-2.0-200706260303.zip
下载到文件wtp-R-2.0.zip,将其解压至eclipse安装目录C:
\ProgramFiles即可;
方法如下:
右键点击压缩文件,选择解压文件,
弹出解压路径和选项:
将目标路径改为我们安装eclipse的安装目录:
C:
\ProgramFiles
点击确定。
在解压时,如果出现“文件已存在”,选择“全部选是”进行覆盖就可以了。
3、下载安装GEF3.3Release,GEFRuntime,
下载地址:
http:
//www.eclipse.org/downloads/download.php?
file=/tools/gef/downloads/drops/R-3.3-200706281000/GEF-runtime-3.3.zip
打开网页:
http:
//download.eclipse.org/tools/gef/downloads/drops/R-3.3-200706281000/index.php
点击:
Runtime中Download下方的链接即可。
下载到文件GEF-runtime-3.3.zip,解压至安装目录,方法同上。
4、下载安装EMF&SDORTversion2.3,
下载地址:
http:
//www.eclipse.org/downloads/download.php?
file=/modeling/emf/emf/downloads/drops/2.3.1/M200708142030/emf-sdo-SDK-M200708142030.zip&url=
打开下面的网页点击网页中DownloadFrom后的链接即可进行下载。
http:
//www.eclipse.org/downloads/download.php?
file=/modeling/emf/emf/downloads/drops/2.3.1/M200708142030/emf-sdo-SDK-M200708142030.zip
下载到文件emf-sdo-SDK.zip,解压至安装目录,方法同上。
5、下载安装DTPversion1.5,
下载地址:
http:
//www.eclipse.org/downloads/download.php?
file=/datatools/downloads/1.5/dtp-sdk_1.5_20070704.zip&url=
打开下面的网页点击网页中DownloadFrom后的链接即可进行下载。
http:
//www.eclipse.org/downloads/download.php?
file=/datatools/downloads/1.5/dtp-sdk_1.5_20070704.zip
下载到文件dtp-sdk_1.5.1.zip,解压至安装目录,方法同上。
6、下载安装BIRTRelease2.2,
下载地址:
http:
//www.eclipse.org/downloads/download.php?
file=/birt/downloads/drops/R-R1-2_2_0-200706261010/birt-report-framework-2_2_0.zip&url=
打开下面的网页点击网页中DownloadFrom后的链接即可进行下载。
http:
//www.eclipse.org/downloads/download.php?
file=/birt/downloads/drops/R-R1-2_2_0-200706261010/birt-report-framework-2_2_0.zip
下载到文件birt-report-framework-2_2_0.zip,解压至安装目录,方法同上。
安装完毕,即可进入使用。
如果您只是缺少其中的某几个插件,下载后按照上述方法安装即可,但要注意版本的匹配。
3Birt报表开发实战
3.1创建报表
3.1.1创建报表工程
1.选择文件->新建->项目。
如下图中的新建项目将显示可以创建的项目的类型。
2.展开商业智能和报表工具(BusinessIntelligenceandReportingTools),选择报表项目(ReportProject),然后选择下一步。
3.在新建报表项目的工程名称中输入下列文本,如图所示:
MyReport
4.要添加项目,请选择完成。
现在可在导航器视图中看到该项目,如图所示。
3.1.2创建报表
1.选择文件->新建->报表。
如下图:
2.选择MyReport,输入报表文件名称,如:
Customers.rptdesign
3.选择Next。
4.可以通过一下方式创建报表:
●从空白报表开始设计
●使用预定义的报表模版
5.选择Finish。
新报表将出现在主窗口中,布局编辑器将显示空的报表页。
如下图所示:
3.2数据源配置
在布局编辑器中开始设计报表之前,构建BIRT数据源以将报表连接至数据库或其他类型的数据源。
构建数据源时,要指定驱动程序类、数据源名称和其他连接信息(例如,用户名和密码)。
Birt自带一个已经配置为与BIRT报表设计器配合使用的样本数据库ClassicModels,对于本教程使用的是Derby数据库。
1.选择数据资源管理器(DataExplorer)。
如果使用缺省报表设计透视图,则数据资源管理器位于布局编辑器的左边,在选用板(Palette)的旁边,如图所示。
如果它尚未打开,则选择窗口->显示视图->数据资源管理器。
2.右键单击DataSources然后从上下文菜单中选择新建数据源。
新建数据源显示可以创建的数据源的类型,如图所示。
●ClassicModelsInc.SampleDataBase———上面说过是BIRT样本数据库。
●FlatFileDataSource———从CSV、SSV、TSV、PSV四种格式的文件获取数据源。
●JDBCDataSource———通过配置jdbc连接数据库。
●ScriptDataSource———通过编写脚本获取数据源。
●WebServicesDataSource———通过webservice方式获取数据源。
●XMLDataSource———从xml文件获取数据源。
3.这里我们介绍通过JDBCDataSource配置数据源。
选择JDBCDataSource,输入数据源名称,点击Next,配置Jdbc信息。
如下图:
●首先,单击ManageDrivers添加驱动包。
如下图:
单击add,选择derby数据库的derbyclient.jar驱动包。
点击ok,驱动完成添加。
●配置信息:
DriverClass:
org.apache.derby.jdbc.ClientDriver(v10.1)(通过下拉菜单可以找到)
DatabaseURL:
jdbc:
derby:
//【host】:
1527/【database】
UserName:
用户名
Password:
密码
4.测试连接,测试前查看derby数据库是否启动;点击TestConnection。
出现Connectionsuccessful.对话框表示数据源创建成功。
点击Finish完成。
3.3创建数据集
数据集标识要从数据源检索的数据。
我们是通过连接至JDBC数据源,则使用SQLSELECT语句来标识要检索的数据。
1.在数据资源管理器(DataExplorer)中,右键单击数据集(DataSet)并从上下文菜单中选择新建数据集。
2.在新建数据集的数据集名称中,输入下列文本,如图所示:
3.对于其他字段选择缺省值。
DataSetTypes数据集类型一般使用jdabc数据源连接分为两种:
一种是SQLSelectQuery为select查询,一种是SQLStoredProcedureQuery存储过程查询(使用存储过程查询,必须数据库中已创建存储过程)。
DataSource显示先前创建的数据源的名称。
DataSetTypes指示该数据集使用SQLSelectQuery查询。
4.选择Next。
查询显示可帮助您创建SQL查询的信息。
可用项列示数据库中的所有表。
可以单击表旁边的加号(+)标志来显示该表的各个列。
编辑数据集右边的文本区域显示SQLSELECT语句的必需关键字:
5.在文本区域中,输入下列SQLSELECT语句以指定要检索的数据:
如:
select*fromEBANK.CUSTOMER
虽然数据集编辑器以大写字母显示表和列名称,但可用您喜欢的方式输入这些名称,因为SQL不区分大小写。
如果您不想输入查询,则可将列和表从可用项拖动到文本区域。
6.选择Finish以保存数据集。
编辑数据集将显示在查询中指定的列,并提供编辑数据集的选项。
7.选择预览结果(PreviewResults)以确保查询有效并且它返回正确的数据。
如果正确输入了SELECT语句,您应该看到图中显示的结果。
这些是查询返回的数据行。
8.选择ok,数据集创建成功。
3.4网格报表
网格报表是报表最通用的模式,在大多数报表中,都需要或部分需要将一组(多条)数据结构完全相同的数据以表格形式顺
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- BIRT 开发 手册