Find, Link, and View Changesets Associated with a Work Item (Team Explorer Everywhere)

When you make and check in changes to the code by using Team Foundation version control, you can associate the changeset with the work item that the changes address. A changeset lists the source files that you checked in for the changeset and a list of all work items that you linked to the changeset.

When you check in the files that you have changed to complete a work item, you might want to add a link from the work item to the changeset for that work. You can then track what files were involved in completing the work item. You can view the set of changesets that is associated with a work item, view the details of a changeset, and find changesets to link to a work item.

For more information, see Working with Changesets (Team Explorer Everywhere) and Associate Work Items with Changesets (Team Explorer Everywhere).

In this topic

• Viewing Changesets That Are Associated with a Work Item

• Linking a Work Item to a Changeset

• Finding a Changeset to Link to a Work Item

Required Permissions

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

Viewing Changesets That Are Associated with a Work Item

To view changesets that are associated with a work item

1. Connect to the team project collection that contains the team project where your work items are defined.

2. Open the form for the work item that you want to display.

3. Click the tab for managing links.

   Note

   The name of the tab might be Links, All links, or Implementation. The name of the tab is determined by the work item definition.

   Changeset items are listed with a Link Type of Changeset.

4. To view a specific changeset, right-click the link to that changeset, and then click Open. You can also click the link and then click Open.

   As the following illustration shows, the Details for Changeset window opens and shows the list of source files that are associated with the changeset.

   

5. (Optional) Click Work Items, Check-in Notes, and Policy Warnings to show more information.

6. Click Cancel to close the Details for Changeset window.

Linking a Work Item to a Changeset

To link a work item to a changeset

1. Submit a change to Team Foundation version control, and note the changeset number.

   You can find the changeset number by right-clicking a file and clicking 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, click the tab for managing links, and then click Link to.

   Note

   The name of the tab might be Links, All links, or Implementation. The name of the tab is determined by the work item definition.

3. In the Add Link dialog box, in the Link type list, click Changeset.

4. In Changeset, type the changeset number.

   If you do not know the changeset number, click browse (...) to search for a changeset. For more information, see Finding a Changeset to Link to a Work Item later in this topic.

5. In Comment, type a short comment about how the changeset relates to the work item, and then click OK.

6. On the File menu, click Save or press Ctrl+S.

Finding a Changeset to Link to a Work Item

To find a changeset to link to 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. Click the tab for managing links, and then click Link to.

   Note

   The name of the tab might be Links, All links, or Implementation. The name of the tab is determined by the work item definition.

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

5. Under Link details, click Browse (...).

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

   • In Containing file, type the file name.

     You can also click the Browse button to search for the file.

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

7. Under Range, specify in which changesets to search for the file, user, or both:

   • All changes Searches all changesets.

   • Changeset number Searches for changesets that are in a specific range of changeset numbers. Click Changeset number, and then type the range of changeset numbers to search.

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

8. Click Find.

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

   Note

   To display the details for a changeset, you can right-click a changeset and then click Changeset Details.

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

11. Click OK.

12. On the File menu, click Save or press Ctrl+S.

See Also

Tasks

Find, Link and View Source Code Files Associated with a Work Item (Team Explorer Everywhere)

Other Resources

Working with Changesets (Team Explorer Everywhere)

Associate Work Items with Changesets (Team Explorer Everywhere)

Create Relationships Between Work Items and Other Resources (Team Explorer Everywhere)