Add Space

The Add Space Location dialog lets you add a space reference to your workspace. A space reference can be added in two different ways:

Entering the Space Address using the form

The form has the following controls:
Space Provider
A combobox that lets you select the wanted provider. A list of providers available in your IDE (i.e. space provider plugins that you have added).
User
The username/account name. If the provider allows the username to be an email address a @ can be entered followed by the email domain. This field may be disabled if the provider does not use this part of the address.
Host
The host where the space is located. This field may be disabled if the provider does not use this part of the address.
Port
The port on the host where the service provider makes the service available. This field may be disabled if the provider does not use this part of the address.

Entering the Full Space Address URI

A space reference is entered in the form of an Universal Resource Identifier (a URI) on the form spaces:providerScheme://authority/path, where:
spaces
specifies that this is a reference to a space
providerScheme
specifies the adapter/technology fo accessing the space
authority
specifies the user and host (and optional port) where the space is to be found. The authority is either the standard server based type authroization on the form user@host[:port], or an extended form where the user part is entered as an email address, followed by a comma, and an additional host name (i.e. user@mailhost,host[:port]. The :port is optional, but if used, should be an integer value.
path
The path to the space. Some service providers only allow single level paths, but others like the "local" space provider that serves spaces from your local disk allows you to specify a regular file path.

Credentials

Most space providers require credentials (i.e. login/password). Spaces makes use of the Eclipse keyring system to store credentials. If you enter the credentials when adding the space, you do not need to enter them each time the space is accessed. Enter the login and password that applies to your account at the selected address.

Options

In this section you can specify what to do if the space you are adding a reference to does not exist. You can also specify how you want to handle associated source.

Some space providers may allow you to request a space simply by providing a new space address with an optional "create" flag. This option is presented if the space provider supports this.

Some space providers may allow you to associate a source repo location with the space. If this option is available you can set the repo type and location when you create a non existing space. (A choice was made to only allow association of source repo location on creation of a space when using the add space dialog to prevent accidental overwrite if you share the space with someone else). To change the repo location after the space has been created, you can edit the space's properties.

Here is an explanation for the options under "If the space does not exist":

Warn
Display a warning, and do not add space location to catalog
Keep anyway
Add it to catalog even if space does not exist (address must still be well formed, but may not be fully validated if the required space provider plugin for the specified provider scheme is not installed).
Create without associated source
Creates the space and does not associate a source repository with the space. This is also the option to use if the space provider offers creation of spaces, but provisions source repository in an automated fashion.
Create with associated source
Creates the space and stores an associated source repository location in the space. When selecting this option, also enter the source repository type (CVS or SVN) and enter a valid repository location URI. (The browse button will help you select a source repository location from what is in your team SVN or team CVS repository list in your workspace.)

If the space you are adding to the space catalog has associated source, you can specify if you want to have it added to the team SVN or team CVS source repo locations in your workspace. After it has been added to your list of locations, you can check out what you need using the standard CVS/SVN functionality.