BIRT详细开发手册.doc

《BIRT详细开发手册.doc》由会员分享，可在线阅读，更多相关《BIRT详细开发手册.doc（48页珍藏版）》请在得力文库 - 分享文档赚钱的网站上搜索。

1、BIRT详细开发手册 BIRT详细开发手册目 录1BIRT开发环境31.1新建Project31.2新建Report41.3调整工作窗口52BIRT报表开发62.1新建数据源(Data Sources)62.2新建数据集(Data Set)72.3BIRT报表条件102.3.1一般条件102.3.2日期条件112.3.3条件脚本112.4BIRT表格132.4.1Insert table132.4.2设置报表表头142.4.3表头样式142.4.4表格网络线152.5绑定数据集152.6表格数据添加分组(分组可以不用设根据需求添加)162.7报表标题(Master Page)192.8固定布局

2、与自由布局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 projectnex，然后给project取名，完成后点击finish即可完成新建project新建完成后的project1.2 新建Report在新建的项目上右键

3、neworher , Reportnext, file name为报表名称是以”. rptdesign”为结尾的文件，点击finsh即可完成新建Report.1.3 调整工作窗口菜单WindowShow ViewotherReport Design 调出Data Explorer窗口菜单WindowShow ViewotherReport Design 调出Property Editor窗口调出这两个窗口方便报表开发。拖动显示的窗口，调整如下的布局，方便报表开发2 BIRT报表开发2.1 新建数据源(Data Sources)在Data Explorer中的 Data Sources 右键Ne

4、w 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可以添加其他数据库驱动

5、如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.3 BIRT报表条件在Data Explorer中的Report Parametersnew Parameter2.3.1 一般条

6、件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( paramsDEPT_NAME & !paramsDEPT_NAME.value.equal

7、s() this.queryText = this.queryText+ and DEPT_NAME=+paramsDEPT_NAME.value+;if ( paramsDATA_DT & !paramsDATA_DT.value.equals() this.queryText = this.queryText.replace(1=1,1=1 AND DATA_DT = +paramsDATA_DT.value+);两种脚本的不同:第一种为在where 1=1后没有其他sql语句的可直接在1=1后拼接and DEPT_NAME=值 SELECT DEPT_NO,DEOT_NAME,SIGN_

8、ACCT_CNT,SIGN_CUST_CNT,DATA_DT FROM S120_BSD_GDM.FACT_INDIV_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 D

9、ATA_DT2.4 BIRT表格2.4.1 Insert table插入table在Layout空白处右键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字段取一个中文别名，如下形式

10、select a.user_code as 登录名, 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 col

11、or,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为报表的标题,

12、Border中网格线的方法与table中类似可参考table中网格线的设置,General中设置报表标题颜色、大小、布局方式等2.8 固定布局与自由布局在Layout的General中的Layout Preference中有两种布局方式:Auto Layout为自由布局选中自由布局报表会根据窗口大小自动调整,Fixed Layout为固定布局,布局固定不会根据窗口大小变动一般将报表设置为自由布局的格式当报表所需列较多时一般将报表都设置成自由布局，在设置自由布局时要指定列宽否则列宽会自由调整，报表数据会出现挤在一起的情况。选中表格的列然后在Property Editor下的General中设置W

13、idth注：在列较多时在设置列宽时预览不明显或者没变化时，可以将报表布局设置为固定布局，一列一列调整列宽，调整完毕后将布局调整为自由布局，调整后将表格稍微拉宽一点即可。有时由于列较多，在调为固定布局后设置列宽到后边的列会挤在一起，无法调整，可以暂时将布局调整为自由布局，进行设置列宽。调整后仍需将表格稍微拉宽一点。将鼠标放置表格边缘区域即可进行拖动(一般情况下不进行拖动只有在调整布局设置列宽后进行拖动)2.9 报表预览点击View Report in web Viewer预览完成的报表报表预览时有时会出现空白页面不出现结果，产生原因一般是电脑自身环境原因，暂无解决办法，View Report i

14、n web Viewer不能预览时可以用其他的预览方式，如 View Report as HTML，或者换一个开发环境试试。点击运行报表可以输入报表条件2.10 数据操作2.10.1 列求和选中第一行即表头然后右键InsertRowBelow 即可在表头的下边重新插入一行Header Row(如果选中的二行进行插入怎会生成一行Detail Row)在刚插入的Header Row中进行求和计算，选中相应的表格右键InsertAggregation在Aggregation Builder中进行编辑，Display Name 为创建Aggregation Builder的名字，data Type为数

15、据类型可根据需求在下拉框中选择，Function 为函数选择需要的求和函数，Expression为求和的列注：Function中有多种函数可根据报表需求进行选择是求和还是做其他操作Expression:点击 2.10.2 数据格式在有金额列时保留小数点操作选中要控制小数的数据集在Property EditorFormat Number中进行设置Format at中选择所要的数据格式：Unformatted 无格式 General Number 常规 Currency 货币Fixed 固定 Scientific 科学计数Decimal places 保留小数的位数在货币格式下Currency 中

16、有 symbol 可以根据需要选择币种符号3 图表制作注：BIRT图形加日期条件时注意日期格式，饼状图只支持date类型的日期格式不支持8位字符串，所以才配置数据集的时候要修改日期格式。例：(select to_date(data_dt,yyyy-mm-dd) as DATA_DT,BAL,PRODUCT from s411_bsd_birt.line ) 这条sqlIBM官方图表教程视频地址： 3.1 饼状图首先配置好数据源、数据集。将面板中的图表 拖到设计页面中的适当位置(或者右键insert选择chart)，选择图表类型为饼图，3D效果可以选择 ，图片格式也可以选择（一般默认即可）。如下

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

18、饼状图的title暂时未用到分组的可以将其隐藏Labels可以设置数据显示的格式fomat 下的position:下框中选择outside数据在外部，选择inside数据在饼状图中3.2 折线图线图和饼图类似，先配置好数据源、数据集，然后选择图表类型为拆线图。然后配置横轴（X轴）和纵轴（Y轴）。若有多项需要比较，可在配置Y轴时选择“”创建多条项目，并指定数据项。如图：折线 例：折线折点显示数值设置X轴显示风格设置Y轴风格 scale可以设置Y每次增长值(step size) 最小值(min) 最大值(max) 等若想设置Y轴的起始刻度不从0开始，可在图表格式页面左边的树中选择“Y-Axis”项

19、，在右边的页面中点击“Scale”按钮，在出现的窗口中设置步长、最小/大刻度等。如图：设置报表titleLegend：layout设置左侧分类显示的位置, entries设置左侧分类字体的格式 Layout entries3.3 柱状图和前面一样，先配置好数据源、数据集，然后选择图表类型，类型选择为柱形图。跟折线图类似，指定X轴和Y轴的数据项。若有多项需要比较，可在配置Y轴时选择“”创建多条项目，并指定数据项。如图：若想设置Y轴的起始刻度不从0开始，可在图表格式页面左边的树中选择“Y-Axis”项，在右边的页面中点击“Scale”按钮，在出现的窗口中设置步长、最小/大刻度等。如图：若想图例的显示标题，可在图表格式页面左边的树中选择“Series”项，在右边的页面中进行设置。如图：例：1.首先设置数据集如图2.series - value(Y) series Labels可以设置柱状图数值的字体类型格式 可参考饼状图中的labels3.Chart Area中Axis、Title、Plot、Legend的设置与折线图饼状图中类似不做讲解可参考饼状图与折线图3.4 图表效果展示