BIRT详细开发手册

BIRT详细开发手册

目录

1BIRT开发环境,2

新建Project3

新建Report4

调整工作窗口,4

2BIRT报表开发5

2.1新建数据源(DataSources)5

新建数据集(DataSet)7

BIRT报表条件8

2一般条件9

日期条件9

条件脚本10

BIRT表格11

Inserttable11

设置报表表头12

表头样式13

表格网络线14

绑定数据集14

表格数据添加分组(分组可以不用设根据需求添加)15

报表标题(MasterPage)18

固定布局与自由布局19

报表预览20

数据操作22

列求和22

数据格式24

3图表制作24

饼状图24

折线图29

柱状图气

图表效果展示39

此文档为本人结合网上资料与本人BIRT开发经验整理的BIRT详细的开发手册，适用于初

学者快速掌握BIRT开发.

1BIRT开发环境

BIRT开发环境是带有BIRT插件的eclipse

1.1新建Project

菜单栏flle->new-^other选择reportproject->nex,然后给project取名，完成后点击finish即可完成

新建project

拖动显示的窗口，调整如下的布局，方便报表开发

——■--—^^———z—

3Resource-birtReport/reportDemo.rptdesign-EclipsePlatform

2.1新建数据源(DataSources)

在DataExplorer中的DataSources右键NewDataSource

数据源类型选择JDBCDataSource,DataSourceName为数据源名称

寻NewDataSource

SelectaDataSourceTypeorChooseaConnectionProfile.

Provideallthesettingsforanewdatasource,orchooseapre-definedconnectionprofile.D

QCreatefromadatasourcet/pcinthefollowinglist

Createfromaconnectionprofileintheprofilestore

ClassicModelsInc.SampleDatabase

PlotFiloDotaSource

JDBCDatabaseConnectionforQueryBuilder[ProCotypa]

JDBCSource?

ScriptedDataSource

WebServicesDataSource

XMLDataSource

DataSourceName:DataSource

Next之后如图3-1

DriverClass在下拉框中选择数据库驱动com.ibin.db2.jcc.DB2Driver(v3.50)

DriverURL配置数据库连接地址

UserName与Password数据库连接的用户名密码，设置完成后点击Testconnection测试连接显示

connectsuccessful则数据源配置完成

eNewJDBCDataSourceProfile|OI回

Createanewdatasource

Createanewdatasource.

Driver£lass:|com.ibm.db2.jcc.DB2Driver(v3.5O)|

DriverURL:jdbc:db2://:60000/bdhadb

UserNgme:etl411

Password:••••••••

JNDIURL:

ManageDrivers...JestConnection...BidiSettings...

②

在DiNext>finishConcel

点击、

2.2新建数据集(DataSet)

在DataExplorer中的DataSet

WReportDesgn-test/tl.rptdesign-EclipsePlatformj

FileEditInsertElementDataPageNavigateSearchP

一?▼回西|财€|喊|二)0.心位£门|、

