詩(shī)特林-sterning

Eclipse BIRT使用之BIRT Designer篇

在開(kāi)源的報(bào)表工具中，Eclipse的BIRT（Business Intelligence and Reporting Tools ，簡(jiǎn)稱(chēng)BIRT）應(yīng)該是很重要的一種。BIRT基于Eclipse IDE開(kāi)發(fā)，可以為Java/J2EE應(yīng)用提供良好的圖形及報(bào)表。該報(bào)表工具主要包括以下幾大塊組成：

l         BIRT Designer：用于進(jìn)行報(bào)表的設(shè)計(jì)，因?yàn)橐猿鰣?bào)表之前，第一步需的做的就是設(shè)計(jì)模板，幾乎所有的報(bào)表工具都采用這樣的模式，如著名的JasperReports就有專(zhuān)門(mén)的iReports來(lái)進(jìn)行報(bào)表設(shè)計(jì)。

l         Web Viewer：在頁(yè)面上展現(xiàn)報(bào)表的工具，提供了大量的JSP標(biāo)簽庫(kù)，方便將BIRT報(bào)表集成到J2EE項(xiàng)目中去。

l         BIRT Charting包：用于構(gòu)建成熟的圖表，因?yàn)樵趫?bào)表里如果能添加上圖表的話(huà)，則可以達(dá)到圖文并茂的效果。而BIRT Charting包正提供了這樣的功能。

BIRT項(xiàng)目最初是2005年夏季發(fā)布，如今其下載量已過(guò)百萬(wàn)，充分的說(shuō)明了其受歡迎的程度。可以訪問(wèn)BIRT的官方網(wǎng)站：http://www.eclipse.org/birt，這里有關(guān)于BIRT的介紹、教程、下載包、示例等等。

圖1 Eclipse BIRT報(bào)表

一、        BIRT Designer

BIRT的核心就在于BIRT Designer，該設(shè)計(jì)器使用Eclipse插件功能，可以使設(shè)計(jì)過(guò)程通過(guò)拖放控件進(jìn)行設(shè)計(jì)，達(dá)到所見(jiàn)即所得的效果。通過(guò)BIRT設(shè)計(jì)出來(lái)的報(bào)表文件，采用XML格式進(jìn)行保存。

圖2 BIRT Designer

在Eclipse BIRT設(shè)計(jì)器中，提供了多種視圖，以方便進(jìn)行模板文件的設(shè)計(jì)。各種設(shè)計(jì)視圖如下：

1．Report Editor：

Report Editor提供了報(bào)表設(shè)計(jì)的畫(huà)板，可以擺放設(shè)計(jì)元素并將其格式化。包括布局的表格、主頁(yè)面、腳本、XML 文件源及預(yù)覽。

l         布局表格：用于對(duì)整個(gè)報(bào)表界面進(jìn)行整體布局，框架性的組件，支持拖放功能；

l         主頁(yè)面：用于設(shè)置模板文件的共用屬性，如報(bào)表文件的頭、尾、背景圖片等；

l         腳本：支持對(duì)JavaScript腳本的編輯，BIRT支持事件模型，因此可以使用Java或JavaScript來(lái)編寫(xiě)事件處理器，事件處理器存在于報(bào)表的生成及渲染過(guò)程，可以用于修改報(bào)表的屬性、字體顏色、數(shù)據(jù)值或調(diào)用外部代碼；

l         XML 文件源：用于查看報(bào)表模板中所用于的XML代碼，可以在這里進(jìn)行XML內(nèi)容的查看或編輯。

l         預(yù)覽：把報(bào)表模板快速的渲染成為HTML格式文件進(jìn)行預(yù)覽。如下圖所示：

圖3 報(bào)表預(yù)覽

2．Data Explorer

在進(jìn)行報(bào)表設(shè)計(jì)之前，設(shè)置好數(shù)據(jù)庫(kù)連接通常是必須的。為了方便進(jìn)行數(shù)據(jù)庫(kù)的連接設(shè)置，BIRT提供了Data Explorer視圖。

圖4 BIRT Data Explorer

這種視圖下可以允許為報(bào)表添加數(shù)據(jù)源及數(shù)據(jù)集。當(dāng)然這里的數(shù)據(jù)源指是的數(shù)據(jù)庫(kù)連接。BIRT提供了對(duì)JDBC、XML、腳本數(shù)據(jù)源等等的支持。隨著BIRT 2.2的發(fā)布，將支持Web Service數(shù)據(jù)源、CSV、TSV、SSV及PSV等數(shù)據(jù)源。

