Associating records and Rational Team Concert work items

Use the Rational® ClearQuest® Web client to associate a ClearQuest record and Rational Team Concert work items while modifying an existing record or submitting a new one.

Before you begin

These instructions apply only to Rational ClearQuest Web environments configured with the ClearQuest OSLCLinks package. You can determine if the OSLCLinks package is applied to your schema by the appearance of a Links tab in a record display.

Procedure

Using the Rational ClearQuest Web client, modify an existing record or submit a new one.
Click the Links tab.
To associate the record with an existing work item, click the arrow in the Add list, select a "Related To" link type (for example, Related Change Request), and select the Rational Team Concert project area where the existing work item is located.
1. To find a work item by using a keyword or the work item number, follow these steps:
  1. In the Work Item window, select Search by Keyword or Work Item Number.
  2. From the Type menu, select the work item type to narrow your search, or accept the default. The default shows all work items that meet the search criteria that you specify in the next step.
  3. In the Work Item Number or Words Contained in the Text field, enter either a work item ID or text. The search begins as you start typing characters in this field.
2. To find a work item by running an Rational Team Concert query, follow these steps:
  1. In the Work Item window, select Search by Query.
  2. In the Select a query from the tree below field, select a query to run.
3. In the Matching Work items field, select the work item to associate with the record.
4. Click OK. The Work Item window closes and the work item link displays in the Links control under the Related Change Requests heading.
To create and associate a new work item, click the arrow in the Add list, click New Related Change Request, and select the Rational Team Concert project area where you want to create the work item.
1. In the New Related Change Request window, select the type of work item to create and click OK.
2. Enter the required information in the work item template.
3. Click OK. The work item is created and associated with the Rational ClearQuest record. The work item link displays in the Links control under the Related Change Requests heading.
Move your mouse pointer over a work item link to see a summary of the work item.
Click the work item link to open the associated work item in the Rational Team Concert web client.