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 a full space address using a URI. This is useful when you get
the address from someone else.
- Entering each part of the URI in a syntax checked separate field and where
the resulting URI is constructed for you.
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.