New and Notable Features within BIRT 2.2 Release Candidate 0


BIRT 2.2 Release Candidate 0 has officially been released to the public. Below is a description of some of the key features that are now available in the RC0 build. Keep in mind, as with all milestone releases, the product continues to evolve.

To review the projects slated for the 2.2 release, see the draft project plan, which is available here.

Dynamic Crosstab Support

Displaying data in a cross tabulated format offers many advantages for data interpretation and analysis, and is often a requirement for information delivery applications. While this was possible with prior versions of BIRT, the number of columns had to been known beforehand or at the report development stage. To address this issue, BIRT now offers dynamic cross table and data cube elements. The data cube element appears in the Data Explorer view and allows the developer to build cubes based on existing data sets. These cubes are constructed using dimensions and measures as illustrated below.

Cube Builder

The new dynamic cross table element can be placed on the report canvas and bound to the new cube. The dynamic cross table permits specification of dimensions for the columns and rows while measures are defined at the intersection point.

Cross Table Element

In this example, the revenue for each product per year will be generated automatically. Product line and year are the dimensions while revenue is the measure. The designer does not have to know the number of Product Lines or the number of years to cross-tabulate. The cross table element supports familiar BIRT formatting techniques as well. In addition, each dimension can be sub-aggregated and the level of hierarchy to display can be selected.

Cross Table Element Group Levels

In this example the crosstab element will display rows for each quarter in a year and will subtotal each, culminating with a grand total presented in the footer. The table could have been further divided into months by checking the month node in the year dimension within the Show/Hide Group Levels dialog.

Example - Cross Table Element

These totals are also calculated in the column dimension based on product line, with a grand total presented in the last column. An example of a completed report is shown below.

Example - Cross Table Element Output

The crosstab element also supports filtering and sorting by level, multiple measures, a special date dimension, and horizontal page breaks.

Web Service ODA

BIRT has many ways of collecting data for reporting purposes, including pushing objects into the report from session or an application, but the predominant way is using data sources that pull data. BIRT Data Sources are based on the Open Data Access (ODA) specification which is implemented by the Eclipse Data Tools Platform project. Currently BIRT supports accessing data from JDBC, XML, flat files and scripted data sources. With the RC0 release, BIRT now has the capability to retrieve data using a Web Service ODA driver.

Web Services ODA

This new driver allows the report developer to specify a WSDL URL or file location. In addition a custom Java connection class can be specified to allow refined control of how the SOAP request is made. Once the data source is set up the developer can build a web service data set responsible for sending the SOAP request and parsing the SOAP response.

Web Services ODA - SOAP Request

In this example the ItemSearch method is selected from the available Amazon web services calls. The SOAP Request node displays the automatically generated SOAP request. Any part of the SOAP request can be modified and/or linked to a data set parameter. Once the SOAP request is constructed the response can be parsed. The Web Services ODA is built on the XML Data Source technology. This means that the SOAP response is parsed using XPath syntax. As illustrated below, the ItemSearch call returns a list of items that match the keyword search. These items are then parsed and mapped to a data set row. As with the XML Data Source, the XPath syntax is generated automatically by selecting the nodes in the XML Structure pane, but can be modified manually or programmatically.

Web Services ODA - SOAP Response

After completing the mapping, standard Data Set features such as filtering, sorting and computed columns can be utilized. An example of a completed report is shown below.

Web Services ODA - Example Report

Charting Improvements

BIRT currently provides scripting support for chart events. By implementing scripts for these events the developer can modify the behavior and appearance of the chart. As an example, a user may implement the beforeDrawAxisTitle event handler to modify the label the chart engine renders for the X, Y, and Z axis titles. While this method works well, modifying the chart outside of these events can be somewhat difficult. To better facilitate programmatic chart modifications, BIRT now supplies a simple Chart API. This API can be called within the BIRT scripting environment and from the design/report engine API to modify chart properties.

Simple Chart API

In the above illustration, the beforeFactory event is used to modify the chart title content and color. See BPS 66 for more details and the class diagrams.

A new BIRT project type is also available. This project type allows the Chart Engine and Tag library to be published as a Web Project using Web Tools Platform project mechanisms.

New Charting Project Wizard

The wizard deploys the necessary files and builds the directory structure for a web-based charting application.

Example Charting Project

Charting interactivity is now supported in Swing and SWT-based applications, packaging has been improved to include all chart components in a single download, and Tube, Cone, and Pyramid charts are available as new chart types.

PPT Emitter

BIRT Reports can be delivered in PDF, HTML, Paginated HTML, XLS, DOC, and Postscript formats. These output formats are generated using the BIRT emitter extension. With Release Candidate 0, an emitter has been added to support Microsoft Powerpoint as an output format.

PPT Emitter


Release Candidate 0 contains many additional features and improvements, including a simpler scripting interface to the design engine API, logging per report, performance enhancements, better PDF font support, and improved support for HTML text when outputting to PDF.