Refresh Team Explorer

Some information may not update automatically when changes occur in Visual Studio Team Foundation Server, so you should refresh the team project data cache to guarantee that you are working with current data. For example, you should refresh your client application under the following circumstances:

  • Work item type definitions are added, removed, renamed, or updated.

  • Area or Iteration path nodes are added, removed, renamed, or updated.

  • Users are added to or removed from security groups, or permissions are updated.

  • A team member adds a team query, document, or report.

  • A team member changes the organization or names of team queries.

  • A team project is deleted.

  • You plan to move or delete shared items, such as a team query, document, or report. To avoid potential errors, you should refresh the area to be modified to ensure that it is up to date.

Nodes in Team Explorer do not update automatically when changes occur in Team Foundation Server. You should update nodes periodically to avoid potential errors. For example, if you are about to move or delete work item queries, you should refresh Team Explorer to be sure that it is up to date. Otherwise, you could attempt to delete or move a query that has already been deleted, which would return an error message.

You can refresh Team Explorer in three levels. You can refresh an individual plug-in node, an individual team project, or all team projects in Team Explorer.

Required Permissions

To perform these procedures, you must be a member of the Team Foundation Valid Users security group. If the necessary security permissions are set explicitly, your View server-level information permission must be set to Allow and your View project-level information permission on all open team projects must be set to Allow. For more information, see Team Foundation Server Permissions.

To refresh Team Explorer

  • In Team Explorer, perform one of the following tasks:

    • To refresh a node, right-click the plug-in node that you want to update, and then click Refresh.

      For example, if you are working in a team project that was created by using the process template for Microsoft Solutions Framework (MSF) for Agile Software Development, you can click the Work Items, Documents, Reports, Builds, or Source Control node.

      Note

      The nodes for Reports, Builds, or Source Control appear only if they were configured when the team project was created.

    • To refresh a team project, right-click it, and then click Refresh.

    • To refresh all team projects, expand the top-level node of each team project that you want to update, right-click the server name root node, and then click Refresh.

      Note

      If you do not expand a team project, you cannot refresh it.

See Also

Other Resources

Getting Started with Team Explorer Everywhere and Team Foundation Server