Mapbender3 Quickstart

Mapbender ist ein web-basiertes Geoportal Framework zum Veröffentlichen, Registrieren, Anzeigen, Navigieren und Überwachen von Diensten, mit der Möglichkeit Dienste gesichert anzubieten.

Sie brauchen nichts weiter als einen Standard Webbrowser für diesen Schnellstart.

Dieser Quickstart beschreibt, wie Sie:

• Mapbender starten
• eine Anwendung erstellen
• einen Web Map Service (OGC WMS) laden
• WMS konfigurieren
• eine individuelle Anwendung erstellen
• Benutzer und Gruppen anlegen und Anwendungen zuweisen

Eine Mapbender Anwendung kann wie folgt aussehen:

Contents

• Mapbender3 Quickstart
  • Installation
  • Starten Sie Mapbender
  • Starten Sie Mapbender im Entwicklungsmodus über app_dev.php
  • Die Willkommensseite
  • Anwendungsübersicht
  • Erstellen Sie eine eigene Anwendung
  • Kopieren und Umbenennen einer Anwendung
  • Löschen einer Anwendung
  • Exportieren und Importieren von Anwendungen und Daten
  • Verwaltung von Datenquellen
  • Service Repository
  • Laden von Web Map Services
  • Fügen Sie Dienste zur Anwendung hinzu
  • Konfiguration von Diensten
  • Fügen Sie Elemente zu Ihrer Anwendung hinzu
  • Versuchen Sie es selber
  • Benutzer- und Gruppenverwaltung
  • Benutzer anlegen
  • Gruppen anlegen
  • Benutzer einer Gruppe zuweisen
  • Rechte
  • Zuweisen einer Anwendung zu einem Benutzer/einer Gruppe
  • Weitere Aufgaben
  • Was kommt als Nächstes?

Installation

Hinweise zur Installation von Mapbender finden Sie unter https://doc.mapbender3.org/de/book/installation.html.

Starten Sie Mapbender

1. Wählen Sie Geospatial ‣ Browser Clients ‣ Mapbender aus dem Startmenü oder besuchen Sie http://localhost/mapbender3/app.php
2. Die Anwendung braucht eine kurze Zeit, um zu starten.

Falls Sie Schwierigkeiten haben, Mapbender zu starten, überprüfen Sie ob der Apache Web Server und die PostgreSQL Datenbank laufen.

Starten Sie Mapbender im Entwicklungsmodus über app_dev.php

Symfony bietet einen Entwicklungsmodus mit einer Reihe von Informationen über die Anwendung an (Logging, Fehlermeldungen, Datenbankabfragen, Speicherverbrauch, Zeit und mehr). Dieser Modus ist nur über localhost verfügbar.

1. Start des Entwicklungsmodus: http://localhost/mapbender3/app_dev.php
2. Schauen Sie sich an, welche Information im Entwicklungsmodus angezeigt werden.

Die Willkommensseite

1. Die Willkommensseite listet die öffentlichen Anwendungen auf, die von allen Benutzern aufgerufen werden können. Die Anwendungen werden mit Screenshot, Titel und Beschreibung aufgelistet.
2. Sie können die Anwendung per Klick auf den Titel, das Vorschaubild oder den Startbutton aufrufen.
3. Bevor Sie Mapbender administrieren können, müssen Sie sich anmelden.
4. Klicken Sie auf das Mapbender-Logo links, um die Loginseite aufzurufen.
5. Sie können sich mit dem Benutzer anmelden, der während der Installation erzeugt wurde. Er kann root heißen mit dem Kennwort root (Dies ist der Standardbenutzer/Kennwort nach der Installation von Mapbender auf der OSGeo-Live. Bitte ändern Sie das Kennwort, wenn Sie eine Produktivumgebung betreiben. Löschen Sie den Benutzer root nicht.).

Nach erfolgreicher Anmeldung werden Sie zur Mapbender Administration weiter geleitet.

Anwendungsübersicht

Nach der Anmeldung werden Sie zur Anwendungsübersicht (Applications) mit einer Liste von den für Sie freigegebenen Anwendungen weiter geleitet.

Die Anwendungsübersicht bietet folgende Funktionen:

• Titel und Beschreibung
• Vorschaubild zur Anwendung (sofern bereitgestellt)
• Link zur Anwendung
• Button, um die Anwendung zu kopieren
• Button, um die Anwendung zu bearbeiten
• Button zum Veröffentlichen der Anwendung
• Button, um eine neue Anwendung anzulegen
• Button, um die Anwendung zu löschen
• mit dem Filtertextfeld kann nach Anwendungen gesucht werden

