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插件的eclipse1.1新建Project菜单栏file→new→other选择report project→nex，然后给project取名，完成后点击finish即可完成新建project新建完成后的project1.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-1Driver 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 Parameter2.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+" andDEPT_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 FROMS120_BSD_GDM.FACT_INDIV_TA_SIGN_NUM WHERE1=1 AND DEPT_NAME=‘值’第二种在where 1=1 后有其他sql时就要用第二种脚本将1=1进行替换1=1 ANDDATA_DT=‘值’(可以多次对1=1替换)SELECT DEPT_NO,DEOT_NAME,SIGN_ACCT_CNT,SIGN_CUST_CNT,DATA_DT FROMS120_BSD_GDM.FACT_INDIV_TA_SIGN_NUM WHERE1=1 AND DATA_DT=‘值’ORDER BY DATA_DT2.4BIRT表格2.4.1Insert table插入table在Layout空白处右键Insert TableInsert 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 Row2.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位字符串，所以才配置数据集的时候要修改日期格式。