BIRT详细开发手册

1、BIRT详细开发手册目录1 BIRT开发环境31.1 新建Project31.2 新建Report41.3 调整工作窗口52 BIRT报表开发62.1 新建数据源(DataSources)62.2 新建数据集(DataSet)72.3 BIRT报表条件102.3.1 一般条件102.3.2 日期条件112.3.3 条件脚本112.4 BIRT表格132.4.1 Inserttable132.4.2 设置报表表头142.4.3 表头样式142.4.4 表格网络线152.5 绑定数据集152.6 表格数据添加分组(分组可以不用设根据需求添加)162.7 报表标题(MasterPage)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开发。1BIRT开发环境BIRT开发环境是带有 BIRT插件的eclipse1.1 新建Project菜单栏filenewother选择reportprojectnex,然后给project取名，完成后点击finish即可完成新建project新建完成后的project1.2 新建Rep

3、ort在新建的项目上右键neworher,Reportnext,filename为报表名称是以“.rptdesign”为结尾的文件，点击finsh即可完成新建Report.1.3 调整工作窗口other Report Design other Report Design菜单WindowShowView菜单WindowShowView调出DataExplorer窗口调出PropertyEditor窗口调出这两个窗口方便报表开发。等 View| 回 ；拖动显示的窗口，调整如下的布局，方便报表开发，source - biirtReo&*XrroiCFrtDenio ptd-gri - c ipsdc

4、w 44e+p刀Dm7叩电re* i修 5/等 P也 CubvsI(f Report Pararnifftcrs了岫 Vina*tJp言| repcrtDeFnciFtdign - birtRcpa-rtr HZ- Re4ourte2BIRT报表开发2.1 新建数据源(DataSources)在DataExplorer中的DataSources右键NewDataSource数据源类型选择JDBCDataSource,DataSourceName为数据源名称Driver Class 在下拉框中选择数据库驱动com.ibm.db2.jcc.DB2Driver(v3.50)DriverURL配置数据

5、库连接地址UserName与Password数据库连接的用户名密码，设置完成后点击Testconnection测试连接显示connectsuccessful则数据源配置完成含NrwJDBC口已履SourceProfile，CreateanewtiaiasourceCreate口newdistascurzeDriverDriver URL:口鹏匕巾1，曲2/卬口62口出后(v350)jdlbc:db2:/127.0.0,l：60000/bdhadbLkwrNam#-MiniJND1LKL:Bini 5fLttinqq,电行；1口户口ri尸工pqtCoe门户寸：。口，6/426/42RackNex

6、t)Cancel点击Manage Drivers可以添加其他数据库驱动如Jt&C Oven图3-1在DriverClass中找不到对应数据库驱动则可以手动添加驱动oracle,点击add添加oracle数据驱动包即可2.2 新建数据集（DataSet）在DataExplorer中的DataSet右键NewDataSet设置好DataSetName后Netxsql后加入 where 1=1,在条件处理是script脚本要用到。报表sql,如果报表需要添加条件则在Sql完成后在完成dataset前预览sql(PreviewResults),数据查看sql是否有问题，然后OK,DataSet设置完成

7、.2.3 BIRT报表条件在DataExplorer中的ReportParametersnewParameter2.3.1 一般条件Name:条件名字（英文字母）,Prompttext:条件提示名字IsRequired:条件是否必填，Hidden:隐藏条件，Defaultvale:默认值2.3.2 日期条件日期条件设置时在Prompttext中对日期条件进行设置AAAAyyyyMMdd日期格式为8位字符串型（如:20151012）,MMyyyy-MM-dd为10位字符串型（如:2015-10-12）2.3.3 条件脚本点击DataSet下的数据集然后选中Script页面Script选中befo

