Linking HP ALM test cases with ClearQuest defects

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

  1. Using the Rational Adapter for HP ALM web application, find the failed test case.
  2. Click Select on the toolbar of the Related Defects section. The Create Link window opens.
  3. Enter the required information:
    1. From the Project Association list, select a project association (user database and schema repository).
    2. In the Search Key field, enter some text that is included in the record or a unique part of the record ID.
    3. Click Full Text or By Unique Key to indicate the type of search to perform.
    4. Click Search. The page is updated with the search results.

      Image of the Create Link window with the search results displayed

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

      Image of the test case that is displayed in the Rational Adapter for HP ALM, with the linked ClearQuest defect displayed under the Related Defects section

      A link is created in the test case and in the ClearQuest defect record.

  4. 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.
  5. Verify the link in the ClearQuest defect record.
    1. 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.
    2. Click the Links tab. Notice the link to the test case under the Related Test Case heading of the Links control.
  6. Optional: Verify the link in the test case. Using the Rational Adapter for HP ALM web interface, click Launch HP ALM.

Feedback