Tool Mentor: Viewing the History of a Defect Using Rational ClearQuest

Purpose

This tool mentor describes how the Rational ClearQuest administrator can set up the ClearQuest defect form to include a History control that enables ClearQuest users to view and track the history of defects.

This section provides links to additional information related to this tool mentor.

• Report on Configuration Status
• Verify Changes in Build
• Review Change Request

Overview

Records move through a lifecycle, from submission toward resolution. In ClearQuest, each stage in this lifecycle is a “state”, and each movement from one state to another is called a “state transition”.

Within the ClearQuest client, you can view the history of a record. This history of a record includes the date actions occurred (such as moving to the next state or making a modification), the user name, the action name, the old state, and the new state.

1.  Viewing the History of a Defect

The Rational ClearQuest administrator can customize the ClearQuest schema to display the history of records.

See ClearQuest Designer online Help > Contents and Index > Working with Schemas >.

The View History command displays the changes in the state of a record and the dates on which the changes occurred. The contents of the View History dialog are read-only.

To view the history of a record, a user performs these steps:

1. Run a query that includes the record.
2. In the Result set tab, select the record.
3. From the menu bar, choose View > History.
4. To close the dialog, click .

2.  Adding a History Control to a ClearQuest record form

ClearQuest Designer enables the ClearQuest administrator to create customized forms for submitting, viewing, and modifying records.

See ClearQuest Designer online Help > Contents and Index > Working with Record Forms.

The ClearQuest administrator can include a history control on a form to display the state transitions of the record.

1. Check out the schema

See ClearQuest Designer online **Help > Contents and Index > Working with Schemas

Checking out a Schema**.

2. Add a history control to the form

See ClearQuest Designer online Help > Contents and Index > Working with Forms > Creating and Modifying Forms > Working with Form Controls > Adding Controls to a Form.

3. Check in the schema

See ClearQuest Designer online Help topics:

• **> Contents and Index > Working with Schemas

  Checking in a Schema**

• **> Contents and Index > Working with Schemas

  Validating Schema Changes**

4. Upgrade the databases

See ClearQuest Designer online Help > Contents and Index > Managing Databases.