bird在webml中的配置及詳解_第1頁
bird在webml中的配置及詳解_第2頁
bird在webml中的配置及詳解_第3頁
bird在webml中的配置及詳解_第4頁
bird在webml中的配置及詳解_第5頁
已閱讀5頁,還剩9頁未讀, 繼續(xù)免費閱讀

下載本文檔

版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進行舉報或認領(lǐng)

文檔簡介

一?web.xml1>參數(shù)配置context-param<!--Defaultlocalesetting.設(shè)置默認的Locale信息。--><context-param>vparam-name>BIRT_VIEWER_LOCALEv/param-name><param-value>en-US</param-value>v/context-param>v!--Defaulttimezonesetting.Examples:"Europe/Paris","GMT+1".Defaultstothecontainer'stimezone.時區(qū)-->vcontext-param>vparam-name>BIRT_VIEWER_TIMEZONEv/param-name>vparam-value>v/param-value>v/context-param>v!--Reportresourcesdirectoryforpreview.Defaultsto${birthome}設(shè)置BIRTViewer的工作目錄。用戶可以把reportdesign或是reportdocument文件存放在這個目錄下,這樣就可以在URL上采用相對路徑去預覽這些報表文件了。默認是當前根目錄。-->vcontext-param><param-name>BIRT_VIEWER_WORKING_FOLDERv/param-name〉vparam-value>v/param-value>v/context-param>v!--Temporarydocumentfilesdirectory.Defaultsto${birthome}/documents設(shè)置生成的document文件的存放路徑。默認是documents目錄。-->vcontext-param>vparam-name>BIRT_VIEWER_DOCUMENT_FOLDERv/param-name〉vparam-value>v/param-value>v/context-param><!--Flagwhetherthereportresourcescanonlybeaccessedundertheworkingfolder.Defaultstotrue簡單的報表訪問限制控制實現(xiàn),如果設(shè)為true,哪就只能預覽存放在工作目錄下的報表文件。默認值是false。--><context-param>vparam-name>WORKING_FOLDER_ACCESS_ONLYv/param-name><param-value>true</param-value>v/context-param>v!--Temporaryimage/chartdirectory.Defaultsto${birthome}/report/images設(shè)置生成的臨時圖片的存放路徑。默認是report/images目錄。-->vcontext-param>vparam-name>BIRT_VIEWER_IMAGE_DIRv/param-name〉vparam-value>v/param-value>v/context-param>v!--Enginelogdirectory.Defaultsto${birthome}/logs設(shè)置生成的日志文件存放路徑。默認是logs目錄。-->vcontext-param>vparam-name>BIRT_VIEWER_LOG_DIRv/param-name〉vparam-value>v/param-value>v/context-param>v!--Reportengineloglevel設(shè)置日志的level,可選的值有:ALL|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST|OFF。級別由高到低。-->vcontext-param>vparam-name>BIRT_VIEWER_LOG_LEVELv/param-name〉vparam-value>WARNINGv/param-value>v/context-param>v!--Directorywheretostoreallthebirtreportscriptlibraries(JARs).Defaultsto${birthome}/scriptlib設(shè)置用戶scriptlib文件的存放目錄(在報表中用到的JavaEventHandlerClass)默認值是scriptlib。--><context-param>vparam-name>BIRT_VIEWER_SCRIPTLIB_DIRv/param-name〉<param-value></param-value>v/context-param>v!--Resourcelocationdirectory.Defaultsto${birthome}設(shè)置用戶資源存放路徑,這些資源包括Iibrary文件,image文件等。默認是當前根目錄-->vcontext-param><param-name>BIRT_RESOURCE_PATHv/param-name〉vparam-vaIue>v/param-vaIue>v/context-param>v!--PreviewreportrowsIimit.AnemptyvaIuemeansnoIimit.設(shè)置獲取dataset的最大記錄數(shù)。主要應用于設(shè)計報表的時候,預覽報表如果記錄數(shù)太多,會花費很多的時間,也可能會引起outofmemory問題。默認是不限制。-->vcontext-param>vparam-name>BIRT_VIEWER_MAX_ROWSv/param-name〉vparam-vaIue>v/param-vaIue>v/context-param>v!--MaxcubefetchIeveIsIimitforreportpreview(OnIyusedwhenpreviewingareportdesignfiIeusingthepreviewpattern)設(shè)置CUBE查詢的最大級數(shù)。和前面的參數(shù)作用類似。默認是不限制。(僅在preview模式下查看報表時有效)-->vcontext-param>vparam-name>BIRT_VIEWER_MAX_CUBE_ROWLEVELSv/param-name〉vparam-vaIue>v/param-vaIue>v/context-param>vcontext-param>vparam-name>BIRT_VIEWER_MAX_CUBE_COLUMNLEVELSv/param-name〉vparam-vaIue>v/param-vaIue>v/context-param>v!--MemorysizeinMBforcreatingacube.設(shè)置在生成CUBE時,可以寫在memory中的最大值,單位是MB可以提高效率,寫在內(nèi)存會比直接寫在硬盤快很多。但同時也要注意內(nèi)存占用的問題。--><context-param>vparam-name>BIRT_VIEWER_CUBE_MEMORY_SIZEv/param-name><param-value></param-value>v/context-param>v!--DefinestheBIRTviewerconfigurationfile定義properties文件的路徑,不可以修改。-->vcontext-param><param-name>BIRT_VIEWER_CONFIG_FILEv/param-name〉vparam-value>WEB-INF/pertiesv/param-value>v/context-param>v!--Flagwhethertoallowserver-sideprinting.Possiblevaluesare"ON"and"OFF".Defaultsto"ON".在frameset工具條上,提供有后臺服務器打印的功能,該參數(shù)可以設(shè)置是打開還是關(guān)閉后臺打印的功能。默認是打開??蛇x值為:ON和OFF。-->vcontext-param>vparam-name>BIRT_VIEWER_PRINT_SERVERSIDEv/param-name>vparam-value>ONv/param-value>v/context-param>v!--Flagwhethertoforcebrowser-optimizedHTMLoutput.Defaultstotrue這個參數(shù)是會傳遞給Engine的,主要用于一些CSS的兼容性方面的問題。默認值是true。-->vcontext-param>vparam-name>HTML_ENABLE_AGENTSTYLE_ENGINEv/param-name>vparam-value>truev/param-value>v/context-param>v!--Filenamegeneratorclass/factorytousefortheexportedreports.-->vcontext-param>vparam-name>BIRT_FILENAME_GENERATOR_CLASSv/param-name>vparam-value>org.eclipse.birt.report.utility.filename.DefaultFilenameGenerator</param-value></context-param>2>Servlet模式說明<!--ViewerServlet,SupportsSOAP--><servlet><servlet-name>ViewerServlet</servlet-name><servlet-class>org.eclipse.birt.report.servlet.ViewerServlet</servlet-class></servlet><!--EngineServlet--><servlet><servlet-name>EngineServlet</servlet-name><servlet-class>org.eclipse.birt.report.servlet.BirtEngineServlet</servlet-class></servlet><!--frameset——采用Ajax框架,可以顯示工具條,導航條和TOC面板,實現(xiàn)復雜的操作,如分頁處理,導出數(shù)據(jù),導出報表,打印等。該模式下會自動生成reportdocument文件(預覽reportdesign文件)到特定的目錄(用戶可以用參數(shù)指定,也可以定義在web.xml里)。采用Ajax,速度較慢。--><servlet-mapping><servlet-name>ViewerServlet</servlet-name><url-pattern>/framesetv/ur卜pattern></servlet-mapping>v!--run——也采用Ajax框架,但不實現(xiàn)frameset的復雜功能,不會生成臨時的reportdocument文件(預覽reportdesign文件),也不支持分頁,這個主要是應用在BIRTDesigner里的previewtab里,--><servlet-mapping><servlet-name>ViewerServlet</servlet-name>vur卜pattern>/runv/url-pattern></servlet-mapping>v!--preview沒有用到Ajax框架,直接調(diào)用底層EngineAPI對報表進行render,把生成的報表內(nèi)容直接輸出到瀏覽器。這種模式和run模式調(diào)用的是相同的EngineAPI,唯一區(qū)別在于run采用Ajax獲取報表內(nèi)容,而preview直接輸出到瀏覽器。如果要支持分頁,用戶需要在URL上定義—page和—pagerange參數(shù)。需要特別說明的是,在這幾種預覽模式中,preview的速度是最快的。-->vservlet-mapping>vservlet-name>EngineServletv/servlet-name>vur卜pattern>/preview</url-pattern>v/servlet-mapping>v!--download用于導出報表數(shù)據(jù),當你使用frameset工具條里的導出數(shù)據(jù)功能時,會用到這個模式-->vservlet-mapping>vservlet-name>EngineServletv/servlet-name>vur卜pattern>/download</ur卜pattern>v/servlet-mapping>parameter該模式主要用于生成一個參數(shù)對話框,一般用戶不常用,用戶可以直接通過提供的JSPTag--parameterPage去實現(xiàn)參數(shù)對話框,不需要直接調(diào)用。--><servlet-mapping><servlet-name>EngineServlet</servlet-name><url-pattern>/parameteNv/url-pattern></servlet-mapping>v!--document該模式主要是為了從reportdesign文件生成reportdocument文件。用戶可以在URL上提定document文件生成存放的路徑(存放在server端),如果未指定,會直接生成rptdocument發(fā)送到客戶端瀏覽器,用戶可以下載到客戶端。-->vservlet-mapping>vservlet-name>EngineServletv/servlet-name><url-pattern>/documen[v/ur卜pattern>v/servlet-mapping>v!--output該模式類似于frameset,會自動生成reportdocument文件(預覽reportdesign文件),區(qū)別在于output不采用Ajax,而是將生成的報表內(nèi)容直接輸出到瀏覽器。-->vservlet-mapping>vservlet-name>EngineServletv/servlet-name>vur卜pattern>/outputv/url-pattern>v/servlet-mapping>extract。--><servlet-mapping><servlet-name>EngineServlet</servlet-name>vur卜pattern>/extractv/ur卜pattern></servlet-mapping>二、perties 參數(shù)設(shè)置perties文件主要是定義一些擴展的參數(shù)。configurablevariableforJSPbasehref.Pleaseuncommentthebelowline.#base_url=:8080該設(shè)置主要應用于代理服務器的情況下,在使用代理服務器后,從request里獲取的URI并非真正的URI,需要在這里定義。[EXTENSIONSETTING]viewer.extension.html=htmlviewer.extension.pdf=pdfviewer.extension.postscript=psviewer.extension.doc=docviewer.extension.xls=xlsviewer.extension.ppt=ppt定義輸出的報表文件的后綴名,和format相關(guān)聯(lián)。#[OUTPUTFORMATLABELNAME]viewer.label.html=HTMLviewer.label.pdf=PDFviewer.label.postscript=PostScriptviewer.label.doc=Wordviewer.label.xls=Excelviewer.label.ppt=PowerPoint定義導出報表對話框里的報表格式列表,和format相關(guān)聯(lián),這樣名字會更有意義。#[CSVSEPARATOR]viewer.sep.0=,viewer.sep.1=;viewer.sep.2=:viewer.sep.3=|viewer.sep.4=\t支持多種CSV分隔符,用戶也可以增加新的分隔符(只支持char,而不是string)。但同時需要修改JSP文件和Mperties文件。#[LOGGERS]#"logger."+class=level#ifnolevelisspecifiedorthetext"DEFAULT",#thenthedefaultlevelfromtheweb.xmlwillbeused.eclipse.datatools.connectivity.oda=DEFAULT.eclipse.datatools.enablement.oda=DEFAULT當前的日志都是通過Engine輸出的,如果需要其它組件的日志輸出,可以在這里定義。注意格式必須為……。而且該組件必須實現(xiàn)了java的logger。可以單獨為該組件設(shè)置日志級別,如果設(shè)為DEFAULT,就會使用web.xml里的設(shè)置。三、URL參數(shù)下面是一些主要用到的URL參數(shù)?!癬_report”定義要預覽的rptdesign文件路徑,支持相對路徑和絕對路徑,相對路徑是相對于web.xml中定義的工作目錄?!癬_document”定義要預覽的rptdocument文件路徑,同樣支持相對和絕對路徑。相對路徑是相對于web.xml中定義的工作目錄。在同時定義了—report和__document參數(shù)時,以__document為優(yōu)先,如未找到相應的document文件,才會從design文件生成document文件(frameset/output)或是直接去render這個design文件(preview/run)?!癬_title”定義報表顯示的標題。“__showtitle”是否顯示frameset模式下上方的標題部分。true|false“__toolbar”是否顯示frameset模式下的工具條。true|false“__navigationbar”是否顯示frameset模式下的導航條。true|false“__parameterpage”是否強制彈出或不彈出報表參數(shù)對話框。true|false“__format”輸出報表的格式,默認為html。現(xiàn)在支持:pdf|doc|xls|postscript|ppt“__locale”設(shè)置Locale信息,如__locale=zh_CN,注意必須是國家加語言。“__svg”設(shè)置chart輸出是否以SVG格式輸出。true|false.frameset和run模式下,會采用javascript判斷客戶端瀏覽器是否支持svg,但并非對所有瀏覽器有效?!癬_bookmark”設(shè)置頁面要定位的書簽名字?!癬_istoc”指定定位的書簽是不是一個TOC名字。這個主要用于定位到一個TOC上。如為true,就會根據(jù)—bookmark參數(shù)值去獲取一個真正的書簽名,從而實現(xiàn)正常的跳轉(zhuǎn)?!癬_rtl”指定HTML頁面輸出是否需要righttoleft,支持不同國家的閱讀習慣,如阿拉伯國家是從右到左的?!癬_page”指定要輸出的報表頁數(shù),這個依賴于報表的分頁設(shè)計(pagebreak)?!癬_pagerange”指定要輸出的報表頁數(shù)范圍。如1,3,5-9?!癬_resourceFolder”定義資源目錄路徑。同web.xml中的BIRT_RESOURCE_PATH設(shè)置。“__asattachment”是否以附件方式下載報表,如生成PDF或是其它格式里。默認是inline?!癬_masterpage”是否要顯示masterpage。true|false“__designer”該參數(shù)主要是應用在BIRTDesigner環(huán)境下,如會讀取cache的報表參數(shù)等等,一般不用。true|false“__overwrite”該參數(shù)同web.xml定義的參數(shù),不過web.xml里是全局設(shè)置,在URL上通過參數(shù)可以定義本次操作的設(shè)置?!癬_imageID”內(nèi)部參數(shù),用于image的引用,一般不用?!癬_maxrows”設(shè)置Dataset查詢的最大記錄數(shù),要注意這個設(shè)置是全局的,會影響后面所有的請求。主要用于BIRTDesigner下,提高報表設(shè)計效率。同web.xml中的BIRT_VIEWER_MAX_ROWS設(shè)置。“__maxlevels”設(shè)置查詢獲取Cube的最大級數(shù)。同上面的__maxrows,也主要用于BIRTDesigner設(shè)計環(huán)境。同web.xml中的BIRT_VIEWER_MAX_CUBE_LEVELS設(shè)置?!癬_cubememsize”同web.xml中的BIRT_VIEWER_CUBE_MEMORY_SIZE參數(shù)設(shè)置?!癬_instanceid”如果查看BIRT輸出的HTML代碼,你就可以看到一些HTMLElement會有一個iid的屬性(如table),這個就是instanceid。這個是Engine動態(tài)生成的,不可提前預知。所以你需要從HTML代碼中得到這個值。該參數(shù)主要是為了獲取reportlet(報表片斷,如只輸出報表中的一個Table或是一個Chart)。需要配合—isreportlet參數(shù)?!癬_isreportlet”指定當前輸出是不是一個reportlet。true|false特別說明:為了輸出一個reportlet,BIRT現(xiàn)在提供兩種方式。為要輸出的對象(表格或是Chart)定義一個bookmark,然后可以用下面的URL輸出reportlet.http://localhost:8080/birt/frameset?report=test.rptdesign&bookmark=bk&__isreportlet=true采用instanceid,但這個值事先是無法預知的,需要預覽一次后從HTML代碼中得到。然后用下面的URL輸出reportlet.http://localhost:8080/birt/output?report=test.rptdesign&instanceid=iid&isreportlet=true還有就是要注意,reportlet只支持document文檔。如果是預覽design文檔去輸出reportlet,就必須要使用frameset/output(自動生成document文檔)?!癬_clean”BIRT里臨時生成的一些文件都是和session相關(guān)的,比如臨時document文件,還有image文件。這些文件也可以通過session進行管理,這個參數(shù)就是指定是否需要在sessiontimeout的時候清除這些臨時文件。默認值是true。true|false“__dpi”可以設(shè)置輸出Chart的dpi數(shù)值?!癬_fittopage”暫時這個參數(shù)只對PDF和postscript格式報表有效,指定是否調(diào)整至適合頁面?!癬_pagebreakonly”暫時這個參數(shù)只對PDF和postscript格式報表有效,指定是否只采用BIRT報表內(nèi)定的分頁設(shè)置。這個參數(shù)一般需要和—fittopage聯(lián)合使用。agentstyle”同web.xml中的HTML_ENABLE_AGENTSTYLE_ENGINE參數(shù)設(shè)置。==========================后臺Server端打印相關(guān)參數(shù)“_action” 定義執(zhí)行的指令名稱。當前只支持print指令,用于后臺服務器打印?!癬_printer”后臺打印機名稱。printer_copies”對應打印機的打印份數(shù)參數(shù)。printer_collate”對應打印機的雙面打印參數(shù)。printer_duplex”對應打印機的duplex參數(shù)。printer_mode”對應打印機的模式參數(shù)。是單色還是彩色printer_pagesize”對應打印機的紙型參數(shù)。比如A4。==========================JSPTag相關(guān)參數(shù)===================================“__id”viewer的ID號,這個參數(shù)一般不常用,主要用于JSPTag中,如在一個頁面插入兩個BIRTViewer,而且預覽同一個報表文件,這時候因為在一個session下面,所以需要用不同的ID去生成單獨的document文件。不至于都生成同一個document文件上,從而引發(fā)沖突?!癬_pattern”在JSPTag中用于指定要提交的ServletPattern名字,如frameset/output/run/preview等。主要用于采用parameter模式生成parameterdialog對話框時?!癬_target”可以指定提交到的窗口名稱。女Lblank,_self等?!癬_nocache”指定是否會用到cache的報表參數(shù)值,這些cache的值一般保存在rptconfig文件里。在設(shè)計報表并預覽的時候,可以保存輸入的報表參數(shù)值。這個在runtime的時候不常用。==========================報表參數(shù)相關(guān)“__isnull”指定當前的報表參數(shù)為null值,后面是報表的參數(shù)名?!癬_islocale”指定當前的報表參數(shù)值是和Locale/Format相關(guān)的,必須用特定的Locale/Format轉(zhuǎn)化參數(shù)值(從String轉(zhuǎn)化為Objec

溫馨提示

  • 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
  • 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會有圖紙預覽,若沒有圖紙預覽就沒有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫網(wǎng)僅提供信息存儲空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負責。
  • 6. 下載文件中如有侵權(quán)或不適當內(nèi)容,請與我們聯(lián)系,我們立即糾正。
  • 7. 本站不保證下載資源的準確性、安全性和完整性, 同時也不承擔用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。

評論

0/150

提交評論