This section describes how to view and configure workspaces. Analogous to a namespace, a workspace is a container which organizes other items. In GeoServer, a workspace is often used to group similar layers together. Layers may be referred to by their workspace name, colon, layer name (for example
topp:states). Two different layers can have the same name as long as they belong to different workspaces (for example
Add a Workspace¶
The buttons for adding and removing a workspace can be found at the top of the Workspaces view page.
To add a workspace, select the Add new workspace button. You will be prompted to enter the workspace name and URI (as described in Edit a Workspace below).
Remove a Workspace¶
To remove a workspace, select it by clicking the checkbox next to the workspace. Multiple workspaces can be selected, or all can be selected by clicking the checkbox in the header. Click the Remove selected workspaces(s) button. You will be asked to confirm or cancel the removal. Clicking OK removes the selected workspace(s).
Edit a Workspace¶
To view or edit a workspace, click the workspace name. A workspace configuration page will be displayed.
A workspace is defined by a name and a Namespace URI (Uniform Resource Identifier).
Name: The workspace name, may not contain whitespace.
The workspace name is used as an XML prefix for the Namespace URI when generating xml documents.
The workspace name is used as a prefix when naming individual layers (unless Default workspace is used as described below).
Namespace URI: A URI is similar to a URL, except URIs do not need to point to an actual location on the web, and only need to be a unique identifier.
For a Workspace URI, we recommend using a URL associated with your project, with perhaps a different trailing identifier. For example,
http://www.openplans.org/toppis the URI for the “topp” workspace.
Default Workspace: One workspace can be nominated as the default.
Layers belonging to the default workspace can be accessed directly, and do not require the workspace name as a prefix.
A GeoServer configured with one workspace can use this setting to avoid using the workspace name when referencing layers. Keep in mind the workspace name will still be used in the generation of xml documents (where the name is used as an XML prefix to reference the workspace Namespace URI).
Isolated workspace: Isolated workspaces content so they are not included as part of global web services.
The workspace contents will only be visible and queryable in the context of a Virtual Services as described below Isolated Workspaces.
Use the checkbox located next to each service to override the global service definition for the associated service.
Once enabled clicking on the service link will open the settings page for the service, allowing default values for service title, abstract and other details to be supplied.
Clients accessing this workspace as a Virtual Services will use the service metadata and settings provided here.
Use Enabled checkbox to override the global configuration and contact information for this workspace.
Clients accessing this workspace as a Virtual Services will use the contact information provided here.
Organization contact information:
The Welcome message is used as an introduction in the welcome page header for this workspace.
The Organization name and Online Resource are combined to form an organization link in the welcome page header for this workspace.
Primary contact information:
The email address if provided, will be used as the administrator contact in the welcome page footer for this workspace.
Address contact information:
If this information is not provided the contact information from the global Contact Information page is used.
Other settings provide additional Global Settings can be overridden on a workspace-by-workspace basis.
Include Layer Prefix in Local Workspace Capabilities: Enable this setting to force the inclusion of the workspace name as a prefix when accessing workspace contents as a virtual web service. The layer
ne:countriesis always referenced as
ne:countrieswith this setting enabled.
With this setting disabled layers may be referenced directly (with no prefix) when accessed by a virtual web service. The layer
ne:countriescan be referenced as
countrieswhen this setting is disabled (and the layer is being accessed via a
nevirtual web service).
Root Directory for REST PathMapper: setting used by the RESTful API as the Root Directory for uploaded files, following the structure:
This parameter is only used when the Enabled parameter of the Settings section is checked.
If this information is not provided the global settings will be used. For details on other settings see Global Settings.
The Security tab allows to set data access rules at workspace level.
For more information on data access rules, please see the section on Data.
To create/edit the workspace’s data access rules, check/uncheck checkboxes according to the desired role. The Grant access to any role checkbox grant each role for any access mode.