Loading or unloading a repository workspace

Load the contents of a repository workspace into a local Eclipse workspace so that you can work with project contents. Unload the workspace when you no longer need local copies of the projects it contains.

About this task

When you create a new repository workspace, you are given the option to load it immediately. You can also load a repository workspace, or unload it, at any time. Loading a repository workspace copies all of the components in it into the Eclipse workspace, or into the sandbox, associated with your current repository connection. When you unload a workspace, you can choose to leave the local copies of the files in your workspace or sandbox and disconnect the projects from Rational Team Concert™ source control, or delete all of the projects from your Eclipse workspace or sandbox, including files that you created but never checked in.

To load or unload a repository workspace, right click the repository workspace in the Team Artifacts or Pending Changes view and the select Load, Load As, or Unload. Selecting Load starts a Load Wizard that helps you specify what to load and how to load it. Selecting Load As starts a Load Wizard that loads the repository workspace to any local folder that you specify.

Procedure

On the Load repository Workspace page, choose how to load projects or selected resources in them into your Eclipse workspace.
- To load repository workspace contents as individual Eclipse projects, select Load the root folders of the components as projects. Click Next to choose projects to load or to specify the location of the sandbox to use, or click Finish to load all projects into the Eclipse workspace.
- To search the repository workspace for Eclipse projects to load, select Find and load Eclipse projects. Click Next to choose projects to load or to specify the location of the sandbox to use, or click Finish to load all projects into the Eclipse workspace.
- To browse components and select individual folders to load, select Browse the components to select the folders to be loaded and click Next.
- To leave the Eclipse workspace unloaded, select Do not load anythingand click Finish. The repository workspace will be listed in the Pending Changes view. You can load it later if you want.
On the Repository folders to load page, choose folders to load. Optionally, under Advanced Options, you can specify a local folder to use instead of the Eclipse workspace. The Load Wizard reports overlaps when a selection includes a folder that is contained by a folder that is already selected for loading. You cannot load a folder selection that includes overlaps.
When any overlaps have been removed, click Finish.

Results

The selected projects or folders are loaded into your Eclipse workspace or sandbox.