8、reOpen在此区域中编写脚本11/42if(paramsDEPT_NAME&!paramsDEPT_NAME.value.equals()this.queryText=this.queryText+andDEPT_NAME=+paramsDEPT_NAME.value+;if(paramsDATA_DT&!paramsDATA_DT.value.equals()this.queryText=this.queryText.replace(1=1,1=1ANDDATA_DT=+paramsDATA_DT.value+);两种脚本的不同：第一种为在where1=1后没有其他sql语句的可直接在1=

9、1后拼接andDEPT_NAME=值SELECTDEPT_NO,DEOT_NAME,SIGN_ACCT_CNT,SIGN_CUST_CNT,DATA_DTFROMS120_BSD_GDM.FACT_INDIV_TA_SIGN_NUMWHERE1=1ANDDEPT_NAME=值第二种在where1=1后有其他sql时就要用第二种脚本将1=1进行替换1=1ANDDATA_DT=值(可以多次对1=1替换)SELECTDEPT_NO,DEOT_NAME,SIGN_ACCT_CNT,SIGN_CUST_CNT,DATA_DTFROMS120_BSD_GDM.FACT_INDIV_TA_SIGN_NUMW

10、HERE1=1ANDDATA_DT=值ORDERBYDATA_DT2.4 BIRT表格2.4.1 Inserttable插入table在Layout空白处右键InsertTableInsertTable设置table的歹U(Numberofcolumans),Numberofdetails一般不用设置，然后OK,在Layout中即可显示插入的table.Table中HeaderRow为表头，DetailRow为对应表头的数据集，FooterRow未用到2.4.2 设置报表表头在table第一行个表格中点击后右键InsertLabel插入文本框输入表头二r_undoSpF p蕤甘 Ocliptp

11、,* *ECQprCQMCfV-K3kSplit CdlEpoTl g Libu/fLn3c疯 Groijp一T-XhXTDrh&mie Twt 口 3tBInage- 自rid LittTnheOwl Craw TabIrI支行的支行号笞辨户值卷加嬲_弛唾/国qi包，罪为M2迎13匚&TgkxH料口用/EdDF-tdl:Fprf-MapHgibgFftElyIp-S修F口Eizrt他筑eFoit-iatEdiDvitalBinding.蚂qeg1谄r报表表头设置也可以才3.2添加数据集sql时将sql字段取一个中文别名，如下形式selecta.user_codeas登录名,a.user_na

12、meas用户名,a.user_noas用户编号,a.user_typeas用户类另Ia.user_emailas邮箱,a.user_telas手机号,a.user_roleas角色，a.job_nameas在岗,a.statusas 状态1x1，:1七日列PACF TC iRMS史hniiHEdfi 旧仁.立M.皿胃 版Outfne宜Fwfromportal.portal_sys_usera按这种方式写sql在配置表格数据日直接拖拽置DetailRow*D*宁口*j审DataII唏今年I西FHBnE科总一一一B邑ai或事口心Cubati。ftepon.*mK.e&2.4.3 表头样式选中表头在

13、PropertyEditor中General设置表头的样式，包含backgroundcolor,font,size,color2.4.4 表格网络线点击table的左上角区域选中整个table然后在PropertyEditor中的Border中设置网格线（点击table的左上角区设置网格线为整个表格都设置，选中Table设置网格线则只设置外边框）。2.5 绑定数据集在DataSet中的数据集将对应表头的字段直接拖拽到DetailRow的对应位置2.6表格数据添加分组（分组可以不用设根据需求添加）选中要分组的DetailRow然后右键insertGroup删除多余行17/42删除完多余行后合并分

14、组kwIWU-VI.I|H.UE-MyrIMkM|MHVM|frF，d2.7 报表标题(MasterPage)MasterPage为报表的标题，Border中网格线的方法与table中类似可参考table中网格线的设置,General中设置报表标题颜色、大小、布局方式等ditw-Ldsbe父2.8 固定布局与自由布局在Layout的General中的LayoutPreference中有两种布局方式AutoLayout为自由布局选中自由布局报表会根据窗口大小自动调整FixedLayout为固定布局，布局固定不会根据窗口大小变动一般将报表设置为自由布局的格式当报表所需列较多时一般将报表都设置成自由

15、布局，在设置自由布局时要指定列宽否则列宽会自由调整，报表数据会出现挤在一起的情况。选中表格的列然后在PropertyEditor下的General中设置Width注：在列较多时在设置列宽时预览不明显或者没变化时，可以将报表布局设置为固定布局，一列一列调整列宽，调整完毕后将布局调整为自由布局，调整后将表格稍微拉宽一点即可。有时由于列较多，在调为固定布局后设置列宽到后边的列会挤在一起，无法调整，可以暂时将布局调整为自由布局，进行设置列宽。调整后仍需将表格稍微拉宽一点。将鼠标放置表格边缘区域即可进行拖动（一般情况下不进行拖动只有在调整布局设置列宽后进行拖动）-JElMCT.TC.BM&.BALrpI

16、d看tMUL.rptdei*gn国3眄&;*12.9 报表预览点击ViewReportinwebViewer预览完成的报表报表预览时有时会出现空白页面不出现结果，产生原因一般是电脑自身环境原因，暂无解决办法，ViewReportinwebViewer不能预览时可以用其他的预览方式，如ViewReportasHTML,或者换一个开发环境试试。点击运行报表可以输入报表条件2.10 数据操作2.10.1 列求和Header选中第一行即表头然后右键InsertRowBelow即可在表头的下边重新插入一行Row（如果选中的二行进行插入怎会生成一行Detail Row）在刚插入的Header Row中进行

17、求和计算，选中相应的表格右键Insert AggregationdataType为数据类型可根据需求在下拉框中选择，Function为函数选择需要的求和函数,Expression为求和的列注：Function中有多种函数可根据报表需求进行选择是求和还是做其他操作在AggregationBuilder中进行编辑，DisplayName为创建AggregationBuilder的名字,Expression:点击2.10.2 数据格式在有金额列时保留小数点操作选中要控制小数的数据集在Property Editor Format Number中进行设置Formatat中选择所要的数据格式：Unform

18、atted无格式GeneralNumber常规Currency货币Fixed固定Scientific科学计数Decimalplaces保留小数的位数在货币格式下Currency中有symbol可以根据需要选择币种符号3图表制作注：BIRT图形加日期条件时注意日期格式，饼状图只支持date类型的日期格式不支持8位字符串，所以才配置数据集的时候要修改日期格式。例：（selectto_date（data_dt,yyyy-mm-dd）asDATA_DT,BAL,PRODUCTfroms411_bsd_birt.line）这条sqlIBM官方图表教程视频地址：3.1 饼状图拖到设计页面中的适当位置（或者

19、右键insert选才I chart）,选择首先配置好数据源、数据集,将面板中的图表llcjchart图表类型为饼图，3D效果可以选择的*皿山画.，图片格式也可以选择（一般默认即可）。如下图Select Chart TypeIU BarH：UneAreaPieMeterI： Scatter llii Stock * Bubble Hr DiifferenceH GanttTube|封 Cone11 li ,产Seed Subtypedimension:Multiple Y Axis:Orerrtation:2D WJth Depth2D With DepthFlip AxisQutput For

20、mat； JPGSeriej Type;Pie Senfj点击下一步，进入数据选择阶段。选择数据集，然后设置“CategoryDefinition和SliceSize同一Definition，点击CategoryDefinition后的图标，进入分组和排序窗口，将分组中“Enabled”的勾去掉，如图VtSeedCha*tType4SelectData区FormatChartChrtPrw/wPieChartTitleMs Si pjffiiiitior： iviin 11-4JPfEFVIfc?WL2. SOOSenes 1Cpsnal Graupinc；& FiData SetSttlRr

21、t Dfwtn_ Inherit Dita fromhh it CulwnI Uip bafta framfl0 rParamMrtiETSDflffl P Me n(|right-ciick. elu or dtraq the co .d 祖 pfRvish图中的按日期统计显示为一年的，点击“ Category Definition ”后的图标在unit中可以选择datetime的类型是按天周或者月等进行统计选择按天统计后:若想饼图中的组成部分有一定的间距，可在图表格式“FormatChart”页面左边的树中选择ValueSeries,在ByDistance”项中设置间距。如图：mRlEdi

22、rtTypr屏SelectDafa施Fwma卜ChartSerifiJVilu#54rlec-4m-KilePfDtLeqendChiartPreviowPieChartTitle一油知能阳避卅世冷星空目ValuuSoflieScriDrtnlsLeaderLireElVfefctettSdecs什必rtTypeOi.SelectDatagFporuitChartSerinCustgory4dUaucSeriesCharlAjeThleMatLegend131orIPreView饼状图-600VHlufiSeri自5ExplodeSliceWrr：:ByHistantfi!SlireCMlir

23、：T加严upiireE2015华11月12日20世年11月13日fl2。力星11月14日Ph0Katetions肃|Slice|J,VtiibeIuoderLifeLcadhLireLength：10H是否显示捌居勾述显示，不勾选不正示设置饼状图的titleIkSelectChart耳鼻getD箝号mF&nriatChart5河口与*ri=Vrfu芒4丑Chrt息u。TrdePtdLegendChartPruviuw饼状图0现15年11月HE0201睥11月13(-厘115年11月14日TiDoSeries1C&HThl去代四F&rfc Jl.s.之W*blcI.名字同国.点饼云傥百字楠格式暂

24、时未用到分组的Series1可以将其隐藏Labels可以设置数据显示的格式fomat下白pposition:下框中选择outside数据在外部,选才Iinside数据在饼状图中Oart Pr密vim班.EMb小1c第eg匕咋$/唱?仅N- 5fHChifl： &口 T*k PlotL叫亭JIt *dt O-mrf jpr Ji 5ri 口日3Vidius SeRrte*Lc.d” 不审 length 10 ZEkzIdarharl Preview饼状图Formatcsiiicn:；Insidei|Font:AntoiXuto)|ABackground;Tran5paremt*Shadow:Tr

25、ansparent，QutJineVisible3.2 折线图线图和饼图类似，先配置好数据源、数据集，然后选择图表类型为拆线图。然后配置横轴（X轴）和纵轴（Y轴）。若有多项需要比较，可在配置Y轴时选择“NewSeries”创建多条项目，并指定数据| Select Chart Type Select Data Format ChartChart Preview项。如图：折线例:三M士一玉共口M90河30如和可折线折点显示数值|fa|-Sel&c：Charrlpe5lecrfatFermatChartChartPreviewValuemSeriesCharl AitjAjri专X-AjiisV-A

26、jtsTidePlotUegerdLine Chart Title颁 6M) 700 EW5忖 41M 3M2 DC百木注+玉花 2口好年11月匕日即15年口曰ID15年11月14日Value(Y)Serios.n-Shsidc： TranpflirenfLse Series alette 阜二 Ura ColorI-! Shew Liriss b$ Cuzg llCflrnflrt: M ie si ng /kiH目整显不圻畿点弓乜玉融，”543|5howCawFittingLine被值.Mdrkt二if一iiiiin.Iifti*f_dLiiCy设置X轴显示风格ChfirtLine Cha

27、rt Title此SelectChartTyp-e$eect31mt由FormatChartV*Iue(V)5e6日CKariArefl.Ajri?X Aw1TMePlatLtgend训 gTOO 弧 50。 如Q 3QC20QBQDM0300加1碑11月1204CC1年1月1汨602013年Ti月3日设置Y轴风格scale可以设置Y每次增长值(stepsize)最小值(min)最大值(max)等fctSdectCHacrtTypeEelectDatatrtfFofist匚卜art5Gd转U*lui(Y，卜-M、Chrr ArififlAmeXTbKY-AnmTide PMLegmdChert ProwiowBCO5 CO n j coLine Chart Titleeoon4C