Template:WMS GUI Einstellungen

From MapbenderWiki

(deutsche Version weiter unten!)

English

Mapbender provides the module 'WMS GUI settings' to configure map services. That configuration is only available for the corresponding GUI, so the same service can be kept in different configurations.

After choosing a gui from the left selective list 'GUI', all map services will be displayed in the right selective list 'WMS-TITLE'.

Notice

the top map service in the list will be displayed (requested) first and for this reason it lies in the map at the bottom. The other services overlay each other in order of the list.

Change the position of the map service (layering) with the buttons 'up' and 'down'.

Remove a map service from a GUI with the button remove. The service itself is only removed from this GUI, but not completely from the system (see below).

After choosing a map service from a GUI an interface appears for further configuration of the service.

Open the capabilities document of the map service with this link. If the requested map server is available a new window will open with a click on the link <LINK: Capabilities>. Choose the spatial reference system underneath this link to make the start settings of the GUI. All spatial reference systems are shown within the list, which are provided by the server of the first loaded service.

Choose the format of the images (Rasterformat), in which the service should provide the map images from the field 'Mapformat'. Normally the format JPEG and PNG are used. Please notice that PNG (and GIF) support transparancy, the format JPEG doesn't.

The field 'Infoformat' defines how the map service provides alphanumeric data, standard is 'text/html'. Alternatively the results can be delivered of some server as a XML-document, if your client supports XML processing.

The field 'Exceptionformat' defines in which format error handling will be delivered. It is advisable to choose the format <inimage> or <application.vnd.ogc.se_inimage> depending on your WMS version, if Mapbender expects a map image but an error message of the requested map occurs. If the server has a problem it provides an image in the requested size, which is shown instead of the map in Mapbender.

Notice

The FeatureInfoFormat "text/html" is default in UMN MapServer and therefor it isn't listed in the formats of the capabilities. For this reason it has to be chosen explicit in Mapbender. Choose the format <inimage> or <application.vnd.ogc.se_inimage> as an exceptionformat.

In the following table the settings for the levels (layers) of the map service can be done.

Notice

1. The top level (No.0 / seperated with a line) affect the whole map service and shouldn't be changed.
2. The module to administrate the levels doesn't consider nested or grouped levels. Deactivate all subordinated levels for services, which contain levels in a GROUP. Click on the button <Sublayer off> to remove the sub-layers automatically from the layer scheme. After that is done for a requested map all layers of a group will be activated or deactivated together.

In generall all layers are numbered serially beginning from the top in the column 'No'. Recognize nested layers by the entry of a cipher in the column 'Parent'. It is an independent layer, if the cipher '0' is entered here (now it is subordinate to the whole WMS service). If there is a cipher higher than null, it references to the layer, which it is subordinated. Only this Parent-layer is activated or deactivated in the layer scheme.

Parent

Imagine that the layer No 2 got the parent No 1. That means that the layer No 2 is subordinate to the layer No 1 and will be deactivated by the Mapbender adminstration. Automatically all subordinated layers (here No 2) are also requested, if layer No 1 is activated.

Name

See the name of each layer in the column 'Name', which will be transmitted as <Name> in the Layer-section of the capabilities-document of the map service.

Title

See the title of a layer in the column 'Title'. This title will be transmitted to the Layer-section of the capabilities-document of the map service.

on/off

Define with the column 'on/off', if a layer of the map service will be displayed in the layer selection or won't. Here you can make the settings individually for each GUI and inependently from the service, which layers can or cannot be seen by the users.

sel

The column 'sel' defines, which layers can be activated or deactivated by the user. Here you can freeze layers, which can't activated or deactivated by the user.

Deutsch

Mit WMS GUI Einstellungen stellt Mapbender ein Modul zur Verfügung, um Kartendienste zu konfigurieren. Diese Konfiguration gilt lediglich für die entsprechende GUI, so dass Sie den gleichen Dienst in unterschiedlichen Konfigurationen vorhalten können.

Nach der Auswahl einer GUI in der linken Auswahlliste GUI werden in der rechten Auswahlliste WMS-TITLE alle Kartendienste dieser GUI angezeigt.

Hinweis

Der oberste Kartendienst wird als erster 'gezeichnet' (angefordert) und liegt demnach in der Karte unten. Alle weiteren Dienste werden in der Reihenfolge der Liste überlagert.

Mit den Schaltflächen up und down kann die Position (Schichtung) des Kartendienstes in der GUI verändert werden.

Die Schaltfläche remove ermöglicht einen Kartendienst aus dieser GUI zu entfernen. Der Dienst selbst wird dabei lediglich aus dieser GUI entfernt, aber nicht vollständig aus dem System gelöscht (siehe unten).

Nach der Auswahl eines Kartendienstes aus einer GUI erscheint eine Oberfläche, welche eine weitere Konfiguration des Kartendienstes erlaubt.