Erstellen Sie eine eigene Anwendung

Erstellen Sie eine neue Anwendung, indem Sie einige grundlegende Informationen eingeben. Anschließend können Sie den Editiermodus verwenden, um Elemente, Layer und Sicherheitseinstellungen zu verwalten.

1. Wählen Sie Applications ‣ New Application
2. Geben Sie einen Titel und eine Beschreibung der Anwendung ein
3. Geben Sie einen URL-Titel an, der in der URL benutzt wird, um die Anwendung zu starten. Er kann identisch zum Titel sein.
4. Laden Sie eine png-Datei und definieren so ein Vorschaubild für die Anwendungsübersicht.
5. Wählen Sie eine Layoutvorlage für die Anwendung.
6. Betätigen Sie die Schaltfläche Create, um die Anwendung zu erzeugen.
7. Gehen Sie zu Edit-Button neben der Anwendung und wählen Sie die neue Anwendung aus.
8. Ihre Anwendung wurde erstellt. Jetzt brauchen Sie Elemente (z.B. ein Kartenelement, Navigation, Legende) und Kartendienste.

Tip

Beachten Sie, dass derzeit die Layout-, Icon- und Farbanpassungen in css- und twig-Dateien erfolgen. Lesen Sie dazu die Dokumentation unter https://doc.mapbender3.org/en/book/templates.html

Kopieren und Umbenennen einer Anwendung

Sie können eine neue Anwendung auch durch Kopieren einer vorhandenen erzeugen. Jede Anwendung, auf die Sie schreibend zugreifen können, verfügt über den Button kopieren. Beim Kopieren wird die Anwendung mitsamt der Dienste kopiert. Die kopierte Anwendung erhält einen abgeleiteten Namen, den Sie im nächsten Schritt anpassen können.

Löschen einer Anwendung

Sie können eine Anwendung aus der Liste Applications über den +-Button löschen. Nur die Anwendung wird gelöscht, nicht die Dienste, die in der Anwendung eingebunden waren.

Exportieren und Importieren von Anwendungen und Daten

Sie können eine Anwendung als JSON oder YAML über Applications ‣ Export exportieren. Für den Export können ein oder mehrere Anwendungen ausgewählt werden. Die Datenquellen können ebenfalls beim Export ausgegeben werden.

Die Export-Datei beinhaltet alle Definitionen, die zum Aufbau der Anwendung (Datenquellen) erforderlich sind. Die Export-Datei kann über Applications ‣ Import in andere Mapbender3 Installationen oder in die gleiche Installation geladen werden.

Verwaltung von Datenquellen

Mapbender kann verschiedene Dienste wie OGC WMS, OGC WMTS oder OGC WFS verwalten. Jeder Service muss anders verwaltet werden. Die Administration bietet für jede Quelle eine Administrationsoberfläche (im Moment lediglich WMS).

Service Repository

1. Gehen Sie auf Services und schauen sich die Dienstquellen an.
2. Sie bekommen einen Überblick über die Dienste, die bereits in Mapbender geladen wurden.
3. Typ (z.B. WMS, WMTS), Titel und Beschreibung bieten eine erste Information über den Dienst.
4. Per Klick auf den View-Button bekommen Sie weitere Informationen über die Quelle.
5. Über den Delete-Button können Sie die Datenquelle aus ihrem Repository löschen.

Laden von Web Map Services

Sie können OGC Web Map Services (WMS) in Ihre Anwendung laden.

Ein WMS liefert ein XML, wenn das getCapabilities-Dokument angefordert wird. Diese Information wird von Mapbender ausgelesen. Der Client erhält alle notwendigen Informationen über den Dienst aus diesem XML.

Tip

Sie sollten das Capabilities-Dokument zuerst in Ihrem Browser überprüfen, bevor Sie versuchen, den Dienst in Mapbender zu laden.

1. Wählen Sie Services ‣ Add Service. Geben Sie den Link zur WMS getCapabilities URL in das Textfeld Originurl ein.
2. Geben Sie Nutzername und Kennwort ein, sofern der Dienst Authentifizierung benötigt.
3. Klicken Sie Load, um den Dienst in das Repository zu laden.
4. Nach erfolgreicher Registrierung des Dienstes zeigt Mapbender eine Übersicht der Informationen an, die der Dienst geliefert hat.

Hier sind einige Beispiel WMS:

Germany workshop demo

http://wms.wheregroup.com/cgi-bin/germany_workshop.xml?VERSION=1.1.1&REQUEST=GetCapabilities&SERVICE=WMS

WhereGroup OSM WMS

