BIRT详细开发手册

BIRT详细开发手册
BIRT详细开发手册
目录
1BIRT开发环境 (6)
1.1..................... 新建Project
7
1.2..................... 新建Report
8
1.3..................... 调整工作窗口
9
2BIRT报表开发 (11)
2.5....................... 绑定数据集
24
2.6表格数据添加分组(分组可以不用设根
据需求添加) (25)
2.7......... 报表标题(Master Page)
29
2.8............... 固定布局与自由布局
30
2.9......................... 报表预览
32
2.10........................ 数据操作
35
2.10.1................... 列求和
35
2.10.2................. 数据格式
38
3图表制作 (39)
3.1........................... 饼状图
39
3.2........................... 折线图
46
3.3........................... 柱状图
53
3.4..................... 图表效果展示
58
此文档为本人结合网上资料与本人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=1 AND DATA_DT= '"+params["DATA_DT"].value+"'");
}
两种脚本的不同:
第一种为在where 1=1后没有其他sql语句的可直接在1=1后拼接and DEPT_NAME=‘值’SELECT
DEPT_NO,DEOT_NAME,SIGN_ACCT_CNT,S IGN_CUST_CNT,DATA_DT FROM
S120_BSD_GDM.FACT_INDIV_TA_SIGN_NU M WHERE 1=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,S IGN_CUST_CNT,DATA_DT FROM
S120_BSD_GDM.FACT_INDIV_TA_SIGN_NU M 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 er_code as 登录名,
er_name as 用户名,
er_no as 用户编号,
er_type as用户类别,
er_email as邮箱,
er_tel as手机号,
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
注：在列较多时在设置列宽时预览不明显或者没变化时，可以将报表布局设置为固定布局，一列一列调整列宽，调整完毕后将布局调整为自由布局，调整后将表格稍微拉宽一点即可。

有时由于列较多，在调为固定布局后设置列宽到后边的列会挤在一起，无法调整，可以暂时将布局调整为自由布局，进行设置列宽。

调整后仍需将表格稍微拉宽一点。

将鼠标放置表格边缘区域即可进行拖动(一般情况下不进行拖动只有在调整布局设置列宽后进行拖动)
2.9报表预览
点击View Report in web Viewer预览完成的报表
报表预览时有时会出现空白页面不出现结果，产生原因一般是电脑自身环境原因，暂无解决办法，View Report in web Viewer不能预览时可以用其他的预览方式，如View Report as HTML，或者换一个开发环境试试。

点击运行报表可以输入报表条件
2.10数据操作
2.10.1列求和
选中第一行即表头然后右键
Insert→Row→Below 即可在表头的下边重新插入一行Header Row(如果选中的二行进行插入怎会生成一行Detail Row)
在刚插入的Header Row中进行求和计算，选中相应的表格右键Insert→Aggregation
在Aggregation Builder中进行编辑，Display Name 为创建Aggregation Builder的名字，data Type为数据类型可根据需求在下拉框中选择，Function 为函数选择需要的求和函数，Expression为求和的列
注：Function中有多种函数可根据报表需求进行选择是求和还是做其他操作
Expression:点击
2.10.2数据格式
在有金额列时保留小数点操作
选中要控制小数的数据集在Property
Editor Format Number中进行设置
Format at中选择所要的数据格式：Unformatted 无格式General Number 常规Currency 货币
Fixed 固定Scientific 科学计数
Decimal places 保留小数的位数
在货币格式下Currency 中有symbol 可以根据需要选择币种符号
3图表制作
注：BIRT图形加日期条件时注意日期格式，饼状图只支持date类型的日期格式不支持8位字符串，所以才配置数据集的时候要修改日期格式。

例：(select to_date(data_dt,'yyyy-mm-dd') as DATA_DT,BAL,PRODUCT from
s411_bsd_birt.line ) 这条sql
IBM官方图表教程视频地址：
/demos/combochart/co mbinationchart.html
3.1饼状图
首先配置好数据源、数据集。

将面板中的图表拖到设计页面中的适当位置(或者右键insert选择chart)，选择图表类型为饼图，3D效果可以选择，图片格式也可以选择（一般默认即可）。

如下图
点击下一步，进入数据选择阶段。

选择数据集，然后设置“Category Definition”和“Slice Size Definition”，点击“Category Definition”后的图标，进入分组和排序窗口，将分组中“Enabled”的勾去掉，如图
图中的按日期统计显示为一年的，点击“Category Definition”后的图标
在unit中可以选择datetime的类型是按天周或者月等进行统计
选择按天统计后：
若想饼图中的组成部分有一定的间距，可在图表格式“Format Chart”页面左边的树中选择
“Value Series”，在“By Distance”项中设置间距。

如图：
设置饼状图的title
暂时未用到分组的可以将其隐藏
Labels可以设置数据显示的格式fomat 下的position:下框中选择outside数据在外部，选择inside数据在饼状图中
3.2折线图
线图和饼图类似，先配置好数据源、数据集，然后选择图表类型为拆线图。

然后配置横轴（X轴）和纵轴（Y轴）。

若有多项需要比较，可在配置Y轴时选择“< New Series…>”创建多条项目，并指定数据项。

如图：
折线例：
折线折点显示数值
设置X轴显示风格
设置Y轴风格scale可以设置Y每次增长值(step size) 最小值(min) 最大值(max) 等
若想设置Y轴的起始刻度不从0开始，可在图表格式页面左边的树中选择“Y-Axis”项，在右边的页面中点击“Scale”按钮，在出现的窗口中设置步长、最小/大刻度等。

如图：。