Open Projects from Version Control (Team Explorer Everywhere)

In Team Foundation, projects are stored in the Team Foundation version control server and are affiliated with a specific team project. The following procedures describe how to import projects into your Eclipse workspace, how to open projects from Source Control Explorer, or how to open version-controlled items from links attached to work items.

Note

After you open a solution or project in Team Foundation, you must check out the files associated with the solution before you modify them. For more information, see Getting a Local Copy of Files from the Version Control Server (Team Explorer Everywhere).

For information about how to import a project into your workspace in Project Explorer or Package Explorer, see Connect to Team Projects.

Note

In Team Explorer Everywhere 2010, you cannot open a linked source code file. The Open button in a work item remains dimmed if you select a versioned item link.

Required Permissions

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

Opening Files and Projects from Source Control Explorer

You can get a local copy of any files for which you have a specified a working folder. Getting a local copy of files does not add them to Project Explorer or Package Explorer. You must import projects for them to appear in Project Explorer or Package Explorer.

The following procedures assume that you have an Eclipse workspace that is connected to an instance of Visual Studio Team Foundation Server. For more information about how to create a workspace and establish that connection, see Connect to Team Projects.

To import projects from Source Control Explorer

  1. In Team Explorer, expand the team project that contains the projects that you want to import and double-click Source Control.

    Source Control Explorer appears.

  2. In the left pane of Source Control Explorer, browse to the folder that contains the projects that you want to import.

  3. In the details pane, right-click a project that you want to import, and then click Import.

    To import multiple Eclipse projects, highlight each project that you want to import. For Eclipse projects, you must select the folders that contain the .project file. The projects are not imported if you instead specify the parent folder.

    To highlight multiple project folders, you can hold down CTRL and then click the folders. You can highlight a range of folders if you hold down SHIFT and then click the first and last folder in the range that you want to import.

    The Import Project from Team Foundation Server dialog box appears.

  4. In the list of projects, verify that the selected projects are the projects that you want to import.

  5. (Optional) You can perform any of the following steps:

    • Click the Save button to export the specified Eclipse projects to an XML file.

      You can send that XML file to other users on your team, which might be useful if you must import many Eclipse projects into your workspace.

    • Click the Load button to import a list of Eclipse projects from an XML file.

    • Select the Add project to Working Set check box if you want to group related Eclipse projects in a container that is called a working set.

      This grouping affects only how Eclipse projects appear, not working folders.

    • Select the Show the New Project Wizard for folders that are not Eclipse Projects check box if you want to create an Eclipse project from each of those folders.

      The wizard only appears for selected folders that are not already Eclipse projects.

    • Select the Perform a Force Get Latest of files in the selected projects check box if you want to force a download of all items from the server, even if they already exist on the local file system. By default, the most recent versions of files are retrieved if they do not already exist on the local file system. You should only have to select this check box if you already have set working folder mappings for the specified folders in the Team Foundation Server workspace, but the local copy is somehow corrupted.

      Note

      You can always get the most recent version of your files after you complete the import operation. For more information, see Getting a Local Copy of Files from the Version Control Server (Team Explorer Everywhere).

  6. Click Next.

  7. On the Confirmation page, review the projects that you specified to import. If the list is correct, click Finish. If you must make corrections, click Back.

    The specified Eclipse projects appear in Project Explorer or Package Explorer.

To get a local copy of files from Source Control Explorer

  1. In Team Explorer, expand the team project that contains the files or Eclipse projects that you want to copy locally and double-click Source Control.

    Source Control Explorer appears.

  2. In the left pane of Source Control Explorer, browse to the folder that contains the files or Eclipse projects that you want to import.

  3. In the details pane, right-click a project that you want to copy locally, and then click Get Latest Version. You could also get a specific version by clicking Get Specific Version.

    To copy multiple projects or files, highlight each file or project that you want to import.

    To highlight multiple files or folders, you can hold down CTRL and then click them. You can highlight a range of files or folders if you hold down SHIFT and then click the first and last item in the range that you want to copy.

    A progress dialog box appears as the files are copied. When the copy operation is complete, the value of the Latest column updates to Yes.

  4. (Optional) Right-click the file and then click View or right-click a folder and then click View Local Folder.