https://osm-demo.wheregroup.com/service

Fügen Sie Dienste zur Anwendung hinzu

Nach dem erfolgreichen Hochladen eines WMS möchten Sie diesen zu einer Anwendung hinzufügen.

1. Wählen Sie Applications ‣ Edit-Button ‣ Layers ‣ Edit-Button.
2. Wählen Sie den +-Button um ein Layerset hinzuzufügen. Ein Layerset präsentiert mehrere Layer (ein möglicher Name könnte main oder overview sein)
3. Jetzt können Sie Dienste zum Layerset hinzufügen.
4. Wählen Sie den +-Button, um dem neuen Layerset Dienste hinzuzufügen.
5. Sie können die Reihenfolge der Dienste in Ihrer Anwendung über drag & drop ändern.

Konfiguration von Diensten

Sie können Dienste für Ihre Anwendung konfigurieren. Vielleicht möchten Sie nicht alle Ebenen anzeigen oder Sie möchten die Reihenfolge oder den Titel der Ebenen ändern, die Info-Abfrage für einzelne Ebenen verhindern oder den Maximalmaßstab ändern.

1. Wählen Sie Applications ‣ edit-Button ‣ Layers ‣ edit-Button, um eine Instanz zu konfigurieren.
2. Sie sehen eine Tabelle mit den Layern des Dienstes.
3. Sie können die Reihenfolge der Layer über drag & drop ändern.

Servicekonfiguration

• format - wählen Sie das Format für den getMap-Requests
• infoformat - wählen Sie das Format für getFeatureInfo-Requests
• exceptionformat - wählen Sie das Format für Fehlermeldungen
• opacity - wählen Sie die Opazität (Deckkraft) in Prozent
• visible
• basesource
• proxy - bei Aktivierung wird der Dienst über Mapbender als Proxy angefordert
• transparency - Standard ist aktiviert, deaktiviert wird der Dienst ohne transparenten Hintergrund angefordert (getMap-Request mit TRANSPARENT=FALSE)
• tiled - Dienst wird in Kacheln angefordert, Standard ist nicht gekachelt (kann bei großer Karte sehr hilfreich sein, wenn der Dienst die Kartengröße nicht unterstützt)
• BBOX factor
• tile buffer

Layerkonfiguration

• title - Layertitel der Service Information
• active (on/off) - deaktiviert einen Layer in dieser Anwendung ein/aus
• select allow - Layer ist auswählbar im Geodatenexplorer (Layerbaum)
• select on - Layer ist bei Anwendungsstart aktiv
• info allow - Infoabfrage wird für diesen Layer zugelassen
• info on - Layer Infoabfrage wird beim Start aktiviert
• minscale / maxscale - Der Maßstabsbereich, in dem der Layer angezeigt wird.
• toggle - aufklappen beim Start der Anwendung
• reorder - Ebenen können über drag&drop in der Anwendung verschoben werden
• … -> öffnet einen Dialog mit weiteren Informationen
• name - Layername der Service Information (wird beim getMap-Request verwendet und ist nicht veränderbar)
• style - wenn ein WMS mehr als einen Stil anbietet, können Sie einen anderen Stil als den default Stil wählen.

Fügen Sie Elemente zu Ihrer Anwendung hinzu

Mapbender bietet eine Reihe von Elementen (Modulen) an. Ihre Anwendung verfügt wiederum über verschiedene Bereiche (Toolbar, Sidepane, Content, Footer), die Sie mit Elementen bestücken können.

1. Wählen Sie Applications ‣ edit-Button ‣ Layers ‣ +-Button, um eine Übersicht über die Mapbender3-Elemente zu erhalten.
2. Wählen Sie ein Element aus der Liste aus.
3. Beachten Sie die verschiedenen Bereiche Ihrer Anwendung. Stellen Sie sicher, dass sie das Element zum richtigen Bereich hinzufügen.
4. Konfigurieren Sie das Element. Hinweis: Wenn Sie ein Element z.B. map auswählen, sehen Sie lediglich die Optionen für dieses Element und können es entsprechend konfigurieren.
5. Sie können die Position der Elemente über drag & drop ändern.
6. Schauen Sie sich Ihre Anwendung an. Öffnen Sie Ihre Anwendung über Applications ‣ Applications Overview

Sie sollten einen EInblick bekommen, wie einfach es ist die Mapbender Anwendung anzupassen, ohne den Quellcode anpassen zu müssen.

Beispiele für Elemente, die Mapbender3 anbietet:

