BIRT初窥(2)
运行第一个 HelloWord 报表
创建一个具有报表功能的 web 工程
新建 Report web Project
首先创建一个 report Web 工程,当然也可以单单创建 Report 。
确定日志输出等级,以及显示工作目录、源码目录、报表视图目录、报表引擎。
完成之后,将生成一个 web 工程,并且导入报表支持。
在原有项目添加 Report 支持
安装 Myeclipse 的朋友可以采用如下方式,效果是相同的。
如果想在原有的 web 工程加入 Report 支持,选中 MyEclipse ->Project Capabilities->Add Report Capabilities... 添加报表功能的支持。
同样选择报表日志输出等级。
支持添加完成之后,工程目录发生变化。
1.report-viewer 报表数据视图的 HTML 展现包。
2..rptdesign 就是报表的源文件,存储着报表的设计。
3. 加入了 birt 的支持包, web.xml 也相应的添加了 Serverlet 、 Tag 的声明等。
4. 在 WEB-INF 中页添加了 BIRT Axis 的 WebService 支持。
创建一个报表
选择 New->Report
选择模板
输出的一些配置
这里 Gernerate 是报表的生成方式
1. Html 连接形式引用报表的 JSP 模板。
2. 用 Report View 的 JSP Tag 引用报表的 JSP 模板。
3. 用 Iframe 引用报表的 JSP 模板。
Display format 这里是选择 HTML
checkBox 选项 Use advance report viewer 是选择是否用集成好的高级报表显示工具栏。
接下来打开工作模式视图
window –> Open perspective -> Other ->Report Design/Myeclipse Report Design
在 Report Design 模式中选择 Data Explorer
1. 创建数据源
图 2.1
可通过 JDBC 配置实现连接 , 也可通过 Myeclipse 自带的 Database Explorer 工具导入。
其中 Scripted Data Source 项可通过脚本实现通过 Session 等介质得到数据详见 Struts+spring+hibernate+birt整合实例 ,注意数据的 open,fetch 和 close 函数。
Open 函数主要赋值参数
//open 方法
// 定义数据集
// 以及
XXX = ...;
totalrows = ...;
currentrow = ...;
// 当 fetch 方法返回 false
// 数据集获取完毕
if (currentrow >= totalrows){
return ( false );
}
...
// 定义
row[ "XXXX" ] = ...;
...
currentrow = currentrow + 1;
return ( true );
//close 方法
// 清空定义
XXX = null ;
添加数据集
Data Source Selection: 选择添加完成的数据源
Data Set Type: 数据集类型
1. SQL Select query 通过查询语句查询
2. SQL stored procedure query 通过存储过程查询
Data Set Name: 数据集名称
Data Source: 数据源
Query: 查询语句
Output Columns: 输出列
Computed Columns: 计算列
Parmeters: 传入参数
Filters: 数据过滤条件
Property Binding: 属性绑定
Settings: 设置
Preview Results: 结果预览
编辑报表
下面介绍一下主窗口的几个 Tab 页面功能
Layout |
布局 |
显示整个页面的 |
Master Page |
主页面 |
在报表数据之外添加一些样式 |
Script |
脚本 |
用脚本完成一些特定的功能 |
XML Source |
XML 数据源 |
.prtdesign 文件的实质内容,囊括了全部报表设计 |
Preview |
预览 |
生成报表的预览 |
这里演示一个简单范例。
打开画板工具
将一个 拖入设计窗口
新建一个 2X2 的表格
选中上层两个右键选中点击 作为标题。
添加一个 Label 右下角的 Properies Editor 调整样式 .
添加一个图表
将一个 拖入设计窗口 , 新建一个图表。
这里我们选择 Bar 2D 据有深度 输出格式选择 JPG 。
点击下一步
选择之前创建的数据集。
将 X 轴的值和 Y 轴的值附上,(赋值方法:将表头拖拽至函数框)。
我们对数据进行一次过滤,在数据集右边点击 Filters
添加一个 Top n 的函数,取得前名的数据。
点击下一步
这个步骤主要设计一些图表的显示选项以交互等功能。
添加一个表格
将 拖入设计窗口。
选中表格,在 Property Editor 中绑定数据集。
将数据集拖入表格中。
如果要插入自定义数据
通过构造行数实现数据的定义。
这样报表的设计就完成了。
访问 http://localhost:9099/HelloWorld/helloWorld .jsp