Use the IBM® Rational® ClearQuest® web client to associate ClearQuest change requests
or enhancement requests with HP ALM defects.
Before you begin
These instructions apply only to ClearQuest web environments that are configured
with the OSLCLinks package. You can determine whether the OSLCLinks
package is applied to your schema by the availability of the Links tab
in a displayed record. The instructions assume that you configured
cross-server communication and project relationships between the ClearQuest web server and
the HP ALM web server, described in Technote 1580379.
About this task
You can use the ClearQuest web
client to link a change request or enhancement request record with
an HP ALM defect. Creating this association is useful when your test
team manages test cases and defects in HP ALM. In parallel, another
team in the business uses Rational ClearQuest for change management.
Important: A defect must exist in HP ALM to use the ClearQuest web client to
associate a ClearQuest record
with an HP ALM defect. You cannot create an HP ALM defect from the ClearQuest web client.
Procedure
- Using the ClearQuest web
client, modify an existing record or submit a new one.
- Click the Links tab.
- To associate a ClearQuest record
with an HP ALM defect, click the arrow in the Add list,
click Related Change Request, and select the
HP ALM project where the defect is located. The Select
Defect window opens.
- Enter the required information:
- In the Search field, enter a
change request ID or words that the change request name contains,
and click Search. The search
results display in the results list.

- Optional: Click My assignments only to
filter on your defects.
- Select the defect that you want to link to, and click OK. The Select Defect window closes.
The defect link displays on the Links page of
the record, under the Related Change Request heading
in the Links control.

- Move your mouse pointer over the HP ALM defect link to
see a summary of the defect.
- On the ClearQuest web
client toolbar, click Save to save the link
in the record and the backlink in the HP ALM test case.
- Verify the backlink in the HP ALM defect by completing
these steps.
- Using the ClearQuest web
client, click the defect link to open the defect in the Rational Adapter for HP ALM web application. Notice the backlink to the ClearQuest record in the Related
Change Requests section.
- Optional: Verify the backlink directly in the HP ALM
application. Using the Rational Adapter
for HP ALM web application, click Launch HP ALM.