BIRT详细开发手册范本

BIRT详细开发手册

目录

1BIRT开发环境 (3)

1.1新建Project (3)

1.2新建Report (4)

1.3调整工作窗口 (5)

2BIRT报表开发 (6)

2.1新建数据源(Data Sources) (6)

2.2新建数据集(Data Set) (7)

2.3BIRT报表条件 (10)

2.3.1一般条件 (10)

2.3.2日期条件 (11)

2.3.3条件脚本 (11)

2.4BIRT表格 (13)

2.4.1Insert table (13)

2.4.2设置报表表头 (14)

2.4.3表头样式 (14)

2.4.4表格网络线 (15)

2.5绑定数据集 (15)

2.6表格数据添加分组(分组可以不用设根据需求添加) (16)

2.7报表标题(Master Page) (19)

2.8固定布局与自由布局 (20)

2.9报表预览 (21)

2.10数据操作 (23)

2.10.1列求和 (23)

2.10.2数据格式 (26)

3图表制作 (26)

3.1饼状图 (26)

3.2折线图 (32)

3.3柱状图 (38)

3.4图表效果展示 (42)

此文档为本人结合网上资料与本人BIRT开发经验整理的BIRT详细的开发手册，适用于初学者快速掌握BIRT开发。

1BIRT开发环境

BIRT开发环境是带有BIRT插件的eclipse

1.1新建Project

菜单栏file→new→other选择report project→nex，然后给project取名，完成后点击finish即可完成新建project

新建完成后的project

1.2新建Report

在新建的项目上右键new→orher , Report→next, file name为报表名称是以”. rptdesign”为结尾的文件，点击finsh即可完成新建Report.

1.3调整工作窗口

菜单Window→Show View→other→Report Design 调出Data Explorer窗口菜单Window→Show View→other→Report Design 调出Property Editor窗口调出这两个窗口方便报表开发。

拖动显示的窗口，调整如下的布局，方便报表开发

2BIRT报表开发

2.1新建数据源(Data Sources)

在Data Explorer中的 Data Sources 右键New Data Source

数据源类型选择 JDBC Data Source, Data Source Name为数据源名称

Next之后如图3-1

Driver Class在下拉框中选择数据库驱动com.ibm.db2.jcc.DB2Driver(v3.50)

Driver URL 配置数据库连接地址

User Name 与 Password 数据库连接的用户名密码,设置完成后点击Test connection 测试连接显示connect successful则数据源配置完成

图3-1

在Driver Class中找不到对应数据库驱动则可以手动添加驱动

点击Manage Drivers可以添加其他数据库驱动如oracle，点击add添加oracle数据驱动包即可

2.2新建数据集(Data Set)

在Data Explorer中的Data Set

右键New Data Set

设置好Data Set Name后Netx

报表sql,如果报表需要添加条件则在sql后加入 where 1=1,在条件处理是script脚本要用到。

Sql完成后在完成data set前预览sql(Preview Results),数据查看sql是否有问题,然后OK,Data Set 设置完成.

2.3BIRT报表条件

在Data Explorer中的Report Parameters new Parameter

2.3.1一般条件

Name:条件名字(英文字母)，Prompt text:条件提示名字

Is Required:条件是否必填，Hidden:隐藏条件，Default vale:默认值

2.3.2日期条件

日期条件设置时在Prompt text中对日期条件进行设置^^^^yyyyMMdd日期格式为8位字符串型(如:20151012),^^^^yyyy-MM-dd为10位字符串型(如:2015-10-12)

2.3.3条件脚本

点击Data Set下的数据集,然后选中Script页面Script选中beforeOpen在此区域中编写脚本

if( params["DEPT_NAME"] && !params["DEPT_NAME"].value.equals(""))

{

this.queryText = this.queryText+" and DEPT_NAME='"+params["DEPT_NAME"].value+"'"; }

if ( params["DATA_DT"] && !params["DATA_DT"].value.equals(""))

{

this.queryText = this.queryText.replace("1=1","1=1AND DATA_DT=

'"+params["DATA_DT"].value+"'");

}

两种脚本的不同:

第一种为在where 1=1后没有其他sql语句的可直接在1=1后拼接and DEPT_NAME=‘值’SELECT DEPT_NO,DEOT_NAME,SIGN_ACCT_CNT,SIGN_CUST_CNT,DATA_DT FROM

S120_BSD_GDM.FACT_INDIV_TA_SIGN_NUM WHERE1=1 AND DEPT_NAME=‘值’

第二种在where 1=1 后有其他sql时就要用第二种脚本将1=1进行替换1=1 AND

DATA_DT=‘值’(可以多次对1=1替换)

SELECT DEPT_NO,DEOT_NAME,SIGN_ACCT_CNT,SIGN_CUST_CNT,DATA_DT FROM

S120_BSD_GDM.FACT_INDIV_TA_SIGN_NUM WHERE1=1 AND DATA_DT=‘值’ORDER BY DATA_DT

2.4BIRT表格

2.4.1Insert table

插入table在Layout空白处右键Insert Table

Insert Table 设置table的列(Number of columans),Number of details一般不用设置,然后OK,在Layout中即可显示插入的table.

Table中Header Row为表头,Detail Row为对应表头的数据集,Footer Row未用到

2.4.2设置报表表头

在table第一行个表格中点击后右键Insert Label插入文本框输入表头

报表表头设置也可以才3.2添加数据集sql时将sql字段取一个中文别名，如下形式select https://www.360docs.net/doc/4a15755947.html,er_code as 登录名,

https://www.360docs.net/doc/4a15755947.html,er_name as 用户名,

https://www.360docs.net/doc/4a15755947.html,er_no as 用户编号,

https://www.360docs.net/doc/4a15755947.html,er_type as用户类别,

https://www.360docs.net/doc/4a15755947.html,er_email as ,

https://www.360docs.net/doc/4a15755947.html,er_tel as手机号,

https://www.360docs.net/doc/4a15755947.html,er_role as角色,

a.job_name as在岗,

a.status as状态

from portal.portal_sys_user a

按这种方式写sql在配置表格数据时直接拖拽置Detail Row

2.4.3表头样式

选中表头在Property Editor中General设置表头的样式,包含background

color,font,size,color等

2.4.4表格网络线

点击table的左上角区域选中整个table然后在Property Editor中的Border中设置网格线(点击table的左上角区设置网格线为整个表格都设置,选中Table设置网格线则只设置外边框)。

2.5绑定数据集

在Data Set中的数据集将对应表头的字段直接拖拽到Detail Row的对应位置

2.6表格数据添加分组(分组可以不用设根据需求添加) 选中要分组的 Detail Row 然后右键 insert Group

删除多余行

删除完多余行后合并分组

2.7报表标题(Master Page)

Master Page为报表的标题,Border中网格线的方法与table中类似可参考table中网格线的设置,General中设置报表标题颜色、大小、布局方式等

2.8固定布局与自由布局

在Layout的General中的Layout Preference中有两种布局方式:

Auto Layout为自由布局选中自由布局报表会根据窗口大小自动调整,

Fixed Layout为固定布局,布局固定不会根据窗口大小变动

一般将报表设置为自由布局的格式

当报表所需列较多时一般将报表都设置成自由布局，在设置自由布局时要指定列宽否则列宽会自由调整，报表数据会出现挤在一起的情况。

选中表格的列然后在Property Editor下的General中设置Width