Associating work items with changesets

When you check in a file to TFS you have the option to link a work item to that file. You may be adding a set of files which resolves a particular feature request, or you may be checking in a single file which fixes a bug. Check-ins can almost always be associated with some item in a well designed and integrated WIT repository.

Work items can be viewed in the Pending Changes view under the Work Items tab. To retrieve a list of work items into this view you must first select a query.

To create a link between a work item and changeset:

  1. In your Eclipse resource view right-click the file you want to check-in with a work item association. Select Team > Check In...

  2. In the Pending Changes / Source Files view the check box to the left of the item pending check-in should be checked; if it is not, check it now and uncheck the boxes next to any items you do not want to check in. If you wish to associate more than one file with a work item, check all boxes of files that apply. Click the Work Items tab.

  3. Locate the work item(s) you wish to associate with your pending check-in and create a link by checking the check box. In the Check-In Action column activate the drop-down menu and select one of the available options. In our example the options are Resolve or Associate. Note: These values depend on how your work item types are customized in TFS. When you complete the check in by clicking the check-in icon, the work item becomes linked to the changeset. See Viewing History for more information on viewing work items in changesets.


Related Tasks:

Viewing work items
Querying the work item repository
Checking in files
Managing work items from the Team Explorer view