New and Notable Features within BIRT 2.5 Milestone 6


BIRT 2.5 Milestone 6 has officially been released to the public. Below is a description of some of the key features that are now available in the M6 build. Keep in mind, as with all milestone releases, the product continues to evolve.

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

Chart Improvements: Z-Ordering, Empty Chart Messages, Cursor Types, Pie Chart Coverage, and Label Spans

The charting package has been enhanced to support many new features as described below.

With the milestone 6 release of BIRT 2.5 it is now possible to set Z-order rendering priority for combination charts.

Z-Order for Combination Charts

In this example the bar series will be rendered in front of the area chart because it has a higher Z order value.

Currently when the engine processes charts and the dataset for the chart is empty, BIRT does not display the chart. In some cases it is desirable to display a message to the end user that the data returned empty. Milestone 6 provides this capability now which a change to the chart model and UI.

Empty Chart Message

The message can be externalized and supports font customization, such as text rotation.

When rendering pie charts the actual diameter of the chart is computed by the chart engine based on the number of data points, legend size and specific label formatting. In previous releases of BIRT this made it difficult to size two pie charts to the same size if they contained a different number of points or label styling. In this release it is now possible to set the percentage of the plot area that is used to render the actual pie slices.

Pie Chart Coverage

The chart engine and chart builder now support specifying a cursor type for interactivity. This feature works with all chart renderers, but will not work with SVG and Image formats displayed in Internet Explorer.

Interactivity Cursor

Stock charts have also been improved to support better rendering when using the optional Y-Series grouping feature. Now sub groups are rendered side by side as illustrated below.

Stock Chart Grouping

BIRT has supported using images for makers for some time now, but with this release you can now specify the marker image which will then be embedded into the chart model.

Marker Images

In order to allow the developer to control how a chart is presented, the model has been altered to allow a fixed point of thickness for the both the X-axis and Y-axis labels. This should allow users to line up multiple charts within the same report.

Chart Axis Label Span

In addition the chart APIs have been changed to accommodate setting the scaling factor’s for the x and y axis. More information on this feature is available here. Changes were also made to the API to support right mouse click trigger events for charts that are rendered to SWT or Swing.

Designer Improvements: Resource Folder setting improvements

Many changes have been made to the designer in the way of usability and features. Some of these key features are described below.

BIRT uses a resource folder for storing images, external scripts and report libraries. The resource folder works as a common area for a project to share content across reports. When the Web Viewer is deployed the resource folder is configurable within the web.xml for the application. In this milestone the design time preference for the resource folder has been enhanced to support setting this folder to either a workspace folder, system folder or an Eclipse variable.

Resource Folder Setting

As with previous releases of BIRT the resource folder can be configured on a project basis, supporting multiple projects within one workspace.

The property editor has been improved to support resetting default properties and added support for listing properties by alphabetical, local, or grouped categories.

Property Editor

508 Properties and Diagonal lines

In an effort to continue to better support 508 compliance, three new properties are now available on table cells (headers, scope, and bookmark).

508 Properties

More information on this feature is available here.

In addition to the above advanced parameters, the engine now provides support for adding diagonal lines to cell containers.

Diagonal Lines

The engine has also been enhanced to support more precise rendering when setting the height field for a report item and the report is using the fixed layout option. This feature applies to label, text, image, and chart report items.

Duration Script Functions

Often applications use a duration data type to specify time intervals. With previous releases of BIRT, developers needed to call JavaScript or Java functions to manipulate this data to be used within a report. With the M6 build, the expression builder now provides a set of functions to manipulate a duration string.

Duration Functions


Many other features are available with this build, including support for aggregating derived measures within a crosstab, better support for the ‘avoid’ property within page break settings, and master page border support.