::Palette塔DataExplor曲ResourceEx=：1司FA(

NewDataSet

NewJointDataSet

病1Paste

右键NewDataSet

设置好.DataSetName后Netx

报表sql,如果报表需要添加条件则在sql后加入where1=1,在条件处理是script脚本要用到。

Sql完成后在完成dataset前预览sql(Previe\vResults),数据查看sql是否有问题，然后OK,DataSet设

置完成.

2.3BIRT报表条件

(\.DataExplorer中的ReportParametersnewParameter

3ReportDes：gn-test/tl.rptdesign-EclipsePlatform

FileEditInsertElementD«taPageNavigateSearch

口Palette国DataExplorEx。

“Q>DataSources

QDataSource

"@DataSets

»于test

—DataCubes

@RefK>r1NewParameter

NewCascadingParameterGroup

NewParameterGroup

Paste

2.3.1一般条件

Name:条件名字(英文字母)，Prompttext:条件提示名字

IsRequired:条件是否必填，Hidden:隐藏条件，Defaultvale:默认值

iNewPdrametef

NewParameter

DisplayAs

Helptext：

Formatas:Unformatted

Previewwithformat

MyString

IktLimitvalues

IsRequiredIDonotccginput

二HiddenAllowDupKcateValues

-**-I

MClear

②[OK|jCancel

2.3.2日期条件

口期条件设置时在Prompttext中对口期条件进行设置MMyyyyMMdd口期格式为8位字符串型

(如:20151012),AMAyyyy_MMRd为10位字符串型(如:2015-1(M2)

，N♦wParam«t«r

NewParameter

DisplayAs

Helptext:

2rompttextFormatas:UnformattedChdng*一

.日期，R-yyyyMMdd卜、WithfOE

Qatatyp*、'〜日期设置MyString

String▼]

listLimitvalues

DisplaytypeJIsRequiredDonotechflinput

TextBox▼HiddenAJIowDuplicateValues

Selectionlistvalues

@StaticDynamic

Defaultvalue:

2.3.3条件脚本

点击DataSet卜的数据集，然后选中Script页面Script选中biforcOpen在此区域中编写脚本

3Dtwgn•

F»eEditPageZa^aceSearchFrojeaRunwindowHdp

二R*po«Dew...'

if(params(1•DEPT-NAME'1]&&!params[nDEPT_NAMEH).value.equals(HH))

(

this.queryText=this.queryText+Hand

DEPT_NAME='"+params[nDEPT_NAMEM].value+"'H;

)

if(params[nDATA_DT*']&&!params["DATApTu].value.equals(M*'))

{

this.queryText=this.queryText.replace("1=1"J'1=1ANDDATA_DT

,,,+params["DATA_DT"].value+,''")；

)

两种脚本的不同：

第一种为在where1=1后没有其他sql语句的可直接在1=1后拼接andDEPT_NAME=，值’

SELECTDEPT_NO,DEOT_NAME,SIGN_ACCT_CNT,SIGN_CUST_CNT,DATA_DTFROM

S120_BSD_GDM.FACT」NDIV_TA_SIGN_NUMWHERE1=1ANDDEPTNAME='值'

第二种在where1=1后有其他sql时就要用第二种脚本将1=1进行替换1=1ANDDATA_DT=，值，(可

以多次对1=1替换)

SELECTDEPT_NO,DEOT_NAME,SIGN_ACCT_CNT,SIGN_CUST_CNT,DATA_DTFROM

S120_BSD_GDM.FACTJNDIV_TA_SIGN_NUMWHERE1=1ANDDATA_DT='值，ORDERBY

DATA_DT

2.4BIRT表格

2.4.1Inserttable

插入tabic在Layout空白处右键Inscrt->Tablc

InsertTable设置table的列(Numberofcolumans),Numberofdetails一般不用设置，然后OK,在Layout

中即可显示插入的table.

Table中HeaderRow为衣头,DetailRow为对应表头的数据集,FooterRow未用到

2.4.2设置报表表头

在table第一行个表格中点击后右键Insert->Label插入文本框输入表头

[<fiUndo

]s>fUdo

HITable

Cut

Copy

Pa«te

Delete

InsertUbd

CopyContentsText

MergeCellsDynamicText

SplitCdlOaU

Exporttolibrary.

Grid

InsertGroup

list

StyleTabi*

CopyFormMChart

MasterP>9«XMl$c

Pa«teformatCrossTab

ZTables的PropertyEditor•3W

EditDaUBending^.

Aggregation

PropertieiMapHiaNiqhts

签娜户值♦签为妒数

1支行楠1支请1数据日期~1

报表表头设置也可以才数据集sql时将sql字段取一个中文别名，如下形式

selecta.user_codeas登录名，

a.user_nameas用户名，

a.user_noas用户编号，

a.user_typeas用户类别，

a.user_emailas邮箱，

a.user_telas手机号，

a.user_roleas角色，

a.job_nameas在岗，

a.statusas状态

fromportal.portalsysusera

按这种方式写sql在配置表格数据时直接拖拽置DetailRow

HDataExplorer金=-ola.test2rptde^gnCopyofFACT.TC.RMB_azhexiarMptdesign£ap.u»er.rptde$ign*yanthil^ptdesigr7

>由DauSources

・®DataSets

■于DauJ

I一用户名峰篇手机号角包在岗状态

I用户名卜

登录名I［用户名）［用户I（角色I［状态］

I用户“3

I用户*

I3

I手矶号

I京色可以不用设置表先直接拖慢中文表头可自动生成

Iee

i«5

«4DatoCubes

fleportP»r»fnKer»

ENaWgator次版Outline-""°1

XProject

2.4.3表头样式

选中表头在PropertyEditor中General设置表头的样式，包含backgroundcolor,font,size,color等

2.4.4表格网络线

点击table的左上角区域选中整个table然后在PropertyEditor中的Border中设置网格线（点击table

的左上角区设置网格线为整个表格都设置，选中Table设置网格线则只设置外边框）。

,reportOenio.rptdewgn二

LayoutMasterPo©eScriptXMLSourcePreview

府Tasks凰PropertyEditor•CM.

PropertyMapHighlights

6eneral

PXM^9

Border

UserProperties

NamedExpressions

EvwtHandler

Advanced

2.5绑定数据集

在DataSet中的数据集将对应表头的字段直接拖拽到DetailRow的对应位置

2.6表格数据添加分组（分组可以不用设根据需求添加）

选中要分组的DetailRow然后右键insertGroup

aFACTJNDIV_TA_SIGN_NUM.rptde5ign&tl.rptdesign区

)2

—

目支行名称支行号签约账户数

国L[DEPTNAME]|[DEPT_NO][SIGN_ACCT_CNT]

'UndoEdit

RedoInsertGroup

xClear

Cut

Copy

Paste

XDelete

Insert

CopyContents

MergeCellsxClear

SplitCell

ExporttoLibrary...

InsertGroup

3NewGroup

删除多余行

•UO,3.,VJdt»M*«»VVflfMSZW，

100%Q▼2/▼的I,•/RepoftD^Z"!."

南FACTJNDIV.TA.SIGN.NUM.rptdesign屈•tl.rptdesign

—

支行名称支行号签约账户数签约客户数数据日期

1=[DEPTJIAME]

(DEPT_NAMEJ(DEPT_NOj(SIGN_ACCT_Cr<T](SIGN_CUST_CNT][DATA_DT]

UndoSelectAllBorders—

Redo

■XDelete

Insert

LayoutMasterFClear

MergeCells鼻

iWPropertyEdit<

SplHCdl

PropertiesMapExport:oLibrary...

GeneralInsertGroup

BorderDeleteGroup

Preview

EditGroup

PageBreak

InsertGroupHeader/Footer

Visibility

BookmarkStyle

UserPropertiesCopyFormat

NamedExpressPasteFormat

EventHandlerEditDs'.oBinding...

lUWbH|I^R

母FACT」NDIVTAS!GNNUM.rptdegc

支行名称支行号签约账户数签约客户数数据日朗

[DEPT_NAME]

[DEPT_NO][SIGN_ACCT_CNT][SIGN_CUST_CNT][DATA_DT]

删除完多余行后合并分组

1日支行名称支行号签约账尸数签约客户数数据日期

[DEPTJIAI3E]

1目DetailR、[DEPT.NO][SIGN.ACCT.CNT][SIGN_CUST_CNT](DATA.DTJ

选中

lay2utMasterPageScriptXMLSource

画PropertyEditor•Cel汉t?Problems□

PropertiesMapHighlights

GeneralGeneral

ElementID:

Border

Rrop:ackgroundcolon[Aut。

UserProperties

VerticalalignmentAutoStyle：None

NamedExpre$sioc5

EvcidHai(diet

S^nsSerif10“points-

Advanced

同IZH囱画回首同

2.7报表标题(MasterPage)

MasterPage为报表的标题,Border中网格线的方法与（able中类似可参考tabic中网格线的设

置.General中设置报表标题颜色、大小、布局方式等

Layout[MasterPage]ScriptXMLSourcePreview

2.8固定布局与自由布局

在Layout的General中的LayoutPreference中有两种布局方式：

AutoLayout为自由布局选中自由布局报表会根据窗口大小自动调整,

FixedLayout为固定布局，布局固定不会根据窗口大小变动

一般将报表设置为自由布局的格式

|layoutMasterPageScriptXMLSourcePreview

/““匕一•'「epe%£c：or-Report.尿o口

PropM)e5

General

Descripbcn

Comments

U*rProperties

NamedExpressions

Resources

EventHandler

Advanced

当报表所需列较多时一般将报表都设置成自由布局，在设置自由布局时要指定列宽否则列宽会自

由调整，报表数据会出现挤在i起的情况。

选中表格的列然后在ProperlyEditor下的General中设置Width

TCRMB3dmi=□1

注；在列较多时在设置列宽时预览不明显或者没变化时，可以将报表布局设置为固定布局，一列

一列调整列宽，调整完毕后将布局调整为自由布局，调整后将表格稍微拉宽一点即可。

有时由于列较多，在调为固定布局后设置列宽到后边的列会挤在一起，无法调整，可以暂时将布

局调整为自由布局，进行设置列宽。调整后仍需将表格稍微拉宽一点。

将鼠标放置表格边缘区域即可进行拖动（一般情况下不进行拖动只有在调整布局设置列宽后进行

拖动）

@CopyofFACTJQRMB.j窗「宿FACTJC.RMB.BALrptd|幽testLrptdyi9nCopyofap.user.admi

员工号登录名性别用户状杰用户来源用户密码

(USER_C006|[LOGINJ1AME][GENDER1[USER_STATUSJ[USER.SOURCE][USER_PASSWD]

国Table

卜

2.9报表预览

点击ViewReportinwebViewer预览完成的报表

RopnrtCavign-tpct/tl.rptdp<ign-FrlipcpPUtfcrm

FileEditInsertElementDataPageNavigateSearchProjectRunWindowHeb

•▼，r7,…100%

wPalette|愎DataExplor区@ResourceEx=已1viewreponinweoviewer

才

⑥DataSources显

3ViewReporta$HTML

0DataSource力

囱DataSets一4ViewReportasPDF

*DataCubes嫡5ViewReportasPOSTSCRIPT支行号

国签约R

&ReportParameters6ViewReportasPPT

卤

<>DEPT.NAME7ViewReportasXLS

<>DEPT.NOLN0][SIGN.ACC

<>DATA.DT

国Variables

心Navigator区生Outline°B

0个圾计LayfiutMasterPageScriptXMLSourcePreyiew

0个货G息直询窗PropertyEditor-Cell球\^Plrobtetn^|

卧国际结苴场计

PropertiesMapHighlights

日借记卡开卡的班

■借记卡开卡娩计GeneralGeneral

报表预览时有时会出现空白页面不出现结果，产生原因一般是电脑自身环境原因，暂无解决办法,

ViewReportinwebViewer不能预览时可以用其他的预览方式，如ViewReportasHTML,或者换

一个开发环境试试。

点击运行报表可以输入报表条件

理财账户签约

麦

行曝X

支

目

行

的

S日

3点击运行报表弹出输入条科据如果有必填现则在运行报表前就会弹出

2.10数据操作

2.10.1列求和

选中第一行即表头然后右键Insert->Row->Below即可在表头的下边重新插入一行HeaderRow（如

果选中的二行进行插入怎会生成一行DetailRow）

在刚插入的HeaderRow中进行求和计算，选中相应的表格右键InsertfAggregation

0twtZrptdesign[®*FACTTC-RMB-BALrpt6&tefiLrptdetigc®te«tllLrptd"gc血•FjGAPSJUTDMST.US>°B

J

LdyfiutMasterPage%rip<XMlSourcePreyiewInsertGroup

List

7Prr»p*rfyFOcr・~ll笈Problem*StyleTable彩0口

CopyFormat

PropertiesMapHighlightsChart

PasteFormat

Cro««Tab

G«ncralGeneral因

EditDauBinding一

PaddmgElementID:

在AggregationBuilder中进行编辑,DisplayName为创建AggregationBuilder的名字，dataType

为数据类型可根据需求在下拉框中选择，Function为函数选择需要的求和函数，Expression为求

和的列

台AggregationBuilder

ColumnBindingName:Aggregation_8

ri

DisplayNameID:

DisplayName:|GXDP_BAL

DataType:Float▼

Function:SUM▼

Expression:dataSetRow["GX_DP_BALB]▼力

1E

FilterCondition:

AggregateOn:。Table

Group▼▼

②

OKCancel

LJ

注：Function中有多种函数可根据报表需求进行选择是求和还是做其他操作

Expression:点击I力

2.10.2数据格式

在有金额列时保留小数点操作

选中要控制小数的数据集在PropertyEditor->FormatNumber中进行设置

的ijn|母*FACT_TCfM”ALqpt［母tetkrpedetige但estmp<d-i9n函・gAPS_AITDM$T.U较・

LayoutfasterPageScriptXMLSourcePre^ew

同PropertyEditor•0—点0Problems

PropertiesBindingMapH^hlights

FormatNumberFormalNumber

formatDateTime

FormatString

Hyperlink

PageBreak

Visibility

TableofContents

Bookmark

Comments

UserProperties

NamedExpression

EventHarxiler

Formatal中选择所要的数据格式:

Unformatted无格式Genera.Number常规