This brief tutorial walks you through building a simple report with BIRT. It introduces the major UI features, and many of the BIRT reporting elements. At the completion of this tutorial, you should be able to start building your own reports using your own database.

We'll create a simple customer listing report, with the customers grouped by state and city. For each customer, we'll display a name and phone number.

Install BIRT

If you have not yet done so, install Eclipse, GEF, EMF and BIRT. You'll find complete instructions for doing so on the BIRT Install page.


BIRT is a perspective within Eclipse. To open it, use the Window item on the Eclipse main menu. Choose Open Perspective, then Report Design. If report Design does not appear directly in the Open Perspective window, then choose Other... A list of perspectives will appear. Choose Report Design.

Eclipse will switch to display the BIRT perspective.

Example Report

If you get stuck as you work through the tutorial, or if you want to see the finished report right away, simply download it:

  • Use your browser to download the report: customers.rptdesign.

  • Save the file into an Eclipse project directory. (See the next page if you don't yet have a project.)

  • Your browser may store this as an XML file. If so, rename it back the the name above.

  • Within Eclipse, select your project in the Navigator view and choose Refresh from the right-click context menu.

  • Double-click the report to open it in the BIRT report designer.

Next: Creating a Report >>