Guida rapida su Mapbender3

Mapbender é un framework web per pubblicare, registrare, vedere, navigare, monitorare e consentire l’accesso sicuro a servizi SDI (spatial data infrastructures - infrastrutture di dati spaziali).

Le interfacce di gestione permettono agli amministratori di sistema di mantenere e classificare servizi relativi a mappe (map services) e ad oggetti geografici (feature services), e consentire l’accesso a persone, gruppi e ad altri servizi.

Mapbender3 é la versione più recente del framework Mapbender. Mapbender é stato interamente riscritto utilizzando le più moderne tecnologie web. Alla base del software c’è Symfony 2, l’ultima versione dell’affermato framework PHP.

Il lato client si basa invece su OpenLayers e jQuery (UI), legati assieme da MapQuery.

Con questo nuovo codice di base, portiamo avanti l’idea di Mapbender come framework per la produzione di geoportali:

• le applicazioni possono essere prodotte e configurate direttamente all’interno del browser;
• i servizi, come ad es. WMS, possono essere amministrati all’interno di un repository di supporto, per essere poi inseriti nelle applicazioni;
• i diritti di accesso sono facili da mantenere, sia per utenti individuali che per gruppi, sia che vengano memorizzati dentro un database o dentro un LDAP.

Per svolgere questa breve introduzione all’uso di Mapbender3 necessiti solo di un browser.

Questa guida rapida descrive come:

• avviare Mapbender
• creare una nuova applicazione
• aggiungere un servizio Web Map Service (OGC WMS)
• configurare un servizio WMS
• sviluppare una applicazione indipendente
• creare un user e un gruppo ed assegnargli delle applicazioni

L’immagine che segue mostra come può apparire l’interfaccia di una applicazione creata con Mapbender:

Installazione

Per l’installazione di Mapbender, leggi la documentazione disponibile alla pagina http://doc.mapbender3.org/en/book/installation.html della documentazione di Mapbender3.

Avviare Mapbender

1. Scegli Mapbender dal menu start oppure utilizza il link http://localhost/mapbender3/app.php

Se incontri delle difficoltà ad avviare Mapbender, prova a controllare se il tuo web server Apache e PostgreSQL sono in funzione.

Avviare Mapbender in modalità debug (app_dev.php)

Symfony mette a disposizione degli sviluppatori una modalità di debug che mostra varie informazioni riguardanti la tua applicazione (logs, eccezioni, database queries, uso della memoria, tempi di esecuzione e altro). Questa modalità é disponibile solo da localhost.

1. Avvia in modalità debug: http://localhost/mapbender3/app_dev.php
2. Dai un’occhiata alle informazioni offerte da questa modalità.

Pagina di benvenuto

1. La Welcome page elenca le applicazioni che sono pubbliche e che possono essere utilizzate da tutti gli utenti. Le applicazioni vengono elencate attraverso un piccolo screenshot, un titolo e una descrizione.
2. Puoi avviare una applicazione cliccando sul titolo oppure sul pulsante start.
3. Per iniziare a gestire applicazioni con Mapbender, devi prima effettuare il login per accedere alla schermata di amministrazione.
4. Clicca su Login in alto a destra per aprire la pagina di login.
5. Puoi effettuare il login utilizzando il nome utente generato durante l’installazione. Questo potrà essere root e password root (questi sono username e password predefiniti, ottenuti durante l’installazione di Mapbender con OSGeo-Live. Puoi cambiare la password se vuoi lavorare in un ambiente di produzione. Non cancellare, però, la user root.).

Effettuato il login sarai indirizzato alla pagina di amministrazione di Mapbender.

Panoramica sull’applicazione

Dopo il login, sarai indirizzato alla pagina Applications, che presenta una lista di applicazioni alle quali ti é permesso accedere.

La panoramica di riepilogo dell’applicazione fornisce le seguenti informazioni e funzionalità:

• titolo e descrizione
• link all’applicazione
• pulsante per modificare l’applicazione
• pulsante per la pubblicazione e l’annullamento della pubblicazione dell’applicazione
• pulsante per eliminare l’applicazione
• pulsante per creare una nuova applicazione
• il filtro sul campo di testo permette di cercare applicazioni per nome

Creare una nuova applicazione

Ora puoi creare una nuova applicazione fornendo alcune informazioni di base su di essa. Utilizza poi la modalità di modifica per aggiungere elementi, layers e informazioni relative alla sicurezza.

