BIRT运行时参数说明(英文).doc
《BIRT运行时参数说明(英文).doc》由会员分享,可在线阅读,更多相关《BIRT运行时参数说明(英文).doc(6页珍藏版)》请在得力文库 - 分享文档赚钱的网站上搜索。
1、摘自www.eclipse.orgUsing the BIRT Report Viewer Overview Viewer Operations Run a Report Viewer Frameset Viewer Command Options Report Parameters Error ReportingOverviewThe sample BIRT viewer is optimized for use within Eclipse for the preview operation. When used outside Eclipse, it simply acts as an
2、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 base
3、d 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
4、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 t
5、wo servlet mappings. OperationDescriptionframesetDisplay a frameset that has one frame that prompts the user for parameters, then displays the resulting report in another frame.runRuns the report and displays the output as a stand-alone HTML page, or as a PDF document.The servlet mapping names are c
6、ase 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 hand
7、led 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: http:/
8、sitePrefix/birt-viewer/run?option1=value1;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
9、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 ou
10、tput 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 pa
11、rameters 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: http:/sitePrefix/birt-viewer/frameset?option1=val
12、ue1;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 Displ
13、ay 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
14、 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: http:/local
15、host:8080/birt-viewer/run?_report=report%5CSalesInvoice.rptdesign&OrderNumber=10010 In the above: http:/localhost:8080/ 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%5CSalesInv
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- BIRT 运行 参数 说明 英文
限制150内