• About Dialog
• Activity Indicator
• BaseSourceSwitcher
• Button
• Coordinates Display
• Copyright
• Feature Info
• GPS-Position
• HTML
• Legend
• Layertree - Table of Content
• Map
• Overview
• PrintClient
• Ruler Line/Area
• Scale Selector
• ScaleBar
• SimpleSearch
• Search Router
• SRS Selector
• Spatial Reference System Selector (SRS Selector)
• Navigation Toolbar (Zoombar)
• WMS Loader
• WMC Editor
• WMC Loader
• WMC List

Sie finden detaillierte Informationen zu jedem Element unter MapbenderCoreBundle Element Dokumentation , MapbenderWmcBundle Element Dokumentation und MapbenderWmsBundle Element Dokumentation.

Versuchen Sie es selber

• Fügen Sie ein Kartenelement (Map-Element) zum content-Bereich Ihrer Anwendung hinzu.
• Fügen Sie einen Ebenenbaum (Layertree) zum content-Bereich Ihrer Anwendung hinzu.
• Fügen Sie einen Button in die Toolbar, der den Layertree öffnet.
• Fügen Sie das Navigationselement (Navigation Toolbar) in den content-Bereich hinzu
• Fügen Sie ein Copyright-Element hinzu und ändern Sie den Copyright-Text.
• Fügen Sie einen SRS Selector in den Footer-Bereich ein.

Benutzer- und Gruppenverwaltung

Der Zugriff auf eine Mapbender Anwendung benötigt Authentifizierung. Nur öffentliche Anwendungen können von allen Anwendern genutzt werden.

Ein Benutzer kann die Berechtigungen bekommen, um auf eine oder mehrere Anwendungen und Dienste zuzugreifen.

Benutzer anlegen

1. Um einen Benutzer anzulegen, gehen Sie zu New User oder wählen Sie den +-Button.
2. Wählen Sie einen Namen und ein Kennwort für Ihren Benutzer.
3. Geben Sie eine E-Mail-Adresse für den Benutzer an.
4. Speichern Sie Ihren neuen Benutzer.
5. Weitere Angaben zum Benutzer können im Reiter Profil erfolgen.

Gruppen anlegen

1. Erzeugen Sie eine Gruppe über New Group.
2. Wählen Sie einen Namen und eine Beschreibung für Ihre Gruppe.
3. Speichern Sie Ihre neue Gruppe.

Benutzer einer Gruppe zuweisen

1. Weisen Sie einen Benutzer einer Gruppe über Users –> Groups zu.
2. Wählen Sie einen oder mehrere Benutzer über Users aus, die Sie der Gruppe zuweisen wollen.
3. Weisen Sie einen Benutzer über Users ‣ Edit-Button‣ Groups einer Gruppe zu.

Rechte

Mapbender3 bietet verschiedene Rechte an, die Sie vergeben können. Diese beruhen auf dem Symfony ACL System http://symfony.com/doc/2.1/cookbook/security/acl_advanced.html#built-in-permission-map

• view - anzeigen
• edit - editieren
• delete - löschen
• operator - kann anzeigen, editieren und löschen
• master - kann anzeigen, editieren und löschen und diese Rechte außerdem weitergeben
• owner - Besitzer, darf alles. Darf master und owner Recht vergeben.

1. Weisen Sie einem Benutzer über Users ‣ Edit your User ‣ Security Rechte zu.

Zuweisen einer Anwendung zu einem Benutzer/einer Gruppe

1. Bearbeiten Sie Ihre Anwendung über Application ‣ Edit-Button.
2. Wählen Sie Security
3. Setzen Sie Berechtigungen wie view, edit, delete, operator, master, owner
4. Weisen Sie eine Anwendung einem Benutzern / einer Gruppe zu
5. Testen Sie die Konfiguration!
6. Melden Sie sich über Logout ab.
7. Melden Sie sich unter der neuen Benutzerbezeichnung an

Weitere Aufgaben

Hier sind weitere Aufgaben, die Sie ausprobieren können:

1. Versuchen Sie, einige WMS in Ihre Anwendung zu laden. Versuchen Sie Ihre WMS zu konfigurieren.
2. Versuchen Sie eine eigene Anwendung zu erzeugen.

Was kommt als Nächstes?

Dies waren nur die ersten Schritte mit Mapbender3. Es gibt viele weitere Funktionen, die Sie ausprobieren können.

Mapbender Projektseite

https://mapbender.org

Mapbender3 Webseite

https://mapbender3.org/

Sie finden Tutorials unter

https://doc.mapbender3.org

Die API-Dokumentation finden Sie unter

https://api.mapbender3.org

Beteiligen Sie sich

https://www.mapbender.org/Community