部署一個BIRT報告到你的應用伺服器自ECLIPSE中國社區)

 

最近使用BIRT作為自己項目中的報告產生工具，看到論壇上有很多朋友在部署時有問題。希望這篇文章對你有所協助，基本以BIRT1.0.1的開發人員文檔翻譯為主。2.0剛剛發布，還沒有使用過。

這裡主要介紹的是部署一個已經存在的BIRT報告，也就是說你已經設計好的.reptdesign檔案，本文並不介紹如何設計BIRT報告。

Deploying a BIRT report to an application server

這裡BIRT說明了目前版本沒有在高於JRE1.4的環境中測試過，如果你需要發布到JRE1.5的環境中，可能會有問題。以下內容使用TOMCAT為例

1.Placing the BIRT report viewer on the application server

拷貝ECLIPSE_INSTALL/plugins/org.eclipse.birt.report.viewer_1.0.1/birt到你的$TOMCAT_INSTALL/webapps，這個BIRT其實就是一個完整web應用，不需要再添加什麼JAR包了。你也可以通過在TOMCAT中指定目錄<Context />來添加，具體內容可以查看文檔。

2.Viewing a report using a browser

添加完birt的應用後，啟動你的TOMCAT，然後你就可以通過瀏覽器訪問BIRT。這裡有2種方式

http://localhost:8080/birt/run?parameter_list
http://localhost:8080/birt/frameset?parameter_list

    2.1 Understanding the run servlet

如果使用run servlet，BIRT會顯示一個單獨的Web頁面或者一個PDF檔案

    2.2 Understanding the frameset servlet

如果使用frameset servlet，BIRT將會顯示3個Frame，一個顯示輸入報告參數的表單，一個顯示報告，一個顯示導航條。

    2.3 Understanding the URL parameters

下表為servlet可以支援的參數，需要注意的是_frame參數僅對frame servlet有效，reportParam參數是指你自己的report中定義的參數。

Parameter	Values	Required/default
__report	path to report design file	Yes, no default
__format	html or pdf	Optional /default to html
__frame	true or false	Optional /default to true
__locale	locale	Optional /defaults to JVM locale
__navigation	hide or parameter	Optional /default to auto
__toolbar	true or false	Optional /default to true
__isnull	any user-defined report parameter values	Optional /no default value
reportParam	User-defined	As specified in the report design / As specified in the report design

          2.3.1 Understanding the __report parameter

__report參數有3種定義方式

a.絕對路徑

http://localhost:8080/birt/run?__report=C:\myReport.rptdesign

你的rptdesin檔案存放在C:\myReport.rptdesign

b.相對路徑，但是你的web.xml中沒有定義BIRT_VIEWER_REPORT_ROOT

http://localhost:8080/birt/run?__report=Report\myReport.rptdesign

你的rptdesin檔案存放在$TOMCAT_INSTALLl\webapps\birt\Report\myReport.rptdesign

c.相對路徑，但是你的web.xml中定義了BIRT_VIEWER_REPORT_ROOT為C:\Reports

http://localhost:8080/birt/run?__report=myReport.rptdesign

你的rptdesin檔案存放在C:\Reports\myReport.rptdesign

其他的參數都很簡單，就不一一介紹了。

部署的過程其實很簡單，我遇到的問題主要有

1.路徑不對

2.自訂參數未定義

3.__locale參數未加，顯示中文有問題

4.所有參數前面是兩個底線

希望能對你的項目有所協助。如有問題，請回複

ko4java