Das Capabilities Dokument des Kartendienstes kann über einen Link aufgerufen werden. Ein Klick auf <LINK: Capabilities> öffnet ein neues Fenster, in dem das XML-Dokument angezeigt wird, falls der angesprochene Kartenserver verfügbar ist. Unterhalb dieses Links wird das Koordinatensystem gewählt mit dem die GUI voreingestellt gestartet wird. Die Liste zeigt alle Koordinatensysteme, die der Server des ersten geladenen Dienstes enthält.

Über die Auswahl "Mapformat" wird das Rasterformat ausgewählt, in dem dieser Dienst seine Kartenbilder anliefern soll. Überlicherweise werden hier die Formate JPEG und PNG genutzt. Beachten Sie, dass PNG (und GIF) eine Tranparenz unterstützt, das Format JPEG dagegen nicht.

Das "Infoformat" definiert wie der Kartendienst alphanumerische Daten zurückliefern soll, im Normalfall wird hier text/html ausgewählt. Falls Ihr Client eine Folgeverarbeitung für XML Daten implementiert, kann die Ergebnisliste von manchen Servern alternativ auch als XML Dokument ausgegeben werden.

Das Exceptionformat definiert, in welchem Format Fehlerbehandlungen zurückgegeben werden. Da Fehlermeldungen statt des angeforderten Kartenbildes zurückgeliefert werden – Mapbender also ein Bild erwartet ist es zweckmässig hier je nach WMS Version das Format <inimage> oder <application.vnd.ogc.se_inimage> zu wählen. Sollte der Server auf ein Problem treffen liefert er ein Bild in der angeforderten Größe zurück, das in Mapbender statt der Karte angezeigt wird.

Hinweis

Der UMN MapServer sieht das FeatureInfoFormat „text/html“ als default an und listet es nicht in den Formaten der Capabilities auf. Daher muss es im Mapbender explizit ausgewählt werden. Als Exceptionformat sollte das Format <inimage> oder <application.vnd.ogc.se_inimage> ausgewählt werden.

In der folgenden Tabelle können Einstellungen zu den Ebenen des Kartendienstes vorgenommen werden.

Zuvor sollten jedoch zwei Punkte beachtet werden

1. Die oberste Ebene (Nr.0 / durch Linie abgetrennt) betrifft den gesamten Kartendienst und sollte nicht verändert werden.
2. Das Modul zur Ebenenverwaltung berücksichtigt keine geschachtelten bzw. gruppierten Ebenen. Für Dienste, die Ebenen in einer GROUP enthalten müssen deshalb alle untergeordneten Ebenen deaktivieren werden. Ein Klick auf den Button <Sublayer off> entfernt die Sub-Layer automatisch aus der Ebebenübersicht. In dem angeforderten Kartenbild werden danach immer alle Ebenen einer Gruppe gemeinsam aktiviert oder deaktiviert.

Generell werden alle Ebenen des Kartendienstes, beginnend von der Obersten, in der Spalte Nr. aufsteigend durchnummeriert. Geschachtelte Ebenen lassen sich daran erkennen, dass eine Ziffer in der Spalte Parent eingetragen ist. Wenn dort die Ziffer '0' eingetragen ist handelt es sich um eine eigenständige Ebene (sie ist nun dem gesamten WMS Dienst untergeordnet). Falls in dieser Spalte bei einer Ebene eine Ziffer größer als Null steht, verweist diese auf die Ebene, der sie untergeordnet ist. In der Ebenenübersicht wird nur diese Parent-Ebene an- und ausgeschaltet.

Parent

Wenn die Ebene Nr.2 den Parent Nr.1 hat, bedeutet dies, dass die Ebene Nr.2 der Ebene Nr.1 untergeordnet ist und in der Mapbender Administration deaktiviert wird. Wenn Ebene Nr.1 aktiviert wird werden automatisch alle untergeordneten Ebenen (hier Nr.2) ebenfalls angefordert.

Name

Die Spalte Name gibt für jede Ebene den Namen wieder, der als <Name> in der Layer-Sektion des Capabilities-Dokuments des Kartendienstes angegeben ist.

Title

Der Titel der Ebene wird in der Spalte Title angezeigt, d.h. also der Name, welcher beim Capabilities-Dokument des Kartendienstes in der Layer-Sektion unter <Title> eingetragen ist.

on/off

Über die Spalte on/off wird definiert, ob die Ebene des Kartendienstes in der Ebenenauswahl angezeigt werden soll oder nicht. Hier kann also unabhängig von dem Dienst für jede GUI individuell eingestellt werden, welche Ebenen für den Benutzer sichtbar oder nicht sichtbar sind.

sel

In der Spalte sel kann eingestellt werden, welche Ebenen vom Benutzer an- und ausgestellt werden können. Hier können Ebenen fixiert werden, die der Benutzer weder an- noch ausstellen kann.