How to: Link Work Items to Changesets

When you check in the files that you have changed to complete a work item, you might want to add a link to the changeset for that work. This allows you to track what files were involved in completing the work item.

Required Permissions

To perform these procedures, you must be a member of the Contributors group or have the View work items in this node, Edit work items in this node, Read, Check In, and Check Out permissions set to Allow. For more information, see Team Foundation Server Permissions.

  1. Submit a change to Team Foundation source control, and make a note of the changeset number. You can find the changeset number by right-clicking on a file and choosing View History. In the History pane, look for the most recent change and find the corresponding number in the Changeset column.

  2. Open a work item and then click the Links tab.

  3. Click Add.

  4. In the Add Link dialog box, in the Link type list, select Changeset.

  5. In the Changeset box, type the changeset number. If you do not know the changeset number, click Browse to search for a changeset.

  6. In the Comment box, type a short comment about how the changeset is related to the work item.

  7. Click OK.

  8. Save the work item to save your changes.

See Also

Tasks

How to: Find Changesets to Link to Work Items
How to: Add New Work Items
How to: Edit Work Items
Walkthrough: Adding Links and Attachments to Work Items
How to: Associate Work Items with Changesets

Concepts

Working with Source Control Changesets