BIRT詳細(xì)開發(fā)手冊

1、BIRT詳細(xì)開發(fā)手冊 BIRT詳細(xì)開發(fā)手冊目 錄1BIRT開發(fā)環(huán)境31.1新建Project31.2新建Report41.3調(diào)整工作窗口52BIRT報表開發(fā)62.1新建數(shù)據(jù)源(Data Sources)62.2新建數(shù)據(jù)集(Data Set)72.3BIRT報表條件102.3.1一般條件102.3.2日期條件112.3.3條件腳本112.4BIRT表格132.4.1Insert table132.4.2設(shè)置報表表頭142.4.3表頭樣式142.4.4表格網(wǎng)絡(luò)線152.5綁定數(shù)據(jù)集152.6表格數(shù)據(jù)添加分組(分組可以不用設(shè)根據(jù)需求添加)162.7報表標(biāo)題(Master Page)192.8固定布局

2、與自由布局202.9報表預(yù)覽212.10數(shù)據(jù)操作232.10.1列求和232.10.2數(shù)據(jù)格式263圖表制作263.1餅狀圖263.2折線圖323.3柱狀圖383.4圖表效果展示42此文檔為本人結(jié)合網(wǎng)上資料與本人BIRT開發(fā)經(jīng)驗整理的BIRT詳細(xì)的開發(fā)手冊，適用于初學(xué)者快速掌握BIRT開發(fā)。1 BIRT開發(fā)環(huán)境BIRT開發(fā)環(huán)境是帶有BIRT插件的eclipse1.1 新建Project菜單欄fileànewàother選擇report projectànex，然后給project取名，完成后點擊finish即可完成新建project新建完成后的project1.2

3、 新建Report在新建的項目上右鍵newàorher , Reportànext, file name為報表名稱是以”. rptdesign”為結(jié)尾的文件，點擊finsh即可完成新建Report.1.3 調(diào)整工作窗口菜單WindowàShow ViewàotheràReport Design 調(diào)出Data Explorer窗口菜單WindowàShow ViewàotheràReport Design 調(diào)出Property Editor窗口調(diào)出這兩個窗口方便報表開發(fā)。拖動顯示的窗口，調(diào)整如下的布局，方便報表開發(fā)2

4、 BIRT報表開發(fā)2.1 新建數(shù)據(jù)源(Data Sources)在Data Explorer中的 Data Sources 右鍵New Data Source數(shù)據(jù)源類型選擇 JDBC Data Source, Data Source Name為數(shù)據(jù)源名稱Next之后如圖3-1Driver Class在下拉框中選擇數(shù)據(jù)庫驅(qū)動com.ibm.db2.jcc.DB2Driver(v3.50)Driver URL 配置數(shù)據(jù)庫連接地址User Name 與 Password 數(shù)據(jù)庫連接的用戶名密碼,設(shè)置完成后點擊Test connection 測試連接顯示connect successful則數(shù)據(jù)源配置

5、完成圖3-1在Driver Class中找不到對應(yīng)數(shù)據(jù)庫驅(qū)動則可以手動添加驅(qū)動點擊Manage Drivers可以添加其他數(shù)據(jù)庫驅(qū)動如oracle，點擊add添加oracle數(shù)據(jù)驅(qū)動包即可2.2 新建數(shù)據(jù)集(Data Set)在Data Explorer中的Data Set 右鍵New Data Set設(shè)置好Data Set Name后Netx報表sql,如果報表需要添加條件則在sql后加入 where 1=1,在條件處理是script腳本要用到。Sql完成后在完成data set前預(yù)覽sql(Preview Results),數(shù)據(jù)查看sql是否有問題,然后OK,Data Set 設(shè)置完成.2

6、.3 BIRT報表條件在Data Explorer中的Report Parametersànew Parameter2.3.1 一般條件Name:條件名字(英文字母)，Prompt text:條件提示名字Is Required:條件是否必填，Hidden:隱藏條件，Default vale:默認(rèn)值2.3.2 日期條件日期條件設(shè)置時在Prompt text中對日期條件進行設(shè)置yyyyMMdd日期格式為8位字符串型(如:20151012),yyyy-MM-dd為10位字符串型(如:2015-10-12)2.3.3 條件腳本點擊Data Set下的數(shù)據(jù)集,然后選中Script頁面Scrip

