Linking a Git commit to a work item from Gitweb

You can link a Rational Team Concert™ work item and a Git commit from Gitweb.

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

With the Gitweb interface, you can create linkages between Git commits and existing Rational Team Concert work items. You can also create new Rational Team Concert work items and links from Gitweb.

A commit can be linked to multiple work items and a work item can be linked to multiple commits.

Procedure

Use these steps to link a Git commit to a Rational Team Concert work item from Gitweb.

  1. View a change in the Gitweb interface and open the twistie next to Work Item Links.
  2. Click Add Link in the expanded Work Item Links section.
  3. From the Add Link dialog, you can 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 Git adapter that is installed in Gitweb interface. The Add link dialog is open.
    • If you are creating a link to an existing work item, select Link to Existing and locate the Rational Team Concert work item to link to. Select the work item and click OK to create the link.

      Screen capture of gitweb main screen with add or create link window open

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 Git commit. You can traverse to the Git commit by clicking the link.

Feedback