Birt報表設計步驟:
1、下載birt all in one 2.2.1.1,包含eclipse,解開(kāi)下載文件
啟動(dòng)eclipse,必須使用JDK1.5啟動(dòng)eclipse,否則新建工程對話(huà)框中沒(méi)有birt的相關(guān)選項
2、新建report project和report
打開(kāi)data explorer視圖,新建一個(gè)data sources,定義數據庫連接driver/url/用戶(hù)名/密碼,在"Manage Drivers..."中把jdbc的jar加進(jìn)來(lái)
3、新建Report Parameter,設置參數名稱(chēng)、類(lèi)型,參數值將來(lái)通過(guò)url傳遞或使用程序方式賦值
4、新建data sets,設置Query,即preparedStatement語(yǔ)句,設置dataset的Pameters,即reparedStatement中的“?”,使之和report parameter關(guān)聯(lián); 如果dataset的Parameter的值不是來(lái)自于Report Parameter,例如來(lái)自另外一個(gè)dataset, 可不設置關(guān)聯(lián),而在報表內容中設置和其它data set字段的關(guān)聯(lián)(見(jiàn)步驟8)
5、如果data set對應的sql是動(dòng)態(tài)生成的,可以設置“property Binding”,在Query Text中輸入sql和表達式,其中可以使用Report Parameter和javascript語(yǔ)句,運行時(shí)將執行Property Binding中的Query Text,而不執行Query中的preparedStatement,但是Query中的preparedStatement在設計報表時(shí)還是有用的,因為可以看到運行結果的字段列表,只要preparedStatement和Query Text返回相同的字段即可
6、將定義好的data set拖動(dòng)到設計界面上,會(huì )自動(dòng)在報表放置一個(gè)Table
7、如要對table的某列合計,從Palette視圖中拖一個(gè)“Aggregation”到設計界面
8、如要Master-Sleve報表,則在Table中再放置一個(gè)Table。例如一個(gè)dataset是客戶(hù)基本信息,每個(gè)客戶(hù)一條記錄,另一個(gè)data set是客戶(hù)交易明細,每個(gè)客戶(hù)可能有多條記錄,則先將客戶(hù)基本信息的dataset拖置設計界面,會(huì )自動(dòng)放置一個(gè)Table,然后將客戶(hù)交易明細的dataset拖置前一個(gè)Table中適當位置,即生成一個(gè)Table中的Table。選中交易明細的Table,打開(kāi)PropertyEditor視圖,在binding欄中,選擇交易明細的data set,按“Dataset ParameterBinding...”,選擇“CUST_ID"字段,將其和客戶(hù)基本信息data set的CUST_ID關(guān)聯(lián)起來(lái)(row["CUST_ID"])
9、按需要調整報表的樣式,從eclipse工具欄中選擇“view report in web viewer”,如果設置了Report Parameter,會(huì )出現一個(gè)對話(huà)框,要求輸入Report Parameter的值,按確定后生成報表內容
10、在webviewer中,鼠標右建點(diǎn)按生成的報表,選“屬性”,獲取url,開(kāi)一個(gè)空白IE,復制url到地址欄,在url最后用“&參數名=參數值”方式,把ReportParameter加進(jìn)url,按回車(chē),直接出現報表結果,不再出現報表參數輸入對話(huà)框。還可以pdf/doc/html等格式預覽生成的報表
Birt報表部署步驟:
部署設計好的報表很簡(jiǎn)單,只需要下載Birt runtime,將Birtruntime部署為一個(gè)web應用,報表設計文件復制到該應用的根目錄即可。為方便起見(jiàn),以下將Birtruntime部屬為一個(gè)獨立的應用,當然也可以將Birt runtime整合到你的web應用中
1、下載birt runtime 2.2.1.1,解開(kāi)下載文件
2、將birt rumtime解開(kāi)后的目錄下的部署為一個(gè)web應用,使用JDK1.4.2或以上版本
3、將報表設計步驟中生成的設計文件(*.retdesing文件)復制到web應用所在目錄
4、確保以下文件在WEB-INF/lib目錄下存在,如果沒(méi)有,從all in one中搜索復制過(guò)來(lái)
com.ibm.icu_3.6.1.v20070906.jar
coreapi.jar
engineapi.jar
scriptapi.jar
5、將jdbc的jar或zip文件復制到WEB-INF\platform\plugins\org.eclipse.birt.report.data.oda.jdbc_2.2.1.r22x_v20070919\drivers目錄下
6、刪除WEB-INF\platform\org.eclipse.birt.report.data.oda.sampledb_2.2.1.r22x_v20070919目錄(示例數據庫,沒(méi)什么用處),否則生成報表時(shí)有不必要的警告信息出現
7、啟動(dòng)web server,修改設計步驟第10步獲得的url,使IP/端口/web應用名稱(chēng)符合你的Birt runtime部署,在IE中可以查看報表內容
使用Birt提供API以程序方式生成報表結果,例如生成PDF格式的報表結果,代碼片段如下:
- import java.util.HashMap;
- import java.util.logging.Level;
-
- import java.io.OutputStream;
- import java.io.FileOutputStream;
- import java.io.ByteArrayOutputStream;
-
- import org.eclipse.birt.core.framework.Platform;
- import org.eclipse.birt.report.engine.api.EngineConfig;
- import org.eclipse.birt.report.engine.api.EngineConstants;
- import org.eclipse.birt.report.engine.api.EngineException;
- import org.eclipse.birt.report.engine.api.IReportEngine;
- import org.eclipse.birt.report.engine.api.IReportEngineFactory;
- import org.eclipse.birt.report.engine.api.IReportRunnable;
- import org.eclipse.birt.report.engine.api.IRunAndRenderTask;
- import org.eclipse.birt.report.engine.api.PDFRenderOption;
-
- public class PDFReportServiceAccess
- {
-
- protected static boolean initStatus = false;
-
- private static IReportEngine engine = null;
-
- private static EngineConfig config = null;
-
- private static IReportRunnable design = null;
-
- private static PDFRenderOption ro = null;
-
-
- public void initilize()
- {
- if ( initStatus == true )
- return;
-
- try
- {
- config = new EngineConfig();
- config.setEngineHome( "C:/projects/birt/WEB-INF/platform" );
- config.setLogConfig( "C:/projects/birt/logs", Level.FINE );
-
- Platform.startup( config );
- IReportEngineFactory factory = ( IReportEngineFactory ) Platform
- .createFactoryObject( IReportEngineFactory.EXTENSION_REPORT_ENGINE_FACTORY );
- engine = factory.createReportEngine( config );
- engine.changeLogLevel( Level.WARNING );
-
- ro = new PDFRenderOption();
-
- config.getEmitterConfigs().put( "pdf", ro );
-
- initStatus = true;
-
- }
- catch ( Exception ex )
- {
- ex.printStackTrace();
- initStatus = false;
- }
- }
-
-
- public void release()
- {
- engine.shutdown();
- Platform.shutdown();
-
- initStatus = false;
- }
-
- protected OutputStream run( String filename, HashMap parameters ) throws EngineException
- {
- design = engine.openReportDesign( filename );
-
-
- IRunAndRenderTask task = engine.createRunAndRenderTask( design );
- HashMap contextMap = new HashMap();
- contextMap.put( EngineConstants.APPCONTEXT_PDF_RENDER_CONTEXT, ro );
- task.setAppContext( contextMap );
- task.setParameterValues( parameters );
- task.validateParameters();
-
- OutputStream os = new ByteArrayOutputStream();
- ro.setOutputStream( os );
- ro.setOutputFormat( "pdf" );
- task.setRenderOption( ro );
-
- task.run();
- task.close();
-
- return os;
- }
-
-
-
-
-
-
-
-
-
-
- public OutputStream call( String filename, HashMap parameters ) throws EngineException
- {
- initilize();
- OutputStream os = run( filename, parameters );
- release();
-
- return os;
- }
-
-
-
-
- public static void main( String[] args )
- {
- HashMap parameters = new HashMap();
-
- parameters.put( "begindate", "2004/01/01" );
- parameters.put( "enddate", "2007/12/31" );
- parameters.put( "sql", " where cust_id = 1234567" );
-
- ByteArrayOutputStream bos = null;
-
- PDFReportServiceAccess ebr = new PDFReportServiceAccess();
-
- String filename = "C:/projects/birt/batch_report.rptdesign";
- try
- {
- bos = ( ByteArrayOutputStream ) ebr.call( filename, parameters );
- OutputStream fis = new FileOutputStream( "c:/test.pdf" );
- bos.writeTo( fis );
- }
- catch ( Exception e )
- {
- e.printStackTrace();
- }
- }
-
- }