1. scegli Applications ‣ New Application
2. definisci un titolo e una descrizione per la tua applicazione
3. definisci un titolo per l’URL. Questo titolo sarà utilizzato nell’URL per aprire l’applicazione. Può essere lo stesso del titolo dell’applicazione.
4. clicca sul pulsante Create per creare l’applicazione
5. clicca sul pulsante Edit sulla nuova applicazione per modificare l’applicazione
6. la tua applicazione é stata creata. Adesso hai bisogno di una mappa WMS da visualizzare nella tua applicazione. Questo sarà descritto nella sezione Amministrazione di fonti di dati.

Eliminare una applicazione

Puoi eliminare una applicazione dalla pagina Applications, cliccando sul pulsante X.

Amministrazione di fonti di dati (Data sources)

Mapbender può gestire differenti servizi, come OGC WMS, OGC WMTS oppure OGC WFS. Ogni servizio deve essere gestito in modo differente. Gli strumenti di amministrazione forniscono una interfaccia per l’amministrazione di ogni fonte di dati (per il momento solo WMS).

Panoramica sul repository di supporto

1. Scegli Services e dai un’occhiata al repository di supporto.
2. Questa pagina dà una panoramica sulle fonti di dati che sono caricate su Mapbender.
3. Tipo (es. WMS, WMTS), Titolo, Descrizione offrono una prima informazione sui servizi.
4. Premendo sul pulsante View puoi ottenere ulteriori informazioni sulla fonte di dati.
5. Con il pulsante Delete puoi eliminare la fonte di dati dal tuo repository.

Aggiungere Web Map Services

Ora puoi aggiungere OGC Web Map Services (WMS) alla tua applicazione.

Un servizio WMS restituisce un file XML quando viene effettuata una richiesta getCapabilities. Mapbender esegue il parsing di questa informazione e ottiene così, dal file XML, tutte le informazioni necessarie sul servizio.

Tip

Dovresti controllare il documento Capabilities prima di caricarlo in Mapbender

1. Scegli il menu Services ‣ Add Service oppure usa il pulsante+. Collegati al servizio WMS inserendo l’URL della richiesta getCapabilities nel campo testo Serviceurl.
2. Inserisci username e password se il servizio richiede una autenticazione.
3. Clicca su Load per caricare il servizio nel repository.
4. Dopo la registrazione del servizio, Mapbender visualizzerà una panoramica sulle informazioni fornite dal servizio stesso.

Quelli che seguono sono alcuni esempi di indirizzi WMS:

Germany workshop demo

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

WhereGroup OSM WMS

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

