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.
Administrationsoberflächen ermöglichen es Administratoren Karten- und Datendienste zu verwalten und zu kategorisieren. Über die Administration können einzelnen Benutzern und Gruppen Zugriffe gewährt werden.
Mapbender3 ist die nächste Version in der Mapbender Serie. Es wurde unter Verwendung moderner Webtechnologien komplett neu geschrieben. Die Grundlage bildet Symfony2, die brandneue Version des erfolgreichen Symfony PHP Web Application Framework.
Auf der Clientseite finden Sie OpenLayers und jQuery (UI) verbunden über MapQuery.
- Mit dieser neuen Code-Grundlage setzen wir die Mapbender Idee eines Geoportal Frameworks fort.
- Anwendungen können direkt im Browser erstellt und konfiguriert werden.
- Dienste wie WMS können in einem Service Repository verwaltet und mit Anwendungen verbunden werden.
- Das Rechtemanagement ist sowohl für einzelne Benutzer als auch Gruppen einfach zu verwalten, egal ob sie in einer Datenbank oder über LDAP gespeichert werden.
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 eigene Anwendung erstellen
- Benutzer und Gruppen anlegen und Anwendungen zuweisen
Eine Mapbenderanwendung wie folgt aussehen:
Installation
Hinweise zur Installation von Mapbender finden Sie unter installation.
Starten Sie Mapbender
- Wählen Sie aus dem Startmenü oder besuchen Sie http://localhost/mapbender3/app.php
- Die Anwendung braucht ein 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_dep.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.
- Start des Entwicklungsmodus: http://localhost/mapbender3/app_dev.php
- Schauen Sie sich an, welche Information im Entwicklungsmodus angezeigt werden.
Die Willkommensseite
- Die Willkommensseite listet die öffentlichen Anwendungen auf, die von allen Benutzern aufgerufen werden können. Die Anwendungen werden mit Screenshot, Titel und Beschreibung aufgelistet.
- Sie können die Anwendung per Klick auf den Titel oder den Startbutton aufrufen.
- Bevor Sie Mapbender administrieren können, müssen Sie sich anmelden.
- Klicken Sie auf das Mapbender-Logo links, um die Loginseite aufzurufen.
- Sie können sich mit den Benutzer anmelden, der während der Installation erzeugt wurde. Es kann root heißen mit dem Kennwort root (Dies ist der Standardbenutzer und 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 zum Applications mit einer Liste von für Sie freigegebenen Anwendungen weiter geleitet.
Die Anwendungsübersicht bietet folgende Funktionen:
- Titel und Beschreibung
- Ein Link zur Anwendung
- Eine Schaltfläche um die Anwendung zu bearbeiten
- Ein Icon zum Veröffentlichen der Anwendung
- Eine Schaltfläche um eine neue Anwendung anzulegen
- Eine Schaltfläche um die Anwendung zu löschen
Erstellen Sie eine eigene Anwendung
Erstellen Sie eine neue Anwendung, indem Sie einige grundlegende Informationen eingeben. Anschließend können die den Editiermodus benutzen, um Elemente, Layer und Sicherheitseinstellungen zu verwalten.
- Wählen Sie
- Geben Sie einen Titel und eine Beschreibung der Anwendung ein
- Geben Sie einen URL-Titel an, der in der URL benutzt wird, um die Anwendung zu starten. Er kann identisch zum Titel sein.
- Betätigen Sie die Schaltfläche Create, um die Anwendung zu erzeugen.
- Gehen Sie zu neben der Anwendung und wählen Sie die neue Anwendung aus.
- Ihre Anwendung wurde erstellt. Jetzt brauchen Sie WMSs, die in Ihrer Anwendung dargestellt werden. Dies wird im Abschnitt WMS Management beschrieben.
Löschen einer Anwendung
Sie können eine Anwendung aus der Liste über den löschen. Nur die Anwendung wird gelöscht, nicht die Dienste, die in der Anwendung eingebunden waren.
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).
Überblick des Service Repository
- Gehen Sie auf Services und schauen sich die Dienstquellen an.
- Sie bekommen einen Überblick über die Dienste, die bereits in Mapbender geladen wurden.
- Typ (z.B. WMS, WMTS), Titel und Beschreibung bieten eine erste Information über den Dienst.
- Per Klick auf den bekommen Sie weitere Informationen über die Quelle.
- Über den können Sie die Datenquelle aus ihrem Repository löschen.
Fügen Sie Dienste zur Anwendung hinzu
Nach dem erfolgreichen Hochladen eines WMS möchten Sie diesen zu einer Anwendung hinzufügen.
- Wählen Sie .
- Wählen Sie den um ein layerset hinzuzufügen. Ein Layerset präsentiert mehrere Layer (ein möglicher Name könnte main sein)
- Jetzt können Sie Dienste zum layerset hinzufügen.
- Wählen Sie den um dem neuen layerset Dienste hinzuzufügen.
- Sie können die Reihenfolge der Dienste in Ihrer Anwendung über drag & drop ändern.
Konfigurieren von Diensten
Sie können Dienste für Ihre Anwendung konfigurieren. Vielleicht möchten Sie nicht alle Layer anbieten oder Sie möchten die Reihenfolge oder den Titel des Layers ändern, die Info-Abfrage für einzelne Layer verhindern oder den Maximalmaßstab ändern.
- Wählen Sie , um eine Instanz zu konfigurieren.
- Sie sehen eine Tabelle mit den Layern des Dienstes.
- 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 exceptions
- opacity - wählen Sie die Opazität (Deckkraft) in Prozent
- visible
- proxy
- transparency
- tiled - Sie können eine WMS in Kacheln anfordern, Standard ist nicht gekachelt.
Layerkonfiguration
- title - layer title von der Service Information
- active (on/off) - schaltet einen Layer in dieser Anwendung ein/aus
- select on - auswählbar im Geodatenexplorer (Layerbaum)
- select allow - Layer ist bei Anwendungsstart aktiv
- info on - der Layer reagiert auf feature info requests, info default aktiviert diese Funktionalität in der Anwendung
- info allow
- minscale / maxscale - Der Maßstabsbereich, in dem der Layer angezeigt wird. 0 bedeutet keine Maßstabsbeschränkung
- toggle
- reorder
- ... -> öffnet einen Dialog mit weiteren Informationen
- name
- style - wenn ein WMS mehr als einen Style anbietet, können Sie einen anderen Style als den default Style wählen.
Fügen Sie Elemente zu Ihrer Anwendung hinzu
Mapbender biete eine Reihe von Elementen. Sie können diese Anwendung in verschiedene Bereiche (Toolbar, Sidepane, Content, Footer) ihrer Anwendung hinzufügen.
- Wählen Sie :menuselection: um eine Übersicht über die Mapbender3-Elemente zu erhalten.
- Wählen Sie ein Element aus der Liste aus.
- Beachten Sie die verschienden Bereiche, die Sie in Ihrer Anwendung haben. Stellen Sie sicher, dass sie das Element zum richtigen Bereich hinzufügen.
- Sehen Sie sich ihre Anwendung an. Öffnen Sie Ihre Anwendung über
Wenn Sie ein Element, z.B. map auswählen, sehen Sie die Optionen für dieses Element und können es entsprechend konfigurieren.
Beispiele für Elemente, die Mapbender3 anbietet:
- About Dialog
- Activity Indicator
- Button
- Coordinates Display
- Copyright
- Feature Info
- GPS-Position
- Legend
- Layertree - Table of Content
- Map
- Overview
- PrintClient
- Ruler Line/Area
- Scale Selector
- ScaleBar
- Search Router
- SRS Selector
- Spatial Reference System Selector (SRS Selector)
- Navigation Toolbar (Zoombar)
- WMS Loader
Sie finden detaillierte Informationen zu jedem Element unter MapbenderCoreBundle element documentation.
Versuchen Sie es selber
- Fügen Sie eine Karte (Map-Element) zum content-Bereich Ihrer Anwendung hinzu.
- Fügen Sie ein Inhaltsverzeichnis (Layertree) zum content-Bereich Ihrer Anwendung hinzu.
- Fügen Sie einen Butten hinzu, der das den Layertree öffnet.
- Fügen Sie das Navigationselement 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
Zugriff auf eine Mapbenderanwendung benötigt Authentifizierung. Nur öffentliche Anwendungen können von allen genutzt werden.
Ein Benutzer hat Berechtigungen, um auf eine oder mehrere Anwendungen und Dienste zuzugreifen.
Benutzer anlegen
- Um einen Benutzer anzulegen, gehen Sie zu New User oder wählen Sie den .
- Wählen Sie einen Namen und ein Kennwort für Ihren Benutzer.
- Geben Sie eine E-Mail-Adresse für den Benutzer an.
- Speichern Sie Ihren neuen Benutzer.
Gruppen anlegen
- Erzeugen Sie eine Gruppe über New Group.
- Wählen Sie einen Namen und eine Beschreibung für Ihre Gruppe.
- Speichern Sie Ihre neue Gruppe.
Benutzer einer Gruppe zuweisen
- Weisen Sie einen Benutzer einer Gruppe über Users –> Groups zu.
- Wählen Sie einen oder mehrere Benutzer über aus, die Sie der Gruppe zuweisen wollen.
- Weisen Sie einen Benutzer über einer Gruppe zu.
Rollen
Mapbender3 bietet verschiedene Rollen an, die Sie einer Gruppe zuweisen können.
- Kann alles administrieren (super admin)
- Kann Benutzer & Gruppen administrieren
- Kann Anwendungen administrieren
- Weisen Sie einer Gruppe eine Rolle über zu.
Zuweisen einer Anwendung zu einem Benutzer/einer Gruppe
- Bearbeiten Sie Ihre Anwendung über .
- Wählen Sie
- Setzten Sie Berechtigungen wie view edit delete operator master owner
- Weisen Sie eine Anwendung einem Benutzern/einer Gruppe zu
- Testen Sie die Konfiguration!
- Melden Sie sich über ab.
- Melden Sie sich unter der neuen Benutzerbezeichnung an
Weitere Aufgaben
Hier sind einige weiter Dinge, die Sie ausprobieren sollten:
- Versuchen Sie, einige WMS in Ihre Anwendung zu laden. Versuchen Sie Ihre WMS zu konfigurieren.
- 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
Mapbender3 Webseite
Sie finden Tutorials unter
Die API-Dokumentation finden Sie unter
Lernen Sie Mapbender kennen
Beteiligen Sie sich