1、BIRT 详细开发手册目 录1 BIRT 开发环境 .31.1 新建 Project.31.2 新建 Report .41.3 调整工作窗口 52 BIRT 报表开发 .62.1 新建数据源(Data Sources).62.2 新建数据集(Data Set) 72.3 BIRT 报表条件 .102.3.1 一般条件 102.3.2 日期条件 112.3.3 条件脚本 112.4 BIRT 表格 .132.4.1 Insert table 132.4.2 设置报表表头 142.4.3 表头样式 142.4.4 表格网络线 152.5 绑定数据集 152.6 表格数据添加分组(分组可以不用设根据
2、需求添加) 162.7 报表标题(Master Page) .192.8 固定布局与自由布局 202.9 报表预览 212.10 数据操作 232.10.1 列求和 232.10.2 数据格式 263 图表制作 263.1 饼状图 263.2 折线图 323.3 柱状图 383.4 图表效果展示 42此文档为本人结合网上资料与本人 BIRT 开发经验整理的 BIRT 详细的开发手册，适用于初学者快速掌握 BIRT 开发。1 BIRT 开发环境BIRT 开发环境是带有 BIRT 插件的 eclipse1.1 新建 Project菜单栏 filenewother 选择 report project
3、nex，然后给 project 取名，完成后点击 finish即可完成新建 project新建完成后的 project1.2 新建 Report在新建的项目上右键 neworher , Reportnext, file name 为报表名称是以”. rptdesign”为结尾的文件，点击 finsh 即可完成新建 Report.1.3 调整工作窗口菜单 WindowShow ViewotherReport Design 调出 Data Explorer 窗口菜单 WindowShow ViewotherReport Design 调出 Property Editor 窗口调出这两个窗口方便报表
4、开发。拖动显示的窗口，调整如下的布局，方便报表开发2 BIRT 报表开发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 conne
5、ction 测试连接显示 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 完成后在完成 dat
6、a set 前预览 sql(Preview Results),数据查看 sql 是否有问题,然后OK,Data Set 设置完成.2.3 BIRT 报表条件在 Data Explorer 中的 Report Parametersnew Parameter2.3.1 一般条件Name:条件名字(英文字母)，Prompt text:条件提示名字Is Required:条件是否必填，Hidden:隐藏条件，Default vale:默认值2.3.2 日期条件日期条件设置时在 Prompt text 中对日期条件进行设置yyyyMMdd 日期格式为 8 位字符串型(如:20151012),yyyy-M
7、M-dd 为 10 位字符串型( 如:2015-10-12)2.3.3 条件脚本点击 Data Set 下的数据集,然后选中 Script 页面 Script 选中 beforeOpen 在此区域中编写脚本if( params“DEPT_NAME“ if ( params“DATA_DT“ 两种脚本的不同:第一种为在 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_INDI
8、V_TA_SIGN_NUM 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,SIGN_CUST_CNT,DATA_DT FROM S120_BSD_GDM.FACT_INDIV_TA_SIGN_NUM WHERE 1=1 AND DATA_DT=值 ORDER BY DATA_DT2.4 BIRT 表格2.4.1 Insert table插入 table 在 Lay
9、out 空白处右键 InsertTableInsert Table 设置 table 的列(Number of columans),Number of details 一般不用设置,然后 OK,在 Layout 中即可显示插入的 table.Table 中 Header Row 为表头,Detail Row 为对应表头的数据集 ,Footer Row 未用到2.4.2 设置报表表头在 table 第一行个表格中点击后右键 InsertLabel 插入文本框输入表头报表表头设置也可以才 3.2 添加数据集 sql 时将 sql 字段取一个中文别名，如下形式select a.user_code a
10、s 登录名,a.user_name as 用户名,a.user_no as 用户编号,a.user_type as 用户类别,a.user_email as 邮箱,a.user_tel as 手机号,a.user_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
11、.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 为报表的标题,B
12、order 中网格线的方法与 table 中类似可参考 table 中网格线的设置,General 中设置报表标题颜色、大小、布局方式等2.8 固定布局与自由布局在 Layout 的 General 中的 Layout Preference 中有两种布局方式:Auto Layout 为自由布局选中自由布局报表会根据窗口大小自动调整,Fixed Layout 为固定布局 ,布局固定不会根据窗口大小变动一般将报表设置为自由布局的格式当报表所需列较多时一般将报表都设置成自由布局，在设置自由布局时要指定列宽否则列宽会自由调整，报表数据会出现挤在一起的情况。选中表格的列然后在 Property Edit
13、or 下的 General 中设置 Width注：在列较多时在设置列宽时预览不明显或者没变化时，可以将报表布局设置为固定布局，一列一列调整列宽，调整完毕后将布局调整为自由布局，调整后将表格稍微拉宽一点即可。有时由于列较多，在调为固定布局后设置列宽到后边的列会挤在一起，无法调整，可以暂时将布局调整为自由布局，进行设置列宽。调整后仍需将表格稍微拉宽一点。将鼠标放置表格边缘区域即可进行拖动(一般情况下不进行拖动只有在调整布局设置列宽后进行拖动)2.9 报表预览点击 View Report in web Viewer 预览完成的报表报表预览时有时会出现空白页面不出现结果，产生原因一般是电脑自身环境原因
14、，暂无解决办法，View Report in web Viewer 不能预览时可以用其他的预览方式，如 View Report as HTML，或者换一个开发环境试试。点击运行报表可以输入报表条件2.10数据操作2.10.1 列求和选中第一行即表头然后右键 InsertRowBelow 即可在表头的下边重新插入一行 Header Row(如果选中的二行进行插入怎会生成一行 Detail Row)在刚插入的 Header Row 中进行求和计算，选中相应的表格右键 InsertAggregation在 Aggregation Builder 中进行编辑， Display Name 为创建 Agg
15、regation Builder 的名字，data Type 为数据类型可根据需求在下拉框中选择，Function 为函数选择需要的求和函数，Expression 为求和的列注：Function 中有多种函数可根据报表需求进行选择是求和还是做其他操作Expression:点击 2.10.2 数据格式在有金额列时保留小数点操作选中要控制小数的数据集在 Property EditorFormat Number 中进行设置Format at 中选择所要的数据格式：Unformatted 无格式 General Number 常规 Currency 货币Fixed 固定 Scientific 科学计数
16、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 ) 这条 sqlIBM 官方图表教程视频地址： http:/ 饼状图首先配置好数据源、数据集。将面板中的图表 拖到设计页面中的适当位置(或者右键 insert
17、 选择 chart)，选择图表类型为饼图，3D 效果可以选择 ，图片格式也可以选择（一般默认即可）。如下图点击下一步，进入数据选择阶段。选择数据集，然后设置“Category Definition”和“Slice Size Definition”，点击“Category Definition”后的 图标，进入分组和排序窗口，将分组中“Enabled”的勾去掉，如图图中的按日期统计显示为一年的，点击“Category Definition”后的 图标在 unit 中可以选择 datetime 的类型是按天周或者月等进行统计选择按天统计后：若想饼图中的组成部分有一定的间距，可在图表格式“Format Chart”页面左边的树中选择“Value Series ”，在“By Distance”项中设置间距。如图：设置饼状图的 title暂时未用到分组的 可以将其隐藏