而數(shù)據(jù)集可以理解為已經(jīng)被執(zhí)行的查詢(xún)語(yǔ)句并返回的記錄集。BIRT提供了一種特殊的數(shù)據(jù)集：Joint Data Set（簡(jiǎn)稱(chēng)聯(lián)合數(shù)據(jù)集）。它可以對(duì)現(xiàn)在的數(shù)據(jù)集進(jìn)行內(nèi)連接或是外連接。當(dāng)使用不同的數(shù)據(jù)源的，這種功能非常的實(shí)用。

Data Explorer還可以用于添加報(bào)表參數(shù)及數(shù)據(jù)立方體。報(bào)表參數(shù)是暴露給報(bào)表模板使用人員的參數(shù)，參數(shù)傳遞相關(guān)參數(shù)值，可以個(gè)性化報(bào)表。例如，可以使用數(shù)據(jù)集參數(shù)來(lái)修改查詢(xún)語(yǔ)句，或使用BIRT JavaScript表達(dá)式來(lái)改變報(bào)表元素的樣式及可見(jiàn)性。

報(bào)表參數(shù)可以是靜態(tài)的，也可以是動(dòng)態(tài)的。靜態(tài)參數(shù)是指用戶(hù)可以從預(yù)先定義好的參數(shù)值可選取值，進(jìn)行相關(guān)的展示或運(yùn)算，最簡(jiǎn)單就是文本框中的靜態(tài)內(nèi)容。動(dòng)態(tài)參數(shù)一般指在綁定到BIRT數(shù)據(jù)集，而用戶(hù)可以從中選取某些需要的數(shù)據(jù)或記錄。

在BIRT2.2中，動(dòng)態(tài)報(bào)表參數(shù)支持使用JavaScript表態(tài)式來(lái)動(dòng)態(tài)顯示文本或參數(shù)值。這樣即可以動(dòng)態(tài)的顯示最終用戶(hù)所傳遞的參數(shù)值。

此外，BIRT還支持聯(lián)動(dòng)報(bào)表參數(shù)。可以設(shè)置二級(jí)或是三級(jí)的聯(lián)動(dòng)下拉框或是List。最明顯的例子如下圖所示：

圖5 BIRT聯(lián)動(dòng)報(bào)表參數(shù)

在Data Explorer視圖中可以創(chuàng)建數(shù)據(jù)立方體。這是BIRT2.2的新特性，可以與BIRT中的交叉報(bào)表結(jié)合使用。BIRT數(shù)據(jù)立方體是多維的，可以基于多個(gè)數(shù)據(jù)集，如下圖所示：

圖6  BIRT數(shù)據(jù)立方體

除了上面的特性外，BIRT還新增了兩種用于支持其它數(shù)據(jù)源的項(xiàng)目類(lèi)型。這類(lèi)數(shù)據(jù)源基于Eclipse的DTP（Data Tools Platform）項(xiàng)目所提供的ODA（Open Data Access）框架

圖7  BIRT中ODA設(shè)計(jì)工具

3．Palette

BIRT Palette視圖用于給報(bào)表畫(huà)板添加報(bào)表元素。這里的元素可以代表從Data Explorer視圖中所設(shè)計(jì)的數(shù)據(jù)。Palette中的元素支持自由的拖放功能，Palette上的元素屬性可以通過(guò)屬性編輯器進(jìn)行設(shè)計(jì)，也可以通過(guò)ROM（BIRT Reports Object Model）進(jìn)行描述。

圖8  BIRT的Palette視圖

Palette包括以下一些常用的元素：

l         Label：標(biāo)簽元素用于顯示靜態(tài)文本，標(biāo)簽元素的外觀可以通過(guò)本地進(jìn)行設(shè)置，如設(shè)置標(biāo)簽元素的超級(jí)連接、字體大小等屬性；

l         Text：文本元素與標(biāo)簽元素相似，只是文本元素可以顯示多行數(shù)據(jù)，更加易于格式輸出。可以在文本元素中使用腳本表達(dá)式，然后在客戶(hù)端使用標(biāo)簽進(jìn)行解析；

l         Dynamic Text：動(dòng)態(tài)文本元素通常用于顯示CLOB數(shù)據(jù)值。CLOB數(shù)據(jù)可以通過(guò)使用BIRT Expression Builder得到數(shù)據(jù)；

l         Data：數(shù)據(jù)元素用于顯示數(shù)據(jù)源的數(shù)據(jù)，通過(guò)使用Expression Builder來(lái)操作或改變數(shù)據(jù)值。例如，數(shù)據(jù)集有包含姓列以及名列，那么可以使用Expression Builder來(lái)將姓列與名列進(jìn)行合并，從而形成包含姓名的一列；

