Template:WMS
From MapbenderWiki
(See OGC WMS to learn about the specification and WMS Capabilities List to find services from all oer the world)
Contents |
English
WMS / Upload Server Capabilities
To access maps of an OGC WMS server first the Capabilities document has to be analysed. Mapbender "caches" Capabilities documents in its database to store permanent information regarding the map service. Open the administrative gui (e.g. <admin2_en>) and choose <Upload WMS> from the section <WMS administration>
(LOADWMS => Modul: mod_loadCapabilities.php)
Choose a GUI for uploading the WMS. It can be useful to create several GUI for the purpose of collecting and organizing WMS. These can later be used by the Catalog Services. Once a map service has been uploaded it can be configured for each GUI individually. Use the authorization modules to allow a user or a group to access the services.
Choose the GUI from the list box. Fill in the URL to the Capabilities document of the map service in the lower text field.
Example
GetCapabilities request for MapServer:
http:// <computername> /mapserver?map=../demo.map&VERSION=1.1.1&REQUEST=getCapabilities&SERVICE=wms
Send the getCapabilities request with the button <Load>. The map service will answer with an XML document, which will be analyzed by Mapbender and stored in the Mapbender database. After successful loading a page is displayed showing the content of the map service confirming the upload. Please observe that you are now working with a cached (copied) version of the WMS capabilities. Whenever anything in the structure of the service changes it has to be updated.
Troubleshooting
If the process of uploading (requesting the Capabilities document) takes more than a few seconds probably something went wrong. The reason can be that either the service is not available at the moment or that the Mapbender server has no proper access to the Capabilities document. If you work on your own installation, ask your administrator whether the Mapbender server hardware is allowed to open Capabilities Documents as a file. This setting is changed edited in the file <php.ini>. Find more information in the Installation section or by troubelshooting Allow_url_fopen.
Mapbender Portal
If you have trouble using the Mapbender Portal, ask the operator for assistance.
Administrators
Check the setting allow_url_fopen in your <php.ini> settings. Instead of showing the data of the map service, Mapbender returns an SQL error message and rolls back the database update.
Deutsch
(Lesen Sie mehr über die OGC WMS Spezifikation und finden Sie Dienste aus der ganzen Welt in der WMS Capabilities Liste)
WMS / Server Capabilities hochladen
Um auf die Karten eines OGC WMS-konformen Web Map Server Kartendienstes zugreifen zu können wird zunächst das Capabilities Dokument in Mapbender hochgeladen. Öffnen Sie eine Administrationsoberfläche, und gehen in der Rubrik WMS Verwaltung auf das Modul <Capabilities hochladen> (LOADWMS => Modul: mod_loadCapabilities.php).
Wählen Sie eine GUI aus in die der Kartendienste geladen werden soll. Es bietet sich an, hierfür eigene GUI-Container anzulegen, die lediglich Verweise auf die WMS enthalten und keine Oberflächenelemente enthalten. Diese Container werden später von den Katalogdiensten verwendet. Laden sie den WMS in den WMS-Container hoch und kopieren sie ihn von dort in andere GUIs. So ist der WMS nur einmal gespeichert, aber mehrfach verknüpft. Wenn ein WMS mehrmals hochgeladen wird (z.B. in jede GUI neu), dann bekommt er in der Datenbank mehrere IDs. Die Administration wird dadurch erschwert, siehe Datenbank bereinigen. Achten Sie darauf, dass Sie anderen Zugriff auf die geladenen Kartendienste gestatten, indem Sie die entsprechende GUI über das Berechtigungsmodel einem Benutzer oder einer Gruppe zuordnen.
Wählen Sie in der oberen Auswahlliste eine GUI aus, in welche der Kartendienst eingebunden werden soll. Tragen Sie anschließend im unteren Textfeld die URL zu dem entsprechenden Capabilities-Dokument des Kartendienstes an.
Beispiel
Ein Bespiel des GetCapabilities-Aufrufs mit dem UMN MapServer:
http:// <rechnername> /mapserver?map=../demo.map&VERSION=1.1.1&REQUEST=getCapabilities&SERVICE=wms
Über die Schaltfläche <Load> wird der getCapabilities-Aufruf abgeschickt. Der Kartendienst antwortet mit einem XML Dokument, welches von Mapbender ausgewertet und in der Mapbender Administrationsdatenbank gespeichert wird. Danach wird eine Übersicht des Kartendienstes und der Ebenen angezeigt, um das erfolgreiche Hochladen zu bestätigen. Beachten Sie, dass Mapbender ab jetzt mit einer Kopie des Capabilities Dokumentes arbeitet, um den Zugriff zu beschleunigen und weitere Einstellungsmöglichkeiten zu ermöglichen. Strukturelle Änderungen innerhalb des jeweiligen WMS Dienstes (neue Ebene, anderer Ebenenname) müssen deswegen über die Funktion <Hochgeladene aktualisieren> erneut abgefragt werden.
Fehlersuche
Sollte der Prozess des Hochladens länger als wenige Sekunden dauern kann es sein, dass der Dienst nicht verfügbar ist oder der Mapbender Server keinen Zugriff auf das Capabilities Dokument erhält. Das kann an mehreren Gründen liegen:
- Der WMS Dienst antwortet nicht
- Der Mapbender Server erreicht den WMS Dienst nicht, weil er z.B. keinen Proxy-Zugriff hat
- Der Mapbender Server darf das Capabilities-Dokument nicht als Datei öffnen (siehe auch Allow_url_fopen).
Eigene Installation
Falls Sie eine eigene Installation betreiben, prüfen Sie die Einstellungen allow_url_fopen in der Datei <php.ini>. Mapbender zeigt beim auftreten eines Fehlers statt der Daten des Kartendienstes eine SQL Fehlermeldung an und setzt die Änderungen in der Datenbank zurück.
Mapbender Portal
Sollte das Problem auf dem Mapbender Portal auftreten ist der gesuchte Server wahrscheinlich von dort aus nicht erreichbar. Falls Sie selbst das Capabilities Dokument vorliegen haben, können Sie es an den Portalbetreiber schicken, der es für Sie einstellt.
