This topic describes how to use the BIRT Report Designer
to design data-pull reports.
Before you begin
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.
Procedure
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:
- 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 and
click Next.
- Choose the location of the connection profile you want
to use to create your data source. Select My Default ClearQuest
Connections to use a connection profile on your local
machine, or select Change Management Server to
use a connection profile on a Change Management Server. If
you are using a connection profile on a Change Management server,
type the name of the server.
- 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.