7、t選中beforeOpen在此區(qū)域中編寫腳本if( params"DEPT_NAME" && !params"DEPT_NAME".value.equals("") this.queryText = this.queryText+" and DEPT_NAME='"+params"DEPT_NAME".value+"'"if ( params"DATA_DT" && !params"DATA_DT&

8、quot;.value.equals("") this.queryText = this.queryText.replace("1=1","1=1 AND DATA_DT = '"+params"DATA_DT".value+"'"); 兩種腳本的不同:第一種為在where 1=1后沒有其他sql語句的可直接在1=1后拼接and DEPT_NAME=值 SELECT DEPT_NO,DEOT_NAME,SIGN_ACCT_CNT,SIGN_CUST_CNT,DATA_D

9、T 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 DATA_DT2.4 BIRT表格2.4.1 Insert

10、table插入table在Layout空白處右鍵InsertàTableInsert Table 設(shè)置table的列(Number of columans),Number of details一般不用設(shè)置,然后OK,在Layout中即可顯示插入的table.Table中Header Row為表頭,Detail Row為對應(yīng)表頭的數(shù)據(jù)集,Footer Row未用到2.4.2 設(shè)置報表表頭在table第一行個表格中點擊后右鍵InsertàLabel插入文本框輸入表頭報表表頭設(shè)置也可以才3.2添加數(shù)據(jù)集sql時將sql字段取一個中文別名，如下形式select a.user_cod

11、e 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 狀態(tài)from portal.portal_sys_user a按這種方式寫sql在配置表格數(shù)據(jù)時直接拖拽置Detail Row2.4.3 表頭樣式選中表頭在Property Editor中General設(shè)置表頭的樣式,包含background color,font,size,colo

12、r等2.4.4 表格網(wǎng)絡(luò)線點擊table的左上角區(qū)域選中整個table然后在Property Editor中的Border中設(shè)置網(wǎng)格線(點擊table的左上角區(qū)設(shè)置網(wǎng)格線為整個表格都設(shè)置,選中Table設(shè)置網(wǎng)格線則只設(shè)置外邊框)。2.5 綁定數(shù)據(jù)集在Data Set中的數(shù)據(jù)集將對應(yīng)表頭的字段直接拖拽到Detail Row的對應(yīng)位置2.6 表格數(shù)據(jù)添加分組(分組可以不用設(shè)根據(jù)需求添加)選中要分組的 Detail Row 然后右鍵 insert Group刪除多余行刪除完多余行后合并分組2.7 報表標(biāo)題(Master Page)Master Page為報表的標(biāo)題,Border中網(wǎng)格線的方法與tab

13、le中類似可參考table中網(wǎng)格線的設(shè)置,General中設(shè)置報表標(biāo)題顏色、大小、布局方式等2.8 固定布局與自由布局在Layout的General中的Layout Preference中有兩種布局方式:Auto Layout為自由布局選中自由布局報表會根據(jù)窗口大小自動調(diào)整,Fixed Layout為固定布局,布局固定不會根據(jù)窗口大小變動一般將報表設(shè)置為自由布局的格式當(dāng)報表所需列較多時一般將報表都設(shè)置成自由布局，在設(shè)置自由布局時要指定列寬否則列寬會自由調(diào)整，報表數(shù)據(jù)會出現(xiàn)擠在一起的情況。選中表格的列然后在Property Editor下的General中設(shè)置Width注：在列較多時在設(shè)置列寬時

14、預(yù)覽不明顯或者沒變化時，可以將報表布局設(shè)置為固定布局，一列一列調(diào)整列寬，調(diào)整完畢后將布局調(diào)整為自由布局，調(diào)整后將表格稍微拉寬一點即可。有時由于列較多，在調(diào)為固定布局后設(shè)置列寬到后邊的列會擠在一起，無法調(diào)整，可以暫時將布局調(diào)整為自由布局，進行設(shè)置列寬。調(diào)整后仍需將表格稍微拉寬一點。將鼠標(biāo)放置表格邊緣區(qū)域即可進行拖動(一般情況下不進行拖動只有在調(diào)整布局設(shè)置列寬后進行拖動)2.9 報表預(yù)覽點擊View Report in web Viewer預(yù)覽完成的報表報表預(yù)覽時有時會出現(xiàn)空白頁面不出現(xiàn)結(jié)果，產(chǎn)生原因一般是電腦自身環(huán)境原因，暫無解決辦法，View Report in web Viewer不能預(yù)覽時

15、可以用其他的預(yù)覽方式，如 View Report as HTML，或者換一個開發(fā)環(huán)境試試。點擊運行報表可以輸入報表條件2.10 數(shù)據(jù)操作2.10.1 列求和選中第一行即表頭然后右鍵InsertàRowàBelow 即可在表頭的下邊重新插入一行Header Row(如果選中的二行進行插入怎會生成一行Detail Row)在剛插入的Header Row中進行求和計算，選中相應(yīng)的表格右鍵InsertàAggregation在Aggregation Builder中進行編輯，Display Name 為創(chuàng)建Aggregation Builder的名字，data Type為

16、數(shù)據(jù)類型可根據(jù)需求在下拉框中選擇，F(xiàn)unction 為函數(shù)選擇需要的求和函數(shù)，Expression為求和的列注：Function中有多種函數(shù)可根據(jù)報表需求進行選擇是求和還是做其他操作Expression:點擊 2.10.2 數(shù)據(jù)格式在有金額列時保留小數(shù)點操作選中要控制小數(shù)的數(shù)據(jù)集在Property EditoràFormat Number中進行設(shè)置Format at中選擇所要的數(shù)據(jù)格式：Unformatted 無格式 General Number 常規(guī) Currency 貨幣Fixed 固定 Scientific 科學(xué)計數(shù)Decimal places 保留小數(shù)的位數(shù)在貨幣格式下Cur

17、rency 中有 symbol 可以根據(jù)需要選擇幣種符號3 圖表制作注：BIRT圖形加日期條件時注意日期格式，餅狀圖只支持date類型的日期格式不支持8位字符串，所以才配置數(shù)據(jù)集的時候要修改日期格式。例：(select to_date(data_dt,'yyyy-mm-dd') as DATA_DT,BAL,PRODUCT from s411_bsd_birt.line ) 這條sqlIBM官方圖表教程視頻地址： 3.1 餅狀圖首先配置好數(shù)據(jù)源、數(shù)據(jù)集。將面板中的圖表 拖到設(shè)計頁面中的適當(dāng)位置(或者右鍵insert選擇chart)，選擇圖表類型為餅圖，3D效果可以選擇 ，圖片格

18、式也可以選擇（一般默認(rèn)即可）。如下圖點擊下一步，進入數(shù)據(jù)選擇階段。選擇數(shù)據(jù)集，然后設(shè)置“Category Definition”和“Slice Size Definition”，點擊“Category Definition”后的圖標(biāo)，進入分組和排序窗口，將分組中“Enabled”的勾去掉，如圖圖中的按日期統(tǒng)計顯示為一年的，點擊“Category Definition”后的圖標(biāo)在unit中可以選擇datetime的類型是按天周或者月等進行統(tǒng)計選擇按天統(tǒng)計后：若想餅圖中的組成部分有一定的間距，可在圖表格式“Format Chart”頁面左邊的樹中選擇“Value Series”，在“By Distance”項中設(shè)置間距。如圖：設(shè)置餅狀圖的title暫時未用到分組的可以將其隱藏Labels可以設(shè)置數(shù)據(jù)顯示的格式fomat 下的position:下框中選擇outside數(shù)據(jù)在外部，選擇inside數(shù)據(jù)在餅狀圖中3.2 折線圖線圖和餅圖類似，先配置好數(shù)據(jù)源、數(shù)據(jù)集，然后選擇圖表類型為拆線圖。然后配置橫軸（X軸）和縱軸（Y軸）。若有多項需要比較，可在配置Y軸時選擇“< New Series>”創(chuàng)建多條項目，并指定數(shù)據(jù)項。如圖：折線 例：折線折點顯示數(shù)值設(shè)置X軸顯示風(fēng)格設(shè)置Y