Omniscale OSM WMS (vedi anche http://osm.omniscale.de/) http://osm.omniscale.net/proxy/service?

Aggiungere un servizio a una applicazione

Dopo avere caricato il servizio WMS, puoi aggiungere il WMS alla tua applicazione.

1. Scegli Applications ‣ edit-Button ‣ Layers ‣ Edit-Button.
2. Clicca sul pulsante+ per aggiungere un layerset, che rappresenta un gruppo di layers (un possibile nome potrebbe essere “main”)
3. Ora puoi aggiungere il layer al layerset
4. Clicca sul pulsante+ sul tuo nuovo layerset per aggiungere un servizio.
5. Puoi cambiare l’ordine dei servizi nella tua applicazione con un drag & drop.

Configurare il servizio WMS

Puoi configurare il servizio WMS secondo le necessità della tua specifica applicazione. Magari non hai bisogno di fornire tutti i layers, oppure vorresti cambiare l’ordine o il nome dei layers, o disabilitare la richiesta feature info, oppure cambiare la scala massima di un layer.

1. Scegli Applications ‣ edit-Button ‣ Layers ‣ edit-Button per configurare l’istanza del servizio.
2. A questo punto apparirà una tabella con tutti i layers relativi al servizio.
3. Puoi cambiare l’ordine dei layers con un drag & drop

Configurazione del servizio

• format - scegli il formato per le richieste getMap
• infoformat - scegli il formato per le richieste getFeatureInfo
• exceptionformat - scegli il formato per le eccezioni
• opacity - scegli l’opacità in percentuale
• visible
• proxy
• transparency
• tiled - puoi richiedere un WMS con tiles, in quanto per default non é tiled

Configurazione dei layers

• title - il titolo del layer, proveniente dalle informazioni sul servizio
• active (on/off) - abilita/disabilita un layer per questa applicazione
• select on - selezionabile in geodata explorer
• select allow - il layer é attivo quando l’applicazione viene avviata
• info on - il layer può supportare una richiesta feature info, per cui é possibile attivare questa funzionalità
• info allow
• minscale / maxscale - I limiti di scala nel quale il layer deve essere visualizzato; 0 significa nessuna restrizione di scala
• toggle
• reorder
• ... -> apre una finestra di dialogo contenente ulteriori informazioni
• name
• style - se un servizio WMS fornisce più di uno stile, puoi scegliere uno stile differente da quello predefinito

Aggiungere elementi a una applicazione

Mapbender mette a disposizione un insieme di elementi. Puoi aggiungere questi elementi alla tua applicazione. Esistono differenti regioni (Toolbar, Sidepane, Content, Footer) nelle quali puoi inserire gli elementi.

1. Scegli Applications ‣ edit-Button ‣ Layers ‣ Button+ per avere una panoramica sugli elementi forniti da Mapbender3.
2. Scegli un elemento dalla lista.
3. Puoi notare che ci sono differenti aree nella tua applicazione. Assicurati di aggiungere l’elemento a una regione che sia coerente con l’elemento.
4. Dai uno sguardo alla tua applicazione. Apri la tua applicazione da Applications ‣ Applications Overview

A questo punto dovresti avere un’idea di quanto sia semplice modificare una applicazione creata con Mapbender senza dover effettuare modifiche al codice.

Alcuni degli elementi messi a disposizione da Mapbender3 sono:

• 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

Puoi trovare informazioni dettagliate su ogni elemento nella documentazione riguardante il bundle MapbenderCoreBundle.

Ora prova da solo

• aggiungi un elemento Map al contenuto della tua applicazione
• aggiungi un elemento Layertree al contenuto della tua applicazione
• aggiungi un pulsante che apre il Layertree nella parte superiore della tua applicazione
• aggiungi una Navigation Toolbar al contenuto
• aggiungi un elemento Copyright e modifica il testo al suo interno
• aggiungi un SRS Selector nel footer

Amministrazione di utenti e gruppi

L’accesso a Mapbender richiede una procedura di autenticazione. Solo le applicazioni pubbliche possono essere utilizzate da chiunque.

Ogni utente può avere il permesso di accedere a una oppure ad un insieme di applicazioni e servizi.

Creare un profilo utente

1. Per creare un profilo utente clicca su New User oppure sul pulsante+.
2. Scegli un nome e una password per il tuo profilo utente.
3. Fornisci un indirizzo email per l’utente.
4. Salva il tuo nuovo profilo utente.

Creare un gruppo di utenti

1. Crea un gruppo di utenti cliccando su New Group.
2. Definisci un nome e una descrizione per il tuo gruppo.
3. Salva il tuo nuovo gruppo.

Assegnare utenti a un gruppo

1. Assegna utenti a un gruppo cliccando su Users –> Groups.
2. Scegli uno o più utenti da aggiungere al gruppo attraverso il tab Users.
3. Assegna un utente a un gruppo cliccando sul pulsante Users ‣ Edit-Button‣ Groups.

Ruoli

Mapbender3 fornisce differenti ruoli per l’assegnazione a un gruppo.

• Può amministrare tutto (super admin)
• Può amministrare utenti e gruppi
• Può amministrare applicazioni

Assegna ruoli a un utente attraverso il tab Users ‣ Edit your User ‣ Security.

Assegnare una applicazione a un Utente/Gruppo

1. Modifica la tua applicazione cliccando su Application ‣ Edit-Button.
2. Scegli Security
3. Stabilisci permessi come view edit delete operator master owner
4. Assegna un utente/gruppo all’applicazione
5. Testa la tua configurazione!
6. Effettua il logout da Mapbender cliccando su Logout.
7. Effettua il login con il nuovo profilo utente

Altre cose da provare

Quelle che seguono sono altre prove che potresti effettuare:

1. Prova ad aggiungere alcuni servizi WMS alla tua applicazione. Prova a configurare i tuoi WMS.
2. Prova a creare una applicazione indipendente.

E poi?

Questo é solo il primo passo verso la piena conoscenza nell’uso di Mapbender. Ci sono molte altre funzionalità che puoi provare a utilizzare.

Mapbender Project home:

http://mapbender.org

Mapbender3 Website:

http://mapbender3.org/

Puoi trovare alcuni tutorials ai seguenti indirizzi:

http://doc.mapbender3.org

http://api.mapbender3.org

Collabora con il progetto:

http://www.mapbender3.org/Community