【文章內(nèi)容簡介】 數(shù)據(jù)集（Data Set）中。 數(shù)據(jù)集參數(shù)使用的時候通常需要鏈接某個報表參數(shù)或者利用綁定表（binding tab）和一個嵌套表中的某個數(shù)據(jù)元素綁定，也就是說它一般不單獨成為一個可以實際應(yīng)用的參數(shù)（但是它可以設(shè)置一個默認(rèn)參數(shù)）。 標(biāo)量參數(shù)標(biāo)量參數(shù)是Birt報表中最簡單也是最基本的一類參數(shù)，標(biāo)量參數(shù)可以分為靜態(tài)標(biāo)量參數(shù)和動態(tài)標(biāo)量參數(shù)兩種。靜態(tài)參數(shù)是從用戶界面獲得用戶手工輸入的數(shù)據(jù)值，報表根據(jù)該參數(shù)生成相應(yīng)內(nèi)容；動態(tài)參數(shù)主要指的是在人機交互的界面中，使用人從指定數(shù)據(jù)集中選擇條件，同時在報表中展示的數(shù)據(jù)是根據(jù)使用人所傳遞的參數(shù)所查詢出來的內(nèi)容。這樣能夠為使用人提供一個可選范圍，方便的選擇。兩種參數(shù)分別適應(yīng)不同的情況，下面分別介紹這兩種參數(shù)。 靜態(tài)標(biāo)量參數(shù)，彈出新建報表參數(shù)對話框，如圖44：圖44輸入相應(yīng)的值，在值列表項中默認(rèn)為靜態(tài)的，若選擇其下的組合框、列表框時會變?yōu)榭蛇x的。默認(rèn)值可以輸入也可不輸。， Where條件中的ID字段通過”?”代表的參數(shù)傳入?yún)?shù)值，如圖45：圖45點擊”參數(shù)”，彈出在數(shù)據(jù)集中定義參數(shù)的對話框。 數(shù)據(jù)集中的參數(shù)需要鏈接至某一個報表參數(shù)。 在本例中將數(shù)據(jù)集參數(shù)鏈接至前面定義的報表參數(shù)ID。 點擊OK，我們就完成了數(shù)據(jù)集中參數(shù)的定義。當(dāng)報表運行時，Birt會使用由報表參數(shù)ID傳入的值填充where條件，生成結(jié)果數(shù)據(jù)集。如圖46：圖46其中參數(shù)名稱可以隨意，選好字段對應(yīng)的數(shù)據(jù)類型，方向一般為輸入，默認(rèn)值即為where條件后“？”代表的默認(rèn)值。若選擇鏈接到報表參數(shù)下拉框中的報表參數(shù)，擇輸入的默認(rèn)值失效。當(dāng)展現(xiàn)預(yù)覽報表時會彈出報表參數(shù)輸入框，如圖47：圖47輸入?yún)?shù)點擊確定即可展現(xiàn)對應(yīng)的報表。 動態(tài)標(biāo)量參數(shù)動態(tài)參數(shù)可以提供一個數(shù)據(jù)值的列表供用戶選擇，這種功能能夠極大增強報表設(shè)計用戶界面的交互性。在此，我們首先定義一個數(shù)據(jù)集，這個數(shù)據(jù)集不使用參數(shù)，它從表中查詢出所有的ID號，為報表參數(shù)提供一個數(shù)據(jù)值的列表。在新建參數(shù)中的顯示類型中選擇“組合框”，值列表中選擇“動態(tài)”選擇對應(yīng)的數(shù)據(jù)集和值列。如圖48圖48將本數(shù)據(jù)集的參數(shù)ID鏈接至ID，就完成藉由一個報表參數(shù)為中介將一個數(shù)據(jù)集的字段值鏈接到另一個數(shù)據(jù)集的參數(shù)的功能。預(yù)覽如圖49：圖49 級聯(lián)參數(shù)除了使用動態(tài)報表參數(shù)提供數(shù)據(jù)值的選擇列表，報表開發(fā)過程中用戶經(jīng)常需要用到互相關(guān)聯(lián)的參數(shù)。 比如要選擇某個客戶的某個訂單號標(biāo)識的所有訂單的內(nèi)容，用戶并不愿意列出所有可能的訂單號，比較理想的情況是給出一個客戶編號的選擇列表，根據(jù)這個列表的內(nèi)容再給出每個客戶的所有訂單號的列表，這樣用戶就可以選擇相應(yīng)的客戶對應(yīng)的某個訂單號，從而查詢出此客戶的這個訂單號標(biāo)識的所有訂單的詳細(xì)內(nèi)容。 級聯(lián)參數(shù) 一方面增強了報表邏輯的功能；另一方面，通過將一部分應(yīng)用邏輯轉(zhuǎn)移到界面操作上，進一步降低了報表內(nèi)部邏輯和SQL查詢語句的復(fù)雜性。 首先定義一個customer數(shù)據(jù)集，這個數(shù)據(jù)集 包含cus_id和cus_name兩個字段，如圖50：圖50接著定義一個名為oraders的數(shù)據(jù)集，如圖51圖51在“Orders”數(shù)據(jù)集中使用一個數(shù)據(jù)集參數(shù)，這個數(shù)據(jù)集參數(shù)將要引用接下來將要定義的層疊參數(shù)中customer參數(shù)。 定義了以上數(shù)據(jù)集之后，就可以來定義級聯(lián)參數(shù)了。右鍵點擊數(shù)據(jù)資源管理器面板中的報表參數(shù)選項，在彈出的上下文菜單中點擊“新建級聯(lián)參數(shù)”，彈出以下對話框，在級聯(lián)參數(shù)名稱稱域輸入?yún)?shù)的名字，本例中使用的參數(shù)名字為“custorder”，數(shù)據(jù)集模型選擇為多個數(shù)據(jù)集。 在緊接著的參數(shù)表中定義一個名為customer的參數(shù)，并將其關(guān)聯(lián)至customer這個數(shù)據(jù)集，其取值為customer數(shù)據(jù)集中的cus_id字段，這樣customer這個級聯(lián)參數(shù)的取值就是一個cus_id的列表。 Customer此時也成為一個動態(tài)參數(shù)。 參數(shù)組關(guān)于這個參數(shù)組，主要是bird考慮到在創(chuàng)建報表的時候需要提供大量的參數(shù)，為了在界面上更加有效地對這些參數(shù)進行組織，便提供了參數(shù)組的功能。 用戶可以使用參數(shù)組將相關(guān)的參數(shù)組織在一起，就是說將功能相關(guān)的參數(shù)放在一個組里面，便于查找，修改等管理操作。對于其具體操作方法：1. 創(chuàng)建一個參數(shù)值。在數(shù)據(jù)管理器視圖中用鼠標(biāo)右鍵點擊報表參數(shù)新建參數(shù)組，如圖52:圖522. 創(chuàng)建完參數(shù)組后便可以為其創(chuàng)建參數(shù)。3. 設(shè)置與操作參數(shù)組(parameter group)，主要有兩個方法：一種方式是用鼠標(biāo)右鍵點擊參數(shù)組標(biāo)簽并選擇new parameter創(chuàng)建新的parameter；另一種方式是將已有的參數(shù)添加入?yún)?shù)組，只需要使用鼠標(biāo)將所需要的參數(shù)拖拽入?yún)?shù)組中。 展示設(shè)計好的報表首先需要下載BIRT 報表的運行環(huán)境包，如果需要輸出PDF 格式， 支持包，；如果輸出PDF 要顯示亞洲語言， 支持包。 Web容器生成方式 1. 將其復(fù)制到%TOMCAT%\webapps 目錄下，并將其更改名稱為birtServer；2. 如需生成PDF 格式，在birtServer\WEBINF\platform\plugins\目錄下新建文件夾lib, 拷入其中；3. 把所使用的數(shù)據(jù)庫的JDBC 驅(qū)動jar 包復(fù)制到birtServer\WEBINF\platform\plugins\（后跟版本號）\drivers 目錄下；4. 將設(shè)計好的報表， 放到BirtServer 的根目錄下，然后啟動TOMCAT，即可通過://localhost:8080/birtServer/frameset?__report= (相對路徑)或者://localhost:8080/birtServer/frameset?__report=C:/ (絕對路徑)來訪問。如果要生成pdf 文件，如下：://localhost:8080/birtServer/frameset?__report=amp。__format=pdf如果報表有輸入?yún)?shù)，只需在上述url 后拼接參數(shù)及值即可，如下：://localhost:8080/birtServer/frameset?__report=amp。name=whjamp。date=2007613；5. 如果需要和現(xiàn)有WEB 項目集成，可直接把WebViewerExample 目錄下所有文件及文件夾復(fù)制到現(xiàn)有項目的WebRoot 下部署運行即可。 調(diào)用相關(guān)動作及運行參數(shù)說明1. frameset 使用BIRT Report Viewer 瀏覽，提供帶分頁顯示、導(dǎo)出數(shù)據(jù)到csv 功能、pdf 打印功能的導(dǎo)航條，加__format=pdf 參數(shù)后可生成PDF2. run 不帶工具條，html 顯示3. 可用參數(shù)列表參數(shù)名參數(shù)說明參數(shù)值默認(rèn)值__format指定報表輸出格式html 或 pdfhtml__isnull指明一個參數(shù)是null，常用于字符串類型。如果提供參數(shù)且值為空： 對于日期和數(shù)字類型，BIRT會將它們當(dāng)作null 處理。 對于字符串，BIRT 會將它作為空字符串。因此，為了說明某個字符串是null，通常寫為__isnull=報表輸入?yún)?shù)名None. Required.__locale本地化選項enus 或 chzh虛擬機默認(rèn)__report指定 *.rptdesign 文件路徑None. Required.報表輸入?yún)?shù)名報表參數(shù)參數(shù)值對，形式：參數(shù)名=參數(shù)值。對于frameset，直接在地址欄中輸入?yún)?shù)名=參數(shù)值后回車，不會影響報表結(jié)果。雖然，此時選擇運行報表時，彈出的參數(shù)值已經(jīng)改變。具體的輸入?yún)?shù)值在設(shè)計報表時指定__svg 指定是否使用SVG 矢量圖來顯示圖表。SVG 矢量圖形是一種XML格式的文本文件，在IE 下需要安裝Adodb SVG Viewer 插件才能瀏覽。true 或 false安裝插件后瀏覽時frameset 下默認(rèn)true，run 下默認(rèn)false；不安裝插件時默認(rèn)為false 使用birt提供的ReportEngine Api來調(diào)用報表并展現(xiàn)1. 新建web 項目webrpt；2. 將birtruntime2_1_2\ReportEngine\lib 下的所有文件拷入WebRoot 下的WEBINF\lib；3. 在WEBINF 目錄中新建文件夾platform,\ReportEngin下的plugins和configuration拷入其中。3. 如需要PDF 格式及其亞洲語言支持， 和 拷入platform\plugins\ 文件夾的lib 目錄中；5. 把所使用的數(shù)據(jù)庫的JDBC 驅(qū)動jar 包復(fù)制到platform\plugins\（后跟版本號）\drivers 目錄下；6. 在webrpt 的WebRoot 目錄下新建Reports 和images 文件夾。其中Reports 文件夾中放置已設(shè)