Loading repository workspaces

Load the contents of a repository workspace into a local Eclipse workspace so that you can work with project contents.

About this task

When you create a repository workspace, you are given the option to load it immediately. You can also load a repository workspace at any time. Loading a repository workspace copies all of the components in it into the Eclipse workspace, or into the sandbox, that is associated with your current repository connection.

To load a repository workspace, right click the repository workspace in the Team Artifacts or Pending Changes view and then select Load or Load As. 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. The local folder can be under source control.

You can also load repository workspace files into sandbox subfolders. This option allows you to load multiple repository workspaces within the same sandbox even if the repository workspaces contain the same components with different content. You can change the default setting on a project area, so that all workspaces that have a flow target that is a member of the project area can have the usage of subfolders during load turned on by default. The individual setting of the repository workspace overrides the default setting for the project area.

Note:
  • When you load a repository workspace, all the components are added as separate working sets in Eclipse. Working sets are created during a load operation. If you delete the contents of a component from the Eclipse client, any corresponding working sets must be deleted by using the Select Working Set window. For more information, see Working sets.
  • If you have multiple large repository workspaces loaded, and you are not actively working in all of them, you can untrack one or more of these repository workspaces that are not active. The reason to untrack a workspace is to improve performance in the Eclipse client for start-up and for actions such as Refresh in the Pending Changes view, since minimum information is retrieved for untracked workspaces. For more information, see Untracking or tracking repository workspaces.

Procedure

  1. 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 choose folders to load, select Browse the components to select the folders to be loaded and click Next.
    • To load from a load rule file, select Load from a load rule file and click Next. On the Load from load rule file page, specify the location of the load rule file. In the Advanced Options area, you can specify a sandbox to load. Click Finish.
  2. 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.
  3. Optional: To load component files into a subfolder, under Advanced Options, select Load component files into sandbox subfolder. You can specify the subfolder or use the default folder with the same name as the repository workspace.
    Note: Do not load Eclipse projects with the same name, even if the projects are loaded within different subfolders.
    Note: The subfolder option is off by default. After you set the option and select the subfolder, this setting is used for all future loads for that repository workspace. To change this setting (either turn it on/off or change a subfolder), unload the workspace and use the Load Wizard to change the setting when you load the workspace again.
  4. Optional: To use the timestamp file in the repository as the timestamp on disk, select Use file timestamps from repository for new files.
  5. When any overlaps have been removed, click Finish.
    Tip: To make a repository workspace visible in the Pending Changes view and to track it without loading it, right-click a repository workspace in the Team Artifacts view, then click Show > Pending Changes.
  6. Optional: To configure the default usage of loading component files into sandbox subfolders when loading repository workspaces that flow to streams in a project area:
    1. From the web client, open the Project Area and go to Source Control > Sandbox Subfolder.
    2. On the Source Control – Sandbox Subfolder page, select Load component files into sandbox subfolder when loading repository workspace.
    3. Save the changes.

Results

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