Configuration¶

Maps tab¶

The Maps tab lists of all maps created in the project workspace.

Map settings

The box at the top of the page provides options to sort the list of maps by name or by last modification, and to filter which maps are displayed based on a string.

For each map, there is a small preview of the map, which will open the map for styling and viewing when clicked. Details about the map are displayed beside the preview, including the number of layers, the spatial reference system used in the map, and how recently the map was modified.

Three other buttons are found below the map details:

• The gear icon brings up the Map Settings page.
• The link icon brings up a traditional GeoServer Layer Preview of the map.
• The js icon brings up an OL3 Export dialog, for embedding the map in a web page.

Map details buttons

The Map Settings page allows details about the map to be entered:

• Map Name, for the name of the map used in URLs

• Title, for the human-readable name of the map

• Projection, for the spatial reference system of the map

• Extent, for the default region visible when rendering the map.

• Generate Extent, to calculate the max extent based on the map contents. This can be useful when changing between projections with different units.

• Description, for long-form information about the map

• Render Timeout, for canceling long-running map requests when styling the map.

  Note

  If a map request exceeds its timeout, a partial image may be returned.

Layers tab¶

The Layers tab shows all of the layers contained in this project workspace.

Layers tab

As with the Maps tab, the list of layers can be sorted by name or by last modification, and can also be filtered using a string.

Layers listed on this page can be added to a map by clicking them, selecting a map in the Select a map dialog, and then clicking the Add to Map button.

For each layer, details are shown, including:

• Layer thumbnail
• Geometry type, as indicated by an icon
• Number of attributes, which when clicked will show details
• Last modified date

There are also three links associated with each layer:

• Style, to edit the style and view the layer.
• Settings, for configuring details about the layer
• Copy, for duplicating the layer (publishing again)

The layer details popup (from the Settings link) allows you to set the layer name, title, spatial reference system (SRS), and description. There is also a direct link to the GeoServer Admin Edit Layer section, and an option to unpublish the layer if desired.

Layer Settings

The Copy link brings up a very similar dialog to the Layer Settings, used to publish a copy of the layer as a new layer in GeoServer.

Copying to a new layer

Data tab¶

The Data tab shows information about the underlying data sources for the project workspace. Any layers published in this project workspace will have an associated data source shown here.

Data tab

Similar to the Maps tab and Layers tab, the list of data sources can be sorted by name or by type, and can also be filtered using a string.

Each data source listed can be Enabled or Disabled by clicking the appropriate button. There is also the option to Delete the data source, in which case all associated layers will also be deleted (and all those layers removed from associated maps).

In certain data sources, one or more resources may be available, and these are shown on the right side. (For example, a PostGIS database may have multiple spatial tables, all of which can be published as layers). Each resource will be indicated as either Published or Unpublished. Clicking this indicator will show the layers associated with this resource (if any).

The list of resources can be sorted by name or published status, and can be filtered using a string.

Selecting a source¶

There are two options for the type of data that can be added to GeoServer: Spatial files and Databases.

Spatial files such as shapefiles or GeoTIFFs can be added to GeoServer. Certain extensions may add support for additional file types; clicking the information icon (i) will display the list of file types currently supported.

You can click Browse to select one or more files, or drag and drop any number of files onto the dialog. For multi-file formats such as shapefiles, all files should be included in the import.

If you already have a store defined in the current workspace, you can choose to import the selected files into an existing store rather than creating a new store.

Import data from files dialog

Once selected, clicking Upload will upload the data to the server.

Clicking Load will show the resources contained in the upload (and the resulting layers available for import). From here, you can select resources to add to GeoServer and publish as layers, add imported layers to an existing map, or create a new map.

Options for a newly uploaded layer

Databases may also be connected to GeoServer. Specifically, the following databases are supported:

• PostGIS
• GeoPackage
• H2

Support for additional databases can be enabled by installing the appropriate extension.

Importing a database

Click the desired database to bring up a form. You will need to supply connection parameters for the specific database.

Once the form is filled out, click Connect to test the connection to the database. If successful, you will have the option of selecting resources to be added to GeoServer and published as layers. These layers can be added to a new or existing map, just like above.