Linking a Gerrit change to a work item from the Gerrit web client

You can link a change to a Rational Team Concert™ work item from the Gerrit web client.

Before you begin

Git projects must be registered with the adapter and associated with one or more Rational Team Concert project areas. All configuration is done when the adapter is installed on the server. No further configuration is required to your local environment to use the adapter.

About this task

From the Gerrit web client, you can create links between Gerrit changes and new or existing Rational® Team Concert work items.

A Gerrit change can be linked to multiple work items and a work item can be linked to multiple Gerrit changes.

Procedure

Use these steps to link a Gerrit change to a Rational Team Concert work item from the Gerrit web client.

  1. View a change in the Gerrit web client and open the twistie next to Work Item Links.

    screen shot of Rational Adapter for Git on Gerrit change page for Gerrit web interface

  2. Click Add Link in the expanded Work Item Links section.
  3. From the Add Link dialog, you can choose to create a new work item and link the commit to it, or link the commit to an existing work item.
    • If you are creating a new work item, select Create New. Specify values for the dialog fields and click OK to create the new work item and link.image of create new change request dialog
    • If you are creating a link to an existing work item, select Link to Existing. Specify values for the dialog fields and click OK to create the link.

      screen shot of Gitweb with Rational Adapter for Git installed and Add Link dialog open to show Link to Existing fields.

Results

When you expand the Work Item Links twistie, the new link is listed.

  1. Click the link to open the work item in the Rational Team Concert web client.
  2. Click the Links tab there to see the link to the Gerrit change. You can traverse to the Gerrit change page by clicking on the link.

Feedback