Linking ClearQuest change requests with HP ALM test cases

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

  1. Using the ClearQuest web client, modify an existing record or submit a new one.
  2. Click the Links tab.
  3. 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.

    Image of the Add Link: Tested By Test Case window

  4. Enter the required information.
    1. Select a remote repository from the Select a Remote Repository list.
    2. Click Link to Existing.
    3. 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.
  5. 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.

    Image of the Select Test Case window with the search results

  6. 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.

    Image of the Links page of a ClearQuest record, displaying the HP ALM test-case link under the Tested by Test Case heading of the Links control

  7. Move your mouse pointer over the link to see a summary of the HP ALM test case.
  8. On the ClearQuest web client toolbar, click Save to save the link in the record and the backlink in the HP ALM test case.
  9. Verify the backlink in the test case by completing these steps:
    1. 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.
    2. Optional: Verify the backlink directly in the HP ALM application. Using the Rational Adapter for HP ALM web application, click Launch HP ALM.

Feedback