Jump to: navigation, search


Revision as of 19:02, 17 January 2007 by Stanleyg.us.ibm.com (Talk | contribs) (Q: How do I install BIRT in WebSphere?)

Back to BIRT FAQ Index

Application Server

Q: How do I install the BIRT Report Engine in my app server?

The Eclipse (BIRT) Reporting Engine (ERE) is a series of Java class files that can be deployed in any Java/J2EE environment – this could be within a server based application, or a client-side application. The ERE is the runtime component of BIRT – when you call it in the context of your application, you pass it a report design. The ERE then will access the data source, retrieve the data, do the required aggregations/sorting, etc., and then format the report for presentation as HTML or PDF, for example.

The BIRT report viewer is included with the report designer and is used to preview reports. It doubles as an example of how to integrate the Report Engine into a J2EE application.

Q: How do I install BIRT in Tomcat?

See complete instructions on the BIRT Integration pages.

Q: How do I install BIRT in JBoss?

Take the viewer deployment from the BIRT designer (as described for Tomcat), and copy it to your JBoss deploy directory as viewer.war.

However, BIRT uses an older version of the Rhino scripting engine, and this causes a conflict with the version installed with JBoss. To work around this temporarily, put BIRT's js.jar in JBoss's server/default/lib.

Q: How do I install BIRT in WebSphere?

See complete instructions on the Birt WebSphere Deployment page for all version's apart from which is documented here Birt WebSphere Deployment . Here is how to deploy BIRT 2.2 on Websphere

Q: How do I install BIRT in WebSphere Community Edition (Apache Geronimo)?

See complete instructions on the Birt WAS CE page.

BIRT Viewer

Q: Why does a red asterisk appear next to some of my parameters in the Viewer's parameter UI?

The asterisk indicates that a parameter is required. A parameter is required if:

  • The parameter is a string, the default value is blank, and the parameter does not allow blank values.
  • The parameter is other than a string, the default value is blank, and the parameter does not allow null values.

Note that a blank value is considered to be a blank string ("") for string values, but a (database null) value (unknown) for non-string types such as numbers and dates.

Other Integrations

Q: Can I use BIRT within a Rich Client Application (RCP)?

Community member Stavros Kounis made an Eclipse plug-in that starts BIRT's Viewer webapp using the Eclipse internal application server and views reports inside RCP using an editor that contains a browser control. He posted it on his blog at http://tools.osmosis.gr/blog.

Also set the RCP example located in the BIRT Wiki. http://wiki.eclipse.org/index.php/RCP_Example

Q: Can I store report designs in a location other than the file system?

Not at present, but we are looking into possible changes to support this. Also, Eclipse itself may be looking into this.

Q: Do BIRT reports need to be compiled before they are run?

No, there is no compile step. The BIRT Report Engine directly executes the report design XML file. (This is one reason that BIRT uses interpreted JavaScript instead of compiled Java as its scripting language.)

Q: Can BIRT reports be saved on disk?

Reports are created in two phases, Generation and Presentation. The Report Engine API has three tasks that can be used for report creation. One for generating the report, another for rendering and one that combines generation and presentation tasks. The WebViewer Example uses the combined task when generating report content using the /run servlet mapping and uses the two seperate task when using the /frameset mapping. The WebViewer Example has a URL parameter __document that allows the intermediate report document to be saved for later rendering. See the Report Emgine API page for more details. See the Viewer Usage page for details on the WebViewer parameters.