Linking ClearQuest records with HP ALM defects

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

  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 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.
  4. Enter the required information:
    1. 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.

      Image of the Select Defect window with the search results list displayed

    2. Optional: Click My assignments only to filter on your defects.
    3. 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.

      Image of the Links page of the ClearQuest defect with the defect link displayed under the Related Change Request heading of the Links control

  5. Move your mouse pointer over the HP ALM defect link to see a summary of the defect.
  6. On the ClearQuest web client toolbar, click Save to save the link in the record and the backlink in the HP ALM test case.
  7. Verify the backlink in the HP ALM defect by completing these steps.
    1. 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.
    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