Using the BIRT Report Designer

This topic describes how to use the BIRT Report Designer to design data-pull reports.

The instructions in this topic are specific to using BIRT with the Rational ClearQuest Client. See the BIRT online help for instructions on using the report designer with the Rational® ClearQuest® Client for Eclipse.

To design a simple report with BIRT:
  1. Open the BIRT perspective by clicking Window > Report Designer.
  2. Create a new report:
    1. Click File > New > New Report.
    2. Specify the file name for the report. Optionally, you can change the directory where the report is saved. Click Next.
    3. Specify the report template to copy and click Finish.
  3. Create a new ClearQuest data source (which is equivalent to a ClearQuest schema repository name):
    1. Click the Data Explorer tab.
    2. Right-click the Data Sources folder and select New Data Source. The New Data Source wizard opens.
    3. Select ClearQuest Query Data Source.
    4. Type a name for the data source.
      Tip: Use the ClearQuest schema repository name.
    5. Click Next.
    6. Type your user name and password, and select the schema repository and database names.
    7. Verify the connection to the ClearQuest data source by clicking Test Connection.
    8. Click Finish.
  4. Create a new data set (which is equivalent to a ClearQuest query) based on the data source:
    1. Right-click the Data Sets folder and select New Data Set. The New Data Set wizard opens.
    2. Type the data set name.
      Tip: Specify a name that corresponds to the associated ClearQuest query name. For example, Public Queries_All Defects.
    3. Select the data source.
    4. Ensure that the data set type is ClearQuest Query Result and click Next.
    5. In the ClearQuest Queries list, select the query on which to report.
    6. Use the Edit Data Set dialog box to provide additional information about the data set.
      • If the query contains dynamic filters, you must configure the parameters.
      • You can preview the query result set by selecting Preview Results. Previewing the results ensures that the query runs without errors.
      • Click OK to save the data set.
  5. To add the data set to the report layout, right-click the data set and select Insert in layout.
  6. Complete the report layout. When you are done, click the Preview tab to ensure that there are no errors in the report design. The .rptdesign file is saved when you preview the report design.

Feedback