BIRT初窥（二）

运行第一个 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