<%= BirtResources.getMessage( "birt.viewer.required" ) %> 代">
当前位置：文档之家 › birt文档

birt文档

  • 格式：docx
  • 大小：57.89 KB
  • 文档页数：8

1、ParameterDailogFragment.jsp中<TR><TD COLSPAN="2"><%= BirtResources.getMessage( "birt.viewer.required" ) %></TD></TR>代表Parameters marked with * are required.2、ConfirmationDialogFragment.jsp链接processing.jsp3、RequesterFragment.jsp的标题是PARAMETER SELECTION PAGE4、参数页面中：<FONT TITLE="<%= parameterBean.getToolTip( ) %>"><LABEL FOR="<%= encodedParameterName %>"><%= parameterBean.getDisplayName( ) %>:</LABEL></FONT> 代表参数对话框中文本参数的提示文本，如：数据起始时间等<FONT COLOR="red"><LABEL FOR="<%= encodedParameterName %>">*</LABEL></FONT> 代表提示文本后的红色*5、Web Viewer servletsThe Web Viewer consists of two main servlets,the ViewerServlet and the BirtEngineServlet. The ViewerServlet handles the frameset and run servlet mappings set in the web.xml .The BirtengineServlet handles the preview,output,and download mappings specified in web.xml .(1) download: used internally by the Web Viewer or frameset when extracting results in CSV format.Do not use externally. BirtSimpleExportDataDialog.js creates a hidden form and submits to servlet for processing.(2) frameset: used to launch the AJAX-based Web Viewer.Contains the toolbar,navbar,and table of content features.Run and render tasks are separated.(3) parameter: used internally by the designer to create a rptconfig filewhen selecting the preview tab for a report that contains parameters.Do not use externally. (4) preview: use to run and render a report or to render an existing rptdocument directly to an output format.Does not use the AJAX framework,but can launch a Parameter page.(5) run: use to launch the Web Viewer without the toolbar,navbar,or table of contents. Uses the runandrender task to create the output,but does not support pagination or create a rptdocument. Uses the AJAX framework to support canceling a report.6、ViewServlet Run Fragments7、BirtEngineServlet EngineFragmenttsin,8、WebViewerExample Directory StructureT he defa ul t l oc ati on f or BI R T lo gsL oc at i on f or cl a ss f ile s used ina sc r ip te d d at a s ou rceD ef au l t lo cat io n f or re port de si g nsJ a va Sc rip t f il es us ed with t h e We bV ie werJ S P fr agm ent s us e d to buil d t he W e b Vi ewe rI m ag es us edby t h e Web Vie we rC S S fi les u s edby t he Web Vi e we rL o ca ti on fo r r eq u ir ed BIRT J A R fi l esRe qui red fo r B IR T r un -t ime p lu g in s Lo cat ion for O S Gi c o nf ig ura ti on fi les9、AJAX directory of the Web Viewer（1）coreContains JavaScript files used to handle BIRT events and communications with the Web Viewer servlets.a. BirtCommunicationManager.jsHandles most Ajax.Request calls to the Web Viewer servlet or SoapActionb. BirtDndManager.jsHandle drag-and drop for Web Viewer dialogsc. BirtEvent.jsPrototype BIRT Web Viewer Eventsd. BirtEventDispatcher.jsSupplies functions for registering,firing,and broadcasting BIRT eventse. BirtSoapRequest.jsSupplies functions used to create SOAP messages to be sent by the BirtCommunicationManager f. BirtSoapResponse.jsProcesses the SOAP responses from the SOAP requestg. Mask.jsConceals a button in toolbar when dialog are presented(2) libPrototype.js is the prototype JavaScript framework file(3) mhContains files used to parse the SOAP responses, from the AJAX servlet calls.a.BirtBaseResponseHandler.jsBase class used to add associations for SOAP resopnses. Currently there is only oneb.GetUpdatedObjectsResponseHandler.jsMain class used to consume the soap response. This class has process methods for updating entire report section, such as a new report page and for updating portions of the Web Viewer, for example, the page number in the navigation bar(4) uiContains files used in conjunction with the JSP fragments ti control the Web Viewer user interfaceApp:a.AbstractBaseToc.jsThis class is used as the base class for the BirtToc.jsb.AbstractBaseToolBar.jsThis class is the base class for the BirtToolbar.jsc.AbstractUIComponent.jsThe base class for all classes in the directory. Sets the instance of the classd.BirtNavigationBar.jsThis JavaScript class contains methods that work in conjunction with the NavigationbarFragment.jsp to create the links to do page navigation. The NavigationbarFragment constructs the initial structure using input tags and BirtNavigationBar sets up native event handlers to monitor clicking or entering the navigation bar controls, which fire BIRT events to retrieve new contente.BirtProgressBar.jsThe BirtProgressBar class is used when displaying the progress bar and handles canceling of the currently running taskf.BirtToc.jsThis JavaScript class sets up the events that retrieve the table of contents for a report document. In addition, event handlers load the correct pages when a table of contents node is selected.g.BirtToolbar.jsThe BirtToolbar JavaScript class works with the ToolbarFragment.jsp in a similar nature as the BirtNavigationBar works with the NavigationbarFragment.jsp. One difference is that some of the BIRT events make HTTP requests to the Web Viewer servlets as opposed to SOAP requests. Forexample, the __E_EXPORT_REPORT event launches the export dialog, which then creates a form post that is submitted to the Web Viewer. Many of the events registered in the BirtReportDocument class are fired here.Dialog:a.AbstractBaseDialog.jsThis JavaScript class is the base class for all the dialogs in this directory and contains the event handlers for basic dialog operation.b.AbstractExceptionDialog.jsBase Class for the BirtExceptionDialog used with the ExceptionDialogFragment.jsp page to add exceptions to the Web Viewer. The general exception is written to the <SPAN> element with faultstring as the id in ExceptionDialogFragment.jsp and the stack trace is written to the <SPAN> element with faultdetail as the id. The writing occurs while the SOAP response message is being parsed by the BirtSoapResponse JavaScript class.c.AbstractParameterDialog.jsThe base class for the BirtParameterDialog JavaScript class.d.BirtConfirmationDialog.jsThis class is used to display a confirmation dialog used within the BirtPrintReportDialog.e.BirtExceptiondialog.jsThis class extends the AbstractExceptionDialog to set up event handlers that show or hide the stack trace when the error detail is selected. Do not confuse these stack trace messages with report errors, which the HTML emitter writes and displays at the bottom of the report.f.BirtExportReportDialog.jsThis class works with the ExportReportDialogFragment.jsp page to build the Export Report dialog. This class creates a form post to the Web Viewer servlet to download the report in one of the supported formats. The BirtReportDocument.js file contains the class that registers an event handler to call this class. The event is fired in the toolbar.js file when a user clicks on the appropriate image as defined in the ToolbarFragment.jsp.g.BirtParameterDialog.jsThis class is responsible for displaying the Parameter page, collecting the parameter values, making calls for dynamic and cascading parameters, and submitting the URL to re-run the report.h.BirtPrintReportDialog.jsThis class works with the PrintReportDialogFragment.jsp to create the print report dialog used to print the report on the server. This class works similar to the BirtExportReportDialog.i.BirtPrintReportServerDialog.jsThis class works with the PrintReportServerDialogFragment.jsp file to handle server-side printing. j.BirtSimpleExportDataDialog.jsThis class works with the SimpleExportDataDialogFragment.jsp to construct the Export Data dialog. This class creates a form post to the download mapping to download.k.BirtTabbedDialogBase.jsThis class is currently not used.Report:a.AbstractBaseReportDocument.jsBase class for the BirtReportDocument class. Many of the event handlers for the BirtReportDocument class are implemented in this classb.AbstractReportComponent.jsBase class for the AbstractBaseReportDocument class. Provides framework functions for re-rendering content and setting up events.c.BirtReportDocument.jsHandles registering most of the event handlers and is included in the FramesetFragment.jsp, RequestorFragment.jsp, and the RunFragment.jsp.d.ReportComponentIdRegistry.jsUtility class used for id lookups.(5) Utility:a. BirtPosition.jsUtility class with functions for handling moving and sizing dialogs.b.BirtUtility.jsClass containing many reused utility functions, such as functions for enabling and disabling buttons, trimming data, and message formatting.c.BrowserUtility.jsUtility class with functions used when determining if output should be set up for Internet Explorer.d.Constants.jsClass containing many of the constants used with the BIRT Web Viewer.e.Debug.jsUtility class used for debugging the example Web Viewer. Can be launched by including the Debug.js and then calling the showDebug function.f.Printer.jsUtility class containing functions for printer manipulation.10、Relationships of standard BIRT components and custom components(BIRT Report Viewer)Report design(.rptdesign)Report EnginePresentation ServicesReport(PDF,HTML)11.API(1) BIRT Report Engine API该API提供了工作组类支持以下操作：a.发现一份报表中定义的参数设置.b.获取参数默认值c.运行报表设计来制作一个未格式化的报表文件d.运行报表设计文件或报告产生的任何支持的输出格式e.从报告中提取文档数据使用BIRT报表引擎API：a.为报表设置使用EngineConfig对象的引擎选择b.启动平台c.使用ReportEngineFactory创建ReportEngine 对象d.使用openReportDesign()的ReportEngine方法打开现有的报表设计或使用openReportDocument()方法打开一个现有的报表文件e.或者，当报表参数的设计细节都需要使用IGetParameterDefinitionTask对象以获取此信息f.使用IrunAndRenderTask或IRunTask，其次IRenderIask来运行和渲染报表g.清理调用destroy()引擎实例的引擎报表。

