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:
- Open the BIRT perspective by clicking .
- Create a new report:
- Click .
- Specify the file name for the report. Optionally, you can change
the directory where the report is saved. Click Next.
- Specify the report template to copy and click Finish.
- Create a new ClearQuest data source (which is equivalent to a ClearQuest
schema repository name):
- Click the Data Explorer tab.
- Right-click the Data Sources folder and
select New Data Source. The New Data
Source wizard opens.
- Select ClearQuest Query Data Source.
- Type a name for the data source.
Tip: Use
the ClearQuest schema repository name.
- Click Next.
- Type your user name and password, and select the schema repository
and database names.
- Verify the connection to the ClearQuest data source by clicking Test
Connection.
- Click Finish.
- Create a new data set (which is equivalent to a ClearQuest query)
based on the data source:
- Right-click the Data Sets folder and
select New Data Set. The New Data
Set wizard opens.
- Type the data set name.
Tip: Specify
a name that corresponds to the associated ClearQuest query name. For example,
Public Queries_All Defects.
- Select the data source.
- Ensure that the data set type is ClearQuest Query
Result and click Next.
- In the ClearQuest Queries list, select
the query on which to report.
- 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.
- To add the data set to the report layout, right-click the data
set and select Insert in layout.
- 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.