Use the Rational® Adapter
for HP ALM web application to associate an HP ALM test case with an IBM® Rational ClearQuest® defect.
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 link a failed test case in HP ALM to a defect
record in Rational ClearQuest by using the Rational Adapter for HP ALM
web application. A backlink from the defect to the test case is created
as part of the link process.
Procedure
- Using the Rational Adapter
for HP ALM web application, find the failed test case.
- Click Select on the toolbar of the Related
Defects section. The Create
Link window opens.
- Enter the required information:
- From the Project Association list,
select a project association (user database and schema repository).
- In the Search Key field, enter
some text that is included in the record or a unique part of the record
ID.
- Click Full Text or By
Unique Key to indicate the type of search to perform.
- Click Search. The page is updated
with the search results.

- In the search results section, select a ClearQuest record to link with the test
case, and click OK. The Create
Link window closes. In the Rational Adapter for HP ALM web application,
the link displays under the Related Defects section.

A link is created in the
test case and in the ClearQuest defect
record.
- While viewing the test case in the Rational Adapter for HP ALM application,
move your mouse pointer over the defect link. A
summary of the defect displays.
- Verify the link in the ClearQuest defect
record.
- Using the Rational Adapter
for HP ALM, click the defect link in the Related Defects section
of the test case. The record is displayed in the ClearQuest web client.
- Click the Links tab. Notice the
link to the test case under the Related Test Case heading
of the Links control.
- Optional: Verify the link in the test case. Using the Rational Adapter for HP ALM
web interface, click Launch HP ALM.