《BIRT详细开发手册.pdf》由会员分享，可在线阅读，更多相关《BIRT详细开发手册.pdf（42页珍藏版）》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、BIRT 详细开发手册BIRTBIRT 详细开发手册详细开发手册1 1/42421 1/4242BIRT 详细开发手册目目录录1BIRT 开发环境.31.11.21.322.12.22.3新建 Project.3新建 Report.4调整工作窗口.5新建数据源(Data Sources).6新建数据集(Data Set).7BIRT 报表条件.102.3.12.3.22.3.32.42.4.12.4.22.4.32.4.42.52.62.72.82.92.10一般条件.10日期条件.11条件脚本.11Insert table.13设置报表表头.14表头样式.14表格网络线.15BIRT 报表开
2、发.6BIRT 表格.13绑定数据集.15表格数据添加分组(分组可以不用设根据需求添加).16报表标题(Master Page).19固定布局与自由布局.20报表预览.21数据操作.232.10.1 列求和.232.10.2 数据格式.263图表制作.263.13.23.33.4饼状图.26折线图.32柱状图.38图表效果展示.422 2/42422 2/4242BIRT 详细开发手册此文档为本人结合网上资料与本人BIRT 开发经验整理的 BIRT 详细的开发手册，适用于初学者快速掌握 BIRT 开发。1 1 BIRTBIRT 开发环境开发环境BIRT 开发环境是带有 BIRT 插件的 ecl
3、ipse1.11.1新建新建 ProjectProject菜单栏 filenewother 选择 report projectnex，然后给project 取名，完成后点击finish 即可完成新建 project3 3/42423 3/4242BIRT 详细开发手册新建完成后的 project1.21.2新建新建 ReportReport在新建的项目上右键 neworher,Reportnext,file name 为报表名称是以”.rptdesign”为结尾的文件，点击 finsh 即可完成新建 Report.4 4/42424 4/4242BIRT 详细开发手册1.31.3调整工作窗口调
4、整工作窗口菜单 WindowShow ViewotherReport Design 调出 Data Explorer 窗口菜单 WindowShow ViewotherReport Design 调出 Property Editor 窗口调出这两个窗口方便报表开发。拖动显示的窗口，调整如下的布局，方便报表开发5 5/42425 5/4242BIRT 详细开发手册2 2 BIRTBIRT 报表开发报表开发2.12.1新建数据源新建数据源(Data Sources)(Data Sources)在 Data Explorer 中的 Data Sources 右键 New Data Source数据源
5、类型选择 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 则数据源配置完成6 6/42426 6/4242BIRT 详细开发手册图 3-1在 Driver Class 中找不到对应数据库驱动则可以手动添加驱动点击 Manag
6、e Drivers 可以添加其他数据库驱动如 oracle，点击 add 添加 oracle 数据驱动包即可2.22.2新建数据集新建数据集(Data Set)(Data Set)在 Data Explorer 中的 Data Set右键 New Data Set7 7/42427 7/4242BIRT 详细开发手册设置好 Data Set Name 后 Netx报表 sql,如果报表需要添加条件则在sql 后加入 where 1=1,在条件处理是 script 脚本要用到。8 8/42428 8/4242BIRT 详细开发手册Sql 完成后在完成 data set 前预览 sql(Previ
7、ew Results),数据查看 sql 是否有问题,然后 OK,DataSet 设置完成.9 9/42429 9/4242BIRT 详细开发手册2.32.3BIRTBIRT 报表条件报表条件在 Data Explorer 中的 Report Parametersnew Parameter2.3.12.3.1一般条件一般条件Name:条件名字(英文字母)，Prompt text:条件提示名字Is Required:条件是否必填，Hidden:隐藏条件，Default vale:默认值1010/42421010/4242BIRT 详细开发手册2.3.22.3.2日期条件日期条件日期条件设置时在
8、Prompt text 中对日期条件进行设置yyyyMMdd 日期格式为 8 位字符串型(如:20151012),yyyy-MM-dd为 10 位字符串型(如:2015-10-12)2.3.32.3.3条件脚本条件脚本点击 Data Set 下的数据集,然后选中 Script 页面 Script 选中 beforeOpen 在此区域中编写脚本1111/42421111/4242BIRT 详细开发手册ifif(paramsDEPT_NAME&!paramsDEPT_NAME.value.equals()thisthis.queryText=thisthis.queryText+andDEPT_N
9、AME=+paramsDEPT_NAME.value+;ifif(paramsDATA_DT&!paramsDATA_DT.value.equals()thisthis.queryText=thisthis.queryText.replace(1=1,1=1 AND DATA_DT=+paramsDATA_DT.value+);两种脚本的不同:第一种为在 where 1=1 后没有其他 sql 语句的可直接在 1=1 后拼接 and DEPT_NAME=值SELECTSELECT DEPT_NO,DEOT_NAME,SIGN_ACCT_CNT,SIGN_CUST_CNT,DATA_DTFROM
10、FROMS120_BSD_GDM.FACT_INDIV_TA_SIGN_NUMWHEREWHERE1=1ANDANDDEPT_NAME=值第二种在 where 1=1 后有其他 sql 时就要用第二种脚本将 1=1 进行替换 1=1ANDANDDATA_DT=值(可以多次对 1=1 替换)SELECTSELECT DEPT_NO,DEOT_NAME,SIGN_ACCT_CNT,SIGN_CUST_CNT,DATA_DTFROMFROMS120_BSD_GDM.FACT_INDIV_TA_SIGN_NUMWHEREWHERE1=1ANDANDDATA_DT=值ORDERORDERBYBYDATA
11、_DT1212/42421212/4242BIRT 详细开发手册2.42.4BIRTBIRT 表格表格2.4.12.4.1Insert tableInsert table插入 table 在 Layout 空白处右键 InsertTableInsert Table 设置 table 的列(Number of columans),Number of details一般不用设置,然后 OK,在 Layout 中即可显示插入的 table.Table 中 Header Row 为表头,Detail Row 为对应表头的数据集,Footer Row 未用到1313/42421313/4242BIRT
12、详细开发手册2.4.22.4.2设置报表表头设置报表表头在 table 第一行个表格中点击后右键InsertLabel 插入文本框输入表头报表表头设置也可以才 3.2 添加数据集 sql 时将 sql 字段取一个中文别名，如下形式selectselect a.user_code asas 登录名,a.user_nameasas 用户名,a.user_noasas 用户编号,a.user_typeasas 用户类别,a.user_emailasas 邮箱,a.user_telasas 手机号,a.user_roleasas 角色,a.job_nameasas 在岗,a.statusasas 状态
13、fromfrom portal.portal_sys_user a按这种方式写 sql 在配置表格数据时直接拖拽置Detail Row2.4.32.4.3表头样式表头样式选中表头在 Property Editor 中 General 设置表头的样式,包含 background color,font,size,color1414/42421414/4242BIRT 详细开发手册等2.4.42.4.4表格网络线表格网络线点击 table 的左上角区域选中整个table 然后在 Property Editor 中的 Border 中设置网格线(点点击击 tabletable的左上角区设置网格线为整个
14、表格都设置的左上角区设置网格线为整个表格都设置,选中选中TableTable设置网格线则只设置外边框设置网格线则只设置外边框)。2.52.5绑定数据集绑定数据集在 Data Set 中的数据集将对应表头的字段直接拖拽到Detail Row 的对应位置1515/42421515/4242BIRT 详细开发手册2.62.6表格数据添加分组表格数据添加分组(分组可以不用设根据需求添加分组可以不用设根据需求添加)选中要分组的 Detail Row 然后右键 insert Group1616/42421616/4242BIRT 详细开发手册删除多余行1717/42421717/4242BIRT 详细开发
15、手册1818/42421818/4242BIRT 详细开发手册删除完多余行后合并分组2.72.7报表标题报表标题(Master Page)(Master Page)Master Page 为报表的标题,Border 中网格线的方法与 table 中类似可参考 table 中网格线的设置,General 中设置报表标题颜色、大小、布局方式等1919/42421919/4242BIRT 详细开发手册2.82.8固定布局与自由布局固定布局与自由布局在 Layout 的 General 中的 Layout Preference 中有两种布局方式:Auto Layout 为自由布局选中自由布局报表会根据
16、窗口大小自动调整,Fixed Layout 为固定布局,布局固定不会根据窗口大小变动一般将报表设置为自由布局的格式当报表所需列较多时一般将报表都设置成自由布局，在设置自由布局时要指定列宽否则列宽会自由调整，报表数据会出现挤在一起的情况。选中表格的列然后在Property Editor 下的 General 中设置 Width2020/42422020/4242BIRT 详细开发手册注：在列较多时在设置列宽时预览不明显或者没变化时，可以将报表布局设置为固定布局，一列一列调整列宽，调整完毕后将布局调整为自由布局，调整后将表格稍微拉宽一点即可。有时由于列较多，在调为固定布局后设置列宽到后边的列会挤在
17、一起，无法调整，可以暂时将布局调整为自由布局，进行设置列宽。调整后仍需将表格稍微拉宽一点。将鼠标放置表格边缘区域即可进行拖动(一般情况下不进行拖动只有在调整布局设置列宽后进行拖动)2.92.9报表预览报表预览点击 View Report in web Viewer预览完成的报表2121/42422121/4242BIRT 详细开发手册报表预览时有时会出现空白页面不出现结果，产生原因一般是电脑自身环境原因，暂无解决办法，View Report in web Viewer不能预览时可以用其他的预览方式，如 View Report asHTML，或者换一个开发环境试试。点击运行报表可以输入报表条件2
18、222/42422222/4242BIRT 详细开发手册2.102.10数数据操作据操作2.10.12.10.1 列求和列求和选中第一行即表头然后右键InsertRowBelow 即可在表头的下边重新插入一行HeaderRow(如果选中的二行进行插入怎会生成一行Detail Row)在刚插入的 Header Row 中进行求和计算，选中相应的表格右键InsertAggregation2323/42422323/4242BIRT 详细开发手册在 Aggregation Builder 中进行编辑，Display Name 为创建 Aggregation Builder的名字，dataType 为
19、数据类型可根据需求在下拉框中选择，Function 为函数选择需要的求和函数，Expression 为求和的列注：Function 中有多种函数可根据报表需求进行选择是求和还是做其他操作Expression:点击2424/42422424/4242BIRT 详细开发手册2525/42422525/4242BIRT 详细开发手册2.10.22.10.2 数据格式数据格式在有金额列时保留小数点操作选中要控制小数的数据集在Property EditorFormat Number 中进行设置Format at 中选择所要的数据格式：Unformatted 无格式General Number 常规Cur
20、rency 货币Fixed 固定Scientific 科学计数Decimal places 保留小数的位数在货币格式下 Currency 中有 symbol 可以根据需要选择币种符号3 3 图表制作图表制作注：BIRT 图形加日期条件时注意日期格式，饼状图只支持date 类型的日期格式不支持8 位字符串，所以才配置数据集的时候要修改日期格式。例：(selectselectto_date(data_dt,yyyy-mm-dd)asas DATA_DT,BAL,PRODUCTfromfrom s411_bsd_birt.line)这条 sqlIBM 官方图表教程视频地址：http:/ insert
21、 选择 chart)，选择2626/42422626/4242BIRT 详细开发手册图表类型为饼图，3D 效果可以选择即可）。如下图，图片格式也可以选择（一般默认点击下一步，进入数据选择阶段。选择数据集，然后设置“Category Definition”和“Slice SizeDefinition”，点击“Category Definition”后的“Enabled”的勾去掉，如图图标，进入分组和排序窗口，将分组中图中的按日期统计显示为一年的，点击“Category Definition”后的在 unit 中可以选择 datetime 的类型是按天周或者月等进行统计图标2727/4242272
22、7/4242BIRT 详细开发手册选择按天统计后：若想饼图中的组成部分有一定的间距，可在图表格式“Format Chart”页面左边的树中选择“Value Series”，在“By Distance”项中设置间距。如图：2828/42422828/4242BIRT 详细开发手册2929/42422929/4242BIRT 详细开发手册设置饼状图的 title暂时未用到分组的可以将其隐藏3030/42423030/4242BIRT 详细开发手册Labels 可以设置数据显示的格式 fomat 下的 position:下框中选择 outside 数据在外部，选择 inside 数据在饼状图中313
23、1/42423131/4242BIRT 详细开发手册3.23.2折线图折线图线图和饼图类似，先配置好数据源、数据集，然后选择图表类型为拆线图。然后配置横轴（X轴）和纵轴（Y 轴）。若有多项需要比较，可在配置Y 轴时选择“”创建多条项目，并指定数据项。如图：折线 例：3232/42423232/4242BIRT 详细开发手册折线折点显示数值3333/42423333/4242BIRT 详细开发手册设置 X 轴显示风格设置 Y 轴风格 scale 可以设置 Y 每次增长值(step size)最小值(min)最大值(max)等3434/42423434/4242BIRT 详细开发手册若想设置 Y
24、轴的起始刻度不从 0 开始，可在图表格式页面左边的树中选择“Y-Axis”项，在右边的页面中点击“Scale”按钮，在出现的窗口中设置步长、最小/大刻度等。如图：3535/42423535/4242BIRT 详细开发手册设置报表 title3636/42423636/4242BIRT 详细开发手册Legend：layout 设置左侧分类显示的位置,entries 设置左侧分类字体的格式Layoutentries3737/42423737/4242BIRT 详细开发手册3.33.3柱状图柱状图和前面一样，先配置好数据源、数据集，然后选择图表类型，类型选择为柱形图。跟折线图类似，指定 X 轴和 Y
25、 轴的数据项。若有多项需要比较，可在配置Y 轴时选择“”创建多条项目，并指定数据项。如图：3838/42423838/4242BIRT 详细开发手册若想设置 Y 轴的起始刻度不从 0 开始，可在图表格式页面左边的树中选择“Y-Axis”项，在右边的页面中点击“Scale”按钮，在出现的窗口中设置步长、最小/大刻度等。如图：3939/42423939/4242BIRT 详细开发手册若想图例的显示标题，可在图表格式页面左边的树中选择“Series”项，在右边的页面中进行设置。如图：例：1.首先设置数据集如图4040/42424040/4242BIRT 详细开发手册2.series-value(Y)seriesLabels 可以设置柱状图数值的字体类型格式 可参考饼状图中的 labels4141/42424141/4242BIRT 详细开发手册3.Chart Area 中 Axis、Title、Plot、Legend 的设置与折线图饼状图中类似不做讲解可参考饼状图与折线图3.43.4图表效果展示图表效果展示4242/42424242/4242