合集下载

birt排序(终级方案)

birt排序(终级方案)

1. 建立数据集Customer，sql：selectCustomerNumber,customername,city from customers2. 添加两个报表参数sortCol和sortDir，name(根据实际查询需要如没有查询条件可不加)。

3.在outline视图点击数据集，点击脚本，在beforeopen中加入：var sql ="";var name = reportContext.getParameterValue("name");if(name != null && name.trim()!="" )sql = " where name like '%"+name.trim()+"%' ";var sortDir = reportContext.getParameterValue("sortDir");if (sortDir != null){if (sortDir.indexOf("ASC") != -1)sortDir = "DESC";elsesortDir = "ASC";}elsesortDir = "ASC";var sortCol= reportContext.getParameterValue("sortCol");if (sortCol!=null)sql =sql+" order by " + sortCol+" "+sortDir ;this.queryText+=sql;4、选择列标题，属性，超链接，选择追朔，然后选择到自己的报表，填写参数：说明：1、sortDir的值为：var sortDir = reportContext.getHttpServletRequest().getParameter("sortDir"); if (sortDir != null){if (sortDir.indexOf("ASC") != -1)sortDir = "DESC";elsesortDir = "ASC";}elsesortDir = "ASC";2、sortCol的值为要排序的数据库字段名称。