l         Image：圖片元素用于在報(bào)表模板中顯示圖片。BIRT支持通過(guò)URL獲得圖片，或是從數(shù)據(jù)庫(kù)的取得圖片（BLOB），或是從本地硬盤(pán)上獲得圖片；

l         Grid：網(wǎng)格元素用于布局報(bào)表中的報(bào)表元素，并進(jìn)行統(tǒng)一的管理。例如，想在報(bào)表中顯示產(chǎn)品銷(xiāo)售數(shù)據(jù)表格，同時(shí)又想在右邊顯示一張圖表，此時(shí)則需要使用Grid來(lái)進(jìn)行網(wǎng)格劃分，將報(bào)表分成一行兩列；

l         List：列表元素也相當(dāng)于一個(gè)容器，它不同于其它容器的地方在于列表元素可以綁定到數(shù)據(jù)集上。列表元素包含頭、腳及數(shù)據(jù)部分。當(dāng)渲染列表元素時(shí)，頭與腳部分一次性渲染完成，而中間的數(shù)據(jù)部分需要顯示數(shù)據(jù)集的每一行數(shù)據(jù)。數(shù)據(jù)格式可以是文本元素，也可以是表格、列表等元素；

l         Table：表格元素與列表元素相似，都可以用于顯示數(shù)據(jù)集中的數(shù)據(jù)。表格元素與HTML中的表格元素風(fēng)格相似；

l         Aggregation：匯總元素是BIRT 2.2新增的元素，使用Aggregation Builder向報(bào)表添加匯總功能。Aggregation Builder提供的匯總功能大概有25項(xiàng)，常見(jiàn)的如：SUM、MIN、MAX、AVERAGE等等；

圖9  BIRT的Aggregation元素

l         Chart：圖表元素用于在報(bào)表中添加圖表。當(dāng)在報(bào)表中添加了圖表元素時(shí)，Chart Builder Wizard自動(dòng)進(jìn)行渲染并顯示。Chart Builder Wizard用于設(shè)計(jì)圖形，并提供了三大設(shè)置區(qū)域，分別是：設(shè)置圖表類(lèi)型、設(shè)置數(shù)據(jù)、設(shè)置圖表格式。BIRT提供了大量的圖表類(lèi)型，同時(shí)，圖表格式可以是PNG、JPG、BMP、SVG等輸出格式。

l         Cross Tab：交叉報(bào)表元素用于顯示BIRT數(shù)據(jù)立方體中的數(shù)據(jù)。在BIRT以前的版本中，表格中列數(shù)據(jù)需要在設(shè)計(jì)時(shí)就確定，而使用交叉報(bào)表元素，則列數(shù)據(jù)與行數(shù)可以動(dòng)態(tài)生成，無(wú)需在報(bào)表設(shè)計(jì)時(shí)確定。

圖10  BIRT的Cross Tab元素

4．Library Explorer

Library Explorer支持從已存在的報(bào)表庫(kù)中拖放報(bào)表元素。因此，各種報(bào)表之間即可以共享一些公用的類(lèi)庫(kù)元素。同時(shí)，修改其中某一公用的類(lèi)庫(kù)元素，即可以修改所有的引用至此類(lèi)庫(kù)元素的所有報(bào)表。例如，可以在類(lèi)庫(kù)元素中保存公司的Logo，如果公司的Logo變化，則只需要修改類(lèi)庫(kù)的中Logo元素即可，其它引用此Logo的報(bào)表無(wú)需修改。

圖11  BIRT的Library Explorer視圖

5．Property Editor

Property Editor視圖用于設(shè)置報(bào)表中元素的屬性。當(dāng)然，每種元素的屬性都不盡相同，因此，其界面都有所變化。當(dāng)然也具有共用的一些屬性，如style、width、font等等。此外，大部分元素都支持是否可見(jiàn)的屬性。

圖12 BIRT的Property Editor視圖

6．Outline

Outline視圖通過(guò)層次關(guān)系來(lái)展現(xiàn)報(bào)表設(shè)計(jì)的內(nèi)容及其相關(guān)元素的層次關(guān)系。可以從Outline中直接選擇元素進(jìn)行查看或修改，當(dāng)報(bào)表設(shè)計(jì)比較復(fù)雜時(shí)，Outline是相關(guān)方便有用的輔助工具。

圖13  BIRT的Outline視圖

7． Miscellaneous

BIRT 2.2中提供了對(duì)同一組數(shù)據(jù)進(jìn)行多種視圖或表達(dá)的功能。例如，對(duì)同一組數(shù)據(jù)，可以使用報(bào)表展示，同時(shí)還可以進(jìn)行圖形的展示。

圖14  BIRT的Miscellaneous視圖