Managing Non-relative Paths (.NET Only)

If you have files in your solution/project that are located on a path that is not beneath the root directory of your solution, you must map this non-relative path to a folder in the StarTeam Server before you can check in the files.

Note: If you open a project previously configured to connect to a StarTeam Server, and the StarTeam Visual Studio Plugin cannot find your StarTeam Server, an informational dialog opens alerting you that no server in your server list matches the host name and port, and prompting you to indicate a new server name and port. Click Yes in the dialog to set up your connection to the server configuration. This action opens the StarTeam Server dialog box enabling you to configure the server settings.
  1. Choose StarTeam > Manage Associations from the main menu or the Solution Explorer context menu. The Manage Associations dialog opens.
  2. Click Manage Non-relative Paths. The Manage Non-relative Working Paths dialog box opens where you can map the non-relative local working path to a folder in the StarTeam repository.
  3. Click Add, browse to and select the (non-relative) folder that you want to map, and click OK. The Select A StarTeam Folder dialog box opens.
  4. Select a StarTeam folder for storing files from a given non-relative path, and click OK. If necessary, you can create child folders in the Select A StarTeam Folder dialog box. The folder for files in non-relative paths must be outside the root folder path for the solution. For example, if your local working path for your solution project is C:\ Project1 and it maps to the folder path BDS\Project1 in View1 in the repository, then any files in non-relative paths cannot be mapped to View1 \BDS\Project1 or its child folders. Therefore, if you add a file, logo.bmp that is stored locally in C:\images, you cannot map the working path to BDS \Project1\images or any other folder beneath BDS\Project1, but you can map it to BDS\images.
  5. Click Close to close the Manage Non-relative Working Paths dialog box.
  6. Click Close to close the Manage Associations dialog box.
Once you have mapped the non-relative path, files that are part of your solution/project and located in this local working path can be checked in to StarTeam. Use the Working Path and Folder Path buttons in the Manage Nonrelative Working Paths dialog box to modify any previously-mapped settings.