This documentation is archived and is not being maintained.

Associate Work Items with Changesets (Team Explorer Everywhere)

Visual Studio 2010

Some organizations create check-in policies that require you to associate each check-in operation with at least one work item. You typically associate work items with changesets to indicate the reasons for a code change. For example, if a code change represented by a changeset will fix several bugs, you would associate the changeset with those bugs. By doing this, if one or more of those bugs reoccurs, you can easily find the code change that you originally made to resolve that bug.

Required Permissions

To perform these procedures, you must have the Check in permission set to Allow. For more information, see the following topic on the Microsoft Web site: Team Foundation Server Permissions.

To associate work items with a changeset by using the Team Foundation Server plug-in for Eclipse

  1. In the Pending Changes window or the Check In dialog box, click the Work Items channel. For more information about how to check in pending changes, see Check in Pending Changes (Team Explorer Everywhere).

  2. You can use the Query list to specify a query, a list of work item IDs, a search, or even a WIQL (Work Item Query Language) statement to find a list of work items. By default, all work items in the current team project appear.

  3. In the Work Item list, scroll to locate the work items that you want to associate with the check-in operation, and select the corresponding check box.

  4. Under the Check-in Action column, from the drop-down list, indicate the action that you want associated with the work item. Click Associate to associate the work item with the check-in operation, or click Resolve to associate and resolve the work item when you check in.


    Depending on the state of the work item, the resolve option may not be available. For example, if a query displays closed bugs, you would associate the work item but not resolve it.

To associate work items with a changeset from a command prompt

  • To associate one or more work items with the changeset, specify the following command:

    tf checkin ItemSpec -associate:WorkItemIds

    In place of ItemSpec, specify the file or folder that you want to check in.

    In place of WorkItemIds, specify a list of work item IDs, separated by commas.