This documentation is archived and is not being maintained.

How to: Find Changesets to Link to Work Items

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. If you are using Team Foundation version control, Team Foundation allows you to search for the changeset.

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, and Read permissions set to Allow. For more information, see Team Foundation Server Permissions.

To find a changeset in which to link a work item

  1. Open the work item to which the changeset relates.

  2. Complete any required fields at the top of the form, for example, if you are resolving the work item at the same time.

  3. On the Links tab at the bottom of the form, click Add.

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

  5. Under Link Details, click Browse.

  6. In the Find Changesets dialog box, you can search for changesets in the following manner:

    • Containing file   In the Containing file box, type the file name. You can also click the Browse button to search for the file.

    • By user   In the By user box, type the name of the team member.

  7. Under Range, select which changesets to search for the file and/or user name that you have specified:

    • All changes   Searches all changesets.

    • Changeset number   Searches for changesets that are in a specific range of changeset numbers. Select Changeset number and then enter the range of changeset numbers to return.

    • Created date   Searches for changesets that were created during a specific time period. Under Created date, enter a starting and ending date to search between.

  8. To start searching for changesets, click Find.

  9. Under Results, select the changeset that you want, and then click OK.

  10. Under Comment, type any comment that is important about this particular link.

  11. Click OK.

  12. Click Save to save the work item.