Use the IBM® Rational® ClearQuest® web client to associate a ClearQuest change request
with an HP ALM test case. Perform this task while you modify an existing ClearQuest record or submit
a new record.
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 ClearQuest change
request or enhancement request to an HP ALM test case by using the ClearQuest web client. A
backlink from the test case to the ClearQuest record is created as part of
the link process.
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 a test case, click the arrow in the Add list,
click Tested By Test Case, and select the HP
ALM project where the test case is located. The Add
Link: Tested by Test Case window opens.

- Enter the required information.
- Select a remote repository from the Select
a Remote Repository list.
- Click Link to Existing.
- Click OK. The Add
Link: Tested by Test Case window closes. The Select
Test Case window opens in the Rational Adapter for HP ALM web application.
- In the Search field of the Select
Test Case window, enter a test case ID or words that the
test case name contains, and click Search. The search results display in the results list.

- Select the test case to associate with the record and click OK. The Select Test Case window closes.
The test case link displays on the Links page
of the record, under the Tested By Test Case heading
of the Links control.

- Move your mouse pointer over the link to see a summary
of the HP ALM test case.
- 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 test case by completing these
steps:
- Using the ClearQuest web
client, click the test case link to open the test case in the Rational Adapter for HP ALM
web application. Notice the backlink to the ClearQuest record in the Development
Items section.
- Optional: Verify the backlink directly in the HP ALM
application. Using the Rational Adapter
for HP ALM web application, click Launch HP ALM.