BIRT_中文指南

BIRT_中文指南

BIRT 中文指南BIRT -简介BIRT是一个Eclipse-based开放源代码报表系统。

它主要是用在基于Java与J2EE的Web应用程序上。

BIRT主要由两部分组成：一个是基于Eclipse的报表设计和一个可以加到你应用服务的运行期组件。

BIRT同时也提供一个图形报表制作引擎。

URL: /birt/URL: BIRT报表中文指南BIRT.rar前言这个指南将引导你设计一个简单的报表，令你对BIRT报表系统有个感性的认识，如果想进一步了解BIRT的使用可以参考BIRT在Eclipse中自带的帮助，Select Help→Help Contents from the Eclipse menu and then click on the BIRT Developer Guide.个人体验•操作界面友好大方，各种提示信息直观清晰，界面，图标都很漂亮：），尤其是对报表的开发布局划分的很科学，一般的报表工具只有设计和预览两个界面，BIRT有正常，主页，XML源，布局，预览，脚本多个设计布局；•功能并不逊色与商业报表工具；•CSS提供了强大的样式定义，对于属性CSS的设计人员来说，应该可以设计出相当出色的报表样式；•灵活的条件格式定义(formatting rule)，可以方便的根据业务逻辑来动态格式话报表元素；•集成在Eclipse中，不用再开启别的报表开发工具窗口；•BIRE的本地化做的很好，安装以后操作界面就是中文的；•开源的报表产品，降低开发成本，一些报表开发工具除了价格昂贵以外，还有用户限制；•不足之处，毕竟是国外的报表工具，与中国的报表在理念上还是有很多不同，国外更注重报表设计时数据和样式的分离设计，以获得清晰真实的统计数据，国内的报表可能主要是作为个人业绩的的一种炫耀吧，更注重报表的样子而不是样式。

所以早期的Html设计都喜欢采用table来作为元素定位的工具，而table的初衷可能只是作为数据显示的容器吧。

【BIRT资料】BIRT运行时参数说明

【BIRT资料】BIRT运行时参数说明

摘自the BIRT Report Viewer•••••••OverviewThe sample BIRT viewer is optimized for use within Eclipse for the preview operation. When used outside Eclipse, it simply acts as an example of the application you might build to run and view reports. Your report viewer application must be in Java so that it has access to the BIRT engine.The Viewer performs three distinct operations, of which one is internal and not visible to your application:•Create a parameter entry form based on the parameter definitions within the report design file.•Given a set of report parameter values, run a report and return the output as either HTML or PDF.•Retrieve an embedded image, or an image of a chart within the report. (Internal operation.)You can use a full-feature Viewer frameset that displays a parameter form and runs the report. Or, you can supply the parameter values and simply run the report to produce a simple HTML or PDF output page.Viewer OperationsThe BIRT viewer provides a number of URLs that control its behavior. The Viewer provides two modes of operation as given by two servlet mappings.Operation Descriptionframeset Display a frameset that has one frame that prompts the user for parameters, then displays the resulting report in another frame.run Runs the report and displays the output as a stand-alone HTML page, or as a PDF document.The servlet mapping names are case sensitive. Run a ReportThe run servlet mapping runs a report given a set of report parameters, and returns the report as an HTML page or PDF document. This servlet mapping does not provide a frameset. Use this option if you want the report to appear as a stand-alone page. Parameters must be handled in one of three ways:•The report requires no report parameters.•Your application already knows the values of the parameters (perhaps from a server session), and passes them along.•Your application has created a parameter page specifically for the report.The run report URL is of the form:;option2=value2;...See below for a list of available viewer command options.Viewer FramesetThe viewer command provides additional UI to work with a report. Use this URL when your report contains parameters, and you want the Viewer to display a UI so the user can enter parameter values. (You should use the run command if the caller already has the parameter values.)The frame-based viewer displays a frameset that contains three frames:• A left-hand navigation frame that contains the report parameters.• A right-hand content frame that contains the report output• A top toolbar frame that contains the navigation bar.The parameters frame displays a form for entering the parameters (if any) for a report. It contains a Run Report button that runs the report. The report then appears in the report frame . The user can refine the report simply by modifying parameters in the parameter frame and again by clicking Run Report.The toolbar contains a button to maximize the report. When this is done, the frameset switches to display a single frame that contains the report output.The viewer URL is of the form:;option2=value2;...See below for a list of available command options. The command options allow you to control which of the three frames appear in the resulting web page.When you issue this command, the viewer will do one of two things:•Run and display the report if it has no parameters, or•Display the parameter page and ask you to enter parameters. You can then click the Run Report button to run the report.Viewer Command OptionsThe run and the frameset Viewer operations both take a set of options which include report parameters. Report parameters are defined within the report design. They appear in the URL using their internal names, not display names. Viewer options pass information to the BIRT Viewer web app. Viewer options start with a double underscore to differentiate them from report parameters. Option names and values must be encoded for use in a URL. For example:In the above:•– The URL (including port) for your installation of the app server.•/birt-viewer/ – The name of the BIRT Viewer servlet.•run – The servlet mapping for running a report.•report% – Relative file system path of the report to run. The name is relative to the web app directory in which the birt-viewer was installed.•OrderNumber=10010 – The name and value of a report parameter as defined in the report design.List of OptionsThe available viewer options include:Option Description Values Default frameset run __format The output format html or pdf html Y N__isnull Identifies that a reportparameter has a nullvalueParameter name None. Required. Y Y__locale Report locale Java locale valuesuch as en, en-us orch-zh.JVM locale Y Y__report The absolute path tothe report document.None. Required. Y YreportParam Report parameter. As specified in thereport design.As specified inthe reportdesign.Y YCase-SensitivityCase-sensitivity of the options varies:•Viewer option names and values are case-insensitive.•Report parameter names are case-sensitive: they must match the name as defined in the design.•The file name case sensitivity is defined by your operating system.If the URL contains a misspelled option name, or the name of report parameters are in the wrong case, then the Viewer silently ignores the parameter.The __format OptionThe type of output to produce: either html or pdf. Values are case insensitive. If a value other than pdf is provided, then the HTML format is produced.The __isnull OptionReport parameters can take a value, or can be null. (Here "null" means the database definition: the value is unknown.) By definition, date and numeric report parameters have a null value if the report parameter is provided in the URL, and the value is blank. However, string report parameters have an ambiguity: is an empty value to be considered blank (a string whose value is ""), or null? Since blank is used more often, BIRT interprets an empty report parameter value as blank. To say a string parameter is is null, just write:__isnull=yourParamWhile this option is primarily for string report parameters, it works just as well for other report parameter types as well. See the section below for additional details.The __locale OptionUse the __locale option to specify both the locale for report parameter values, and the locale for the report output. The locale must be a valid Java locale such as en-us, etc. as specified in the . If you do not specify a locale, it defaults to the locale set in the Java virtual machine (JVM.)Values are case insensitive.The __report OptionThe __report Option names the report design to run. It can be an absolute or relative file name. If relative, the looks in the directory specified in the BIRT_VIEWER_REPORT_ROOT property in the viewer's file. The file search rules are:•If name is absolute, use it directly.•If BIRT_VIEWER_REPORT_ROOT is set, use this value as the base for the relative name.•Otherwise, use the viewer web app's directory as the base for the relative name. Report ParametersReport parameters can be Boolean, Number, Date, Float or String. The values are defined as follows:DataTypeValue Encoding NotesBoolean true, false Must use the value true for a true value, all other values (including 1) are treated as false. (Uses the Java () method for parsing.) Values arecase-insensitive.Number Floating point number witha locale-specific decimalseparator.Must not include a thousands separator, or extracharacters such as a currency symbol. Uses the Javaclass to parse the number.String NoneDate Locale-specific dateformat.Uses the Java class to parse the date.Report Parameter ValueThe rules for a given parameter foo are determined by the first rule below that takes effect:•If __isnull=foo appears in the URL, foo's value is null.•If foo=mumble appears in the URL, foo's value is mumble.•If foo= appears in the URL, foo's value is blank if it is a string, and null if it is a number or date.•If foo has a default value, foo's value is that default value.•Otherwise, foo's value is blank for string or null for number and date.Value CheckingThe report definition provides two properties for report parameters that influence parameter validation. First, the allowNull property determines if a report parameter can be null. If a report parameter has a null value, but the allowNull property is false, then the BIRT report engine will raise an error.Second, string report parameters have a allowBlank property. If report parameter has a blank value, and allowBlank property is false, then the BIRT report engine will raise an error.Error ReportingIf an error occurs during the operation, an error page will appear.。

birt入门文档(自己整理)

birt入门文档(自己整理)

Birt 入门文档目录1 BIRT -前言 (1)2 BIRT -简介 (1)3 BIRT -配置安装 (2)3.1 下载 (2)3.2 安装以及汉化 (2)4 BIRT -简例 (2)4.1 创建一张报表 (3)4.2 创建报表数据源和数据集 (5)4.3 构建Table (9)4.3.1 构建明细表 (9)4.3.2设置边框，样式 (10)4.3.3创建报表参数 (11)4.3.4设定颜色标识 (13)4.3.4过滤器使用 (15)5 BIRT -小结和回顾 (16)1 BIRT -前言本文档在简介BIRT这个开源免费的报表开发工具后将引导你设计出简单的报表，如想进一步了解BIRT的使用可参考BIRT在Eclipse中自带的帮助，Help→Help Contents。

2 BIRT -简介BIRT是一个Eclipse-based开放源代码报表系统。

BIRT是Business Intelligence and Reporting Tool的简写,即商业智能与报表工具。

它主要是用在基于Java与J2EE 的Web应用程序上。

BIRT主要由两部分组成：一个是基于Eclipse的报表设计器，另一个是可以加到你应用服务的运行期组件。

BIRT同时也提供一个图形报表制作引擎。

URL: /birt/ 这个网址可以找到BIRT，可以去看看。

使用BIRT可以开发出多样化的报表应用，包含：列表（最简单的报表就是列出数据）、图标（饼图，折线图，柱状图等）、交叉表（通过二维显示数据）、字符和文档、复合报表（多个报表组成）等。

有人总结了许多它的优点。

看一下：•操作界面友好大方；•功能并不逊色与商业报表工具；•CSS提供了强大灵活的样式定义，对于属性CSS的设计人员来说，应该可以设计出相当出色的报表样式；•集成在Eclipse中，不用再开启别的报表开发工具窗口；•BIRE的本地化做的很好，安装以后，可以汉化；•开源免费的报表产品，降低开发成本，一些报表开发工具除了价格昂贵以外，还有用户限制；3 BIRT -配置安装3.1 下载在BIRT官方网站/birt/ 下载。