GeoWeb Admin - Manuale utente

Le funzionalità messe a disposizione sono organizzate all’interno di menù omogenei di I° livello:

• Gestione Progetti
• Gestione Temi e Classi
• Gestione Ambiti
• Gestione Mappe
• Gestione Gruppi e Utenti
• Importa ed Esporta

Il menù di I° livello Gestione Progetti rende disponibili le funzionalità per:

• configurare una categoria di progetto (raggruppamento di progetti)
• configurare un progetto
• configurare la tipologia (geoexplorer/geomanager) e il layout di rappresentazione
• attribuire i permessi di accesso al progetto ai gruppi utente

Il menù di I° livello Gestione Temi e Classi rende disponibili le funzionalità per:

• configurare un tema
• configurare una classe (attributi, gruppi attributi, layout di rappresentazione)
• attribuire i permessi di consultazione/gestione della classi ai gruppi utente
• configurare azioni
• configurare layer
• configurare processi
• configurare relazioni
• configurare report

Il menù di I° livello Gestione Ambiti rende disponibili le funzionalità per:

• configurare un ambito funzionale / territoriale
• configurare i valori associati agli ambiti

Il menù di I° livello Gestione Mappe rende disponibili le funzionalità per:

• configurare le mappe associate ai progetti
• configurare gli sfondi cartografici (es. WMS, Google Maps, Open Street Map, ecc.)
• associare gli sfondi cartografici alle mappe

1. tramite la funzione New Map accedere alla maschera di inserimento dei dati;
2. inserire i campi obbligatori: name che serve come identificativo quindi deve essere univoco, description che è l’etichetta con cui viene visualizzato l’ambito ed i parametri di origine della mappa, il sistema di coordinate e la tipologia (Map Type);
3. alla mappa è possibile inoltre associare delle basi cartografiche che fanno da sfondo ed inquadramento del progetto: selezionare la base da ‘Availables Base Maps’ e trascinarla in ‘Associated Base Maps’ nell’ordine desiderato;
4. confermare cliccando sul tasto funzione Create;
5. nell’albero di gestione viene aggiunta la mappa appena creata.

1. tramite la funzione New Map accedere alla maschera di inserimento dei dati;
2. inserire i campi obbligatori: name che serve come identificativo quindi deve essere univoco, description che è l’etichetta con cui viene visualizzato l’ambito ed i parametri di origine della mappa, il sistema di coordinate e la tipologia (Map Type);
3. alla mappa è possibile inoltre associare delle basi cartografiche che fanno da sfondo ed inquadramento del progetto: selezionare la base da ‘Availables Base Maps’ e trascinarla in ‘Associated Base Maps’ nell’ordine desiderato.
4. confermare cliccando sul tasto funzione Create;
5. nell’albero di gestione viene aggiunta la mappa appena creata.

Visualizzare l’Albero di Gestione delle mappe attraverso la dicitura Maps Management e selezionare la mappa:

per la modifica

1. modificare i dati;
2. salvare tramite apposita funzione.

per l’eliminazione

1. cliccare sul tasto funzione Delete;
2. il sistema manda un messaggio di conferma di eliminazione;
3. confermare cliccando su ok.

Per mappe di base si intendono le basi cartografiche che fanno da sfondo ed inquadramento del progetto.

1. tramite la funzione New Base Map accedere alla maschera di inserimento dei dati;
2. inserire i campi obbligatori;
3. confermare cliccando sul tasto funzione Save;
4. nell’albero di gestione viene aggiunta la base appena creata.

Visualizzare l’Albero di Gestione delle mappe attraverso la dicitura Maps Management e selezionare la mappa:

per la modifica

1. modificare i dati;
2. salvare tramite apposita funzione.

per l’eliminazione

1. cliccare sul tasto funzione Delete;
2. il sistema manda un messaggio di conferma di eliminazione;
3. confermare cliccando su ok.

Inserire una nuova Base Map e definire i parametri necessari:

• Type=WMS
• Tiled=<secondo indicazione del Provider>
• Parameter=<URL fornito dal Provider>
• Options=Indicare il layer da visualizzare nel Base Maps, e il Sistema di riferimento di origine del WMS, con sintassi analoga alla seguente:

{layers:'OI.ORTOIMMAGINICOLORE.2012',srs:'EPSG:3857'}

Il menù di I° livello Gestione Gruppi e Utenti rende disponibili le funzionalità per:

• creazione nuovo gruppo di utenti
• creazione nuovo utente (funzionalità deprecata in fare del nuovo strumento di gestione utenti)
• associazione di un utente ai gruppi di appartenenza (funzionalità deprecata in fare del nuovo strumento di gestione utenti)

Il menù di I° livello Importa ed Esporta rende disponibili le funzionalità per effettuare la migrazione di un progetto fra due diverse Web Admin Application:

• esportazione in XML di un progetto (comprensivo di temi e classi)
• esportazione in XML di un tema (comprensivo di classi)
• esportazione in XML di una o più classi
• importazione da XML di un progetto (comprensivo di temi e classi)
• importazione da XML di un tema (comprensivo di classi)
• importazione da XML di una o più classi

• inserire il nome del gruppo utenti (obbligatorio e univoco)
• inserire la descrizione che identifica il ruolo del gruppo utenti (opzionale)
• creare il nuovo gruppo cliccando il tasto aggiungi

Nota: il nome del gruppo deve essere univoco

• inserire lo username dell’utente (obbligatorio e univoco)
• inserire la password dell’utente (obbligatorio)
• associare l’utente ai gruppi di appartenenza
• creare il nuovo utente cliccando il tasto aggiungi

La password deve rispettare alcuni standard segnalati alla compilazione della stessa.

La password dell’utente viene salvata in forma criptata all’interno del sistema di autenticazione di Geoweb®; nel caso in cui l’utente avesse perso/dimenticato la password sarà necessario procedere con la riassegnazione.

• cliccare su Nuovo Progetto
• inserire il nome del progetto (obbligatorio)
• inserire etichetta del progetto (obbligatorio)
• inserire la descrizione del progetto (obbligatorio)
• inserire la versione del progetto (obbligatorio)
• inserire lo stato del progetto
• inserire l’autore del progetto (obbligatorio)
• inserire eventuali note

• inserire il tipo progetto (obbligatorio) [1]
• inserire la categoria del progetto
• inserire l’ordine del progetto (all’interno della categoria)
• selezionare la mappa da associare al progetto fra quelle definite nel menù Gestione Mappe
• associare i temi al progetto

I progetti di tipo GeoExplorer sono caratterizzati dalla predominanza della componente geografica (mappa in primo piano).

I progetti di tipo GeoManager sono caratterizzati dalla predominanza della componente dati (schede dati in primo piano) e possono richiamare la visualizzazione della mappa in pop-up

Contiene la definizione del menu di progetto in formato XML. Ulteriori approfondimenti sono disponibili nell’ Appendice A – Layout Progetto

• abilitare nel progetto i permessi di apertura da parte dei gruppi utente

[1] N.B.: se l’utente che effettua l’accesso ha permessi per la consultazione di un unico progetto verrà indirizzato direttamente all’interno del progetto stesso bypassando questa schermata.

• cliccare su Nuovo Tema
• inserire il nome del tema
• inserire la descrizione del tema
• creare il nuovo tema cliccando il tasto

• nella sezione del tema di interesse, cliccare su Nuova Classe e nella cartella Classe:
• inserire il nome della classe
• inserire la descrizione della classe
• inserire la versione
• inserire lo stato
• inserire la tipologia d’uso
• inserire l’autore
• inserire eventuali note

• scegliere il datasource
• scegliere la tabella/vista utilizzata per la consultazione
• scegliere la tabella utilizzata per la gestione
• scegliere il campo nome
• scegliere il campo chiave primaria
• scegliere la tipologia di classe
• scegliere il campo contenente la geometria
• creare la nuova classe cliccando il tasto

inserire in Event Trigger (se necessario) il nome del file groovy contenenti i trigger che operano sulla classe.

selezionare l’opzione Hierarchical Class nel caso in cui la classe sia di tipo classificato (plugin classificazione).

selezionare l’opzione Dynamic Acl se necessario

• nella cartella Permessi, per ogni ambito assegnare ad ogni gruppo di utenti i livelli autorizzativo sulla classe.
• confermare l’assegnazione cliccando il tasto Salva

si riporta di seguito l’elenco ed i dettagli dei livelli autorizzativi attualmente definiti.

In fase di creazione di una nuova classe, viene automaticamente generato l’elenco degli attributi della classe (ovvero l’elenco dei campi presenti nella vista/tabella di consultazione della classe). Le funzioni di configurazione degli attributi sono rese disponibili nelle specifiche sezioni:

• Attributi: configurazione dell’etichetta dell’attributo e del tipo di controllo da utilizzare nella rappresentazione
• Filtro: configurazione degli attributi da visualizzare nella scheda di ricerca
• Lista: configurazione degli attributi da visualizzare nella scheda di lista
• Gruppi Attributi: configurazione dei raggruppamenti di attributi
• Layout: configurazione del layout della scheda di presentazione dei dati
• Handler Eventi: configurazione dell’Handler degli Eventi

Per ogni attributo presente in elenco effettuare le seguenti configurazione:

• personalizzazione dell’etichetta dell’attributo (visualizzata nelle schede dati)
• modifica (se necessario) del tipo di dato rilevato in automatico dall’applicazione (string, number, ecc.)
• definizione e configurazione del tipo di controllo da utilizzare per la rappresentazione/gestione di ogni attributo

Nella sezione Filtro vengono definite le impostazioni della scheda di ricerca:

• elenco degli attributi su cui effettuare le ricerche (drag and drop dalla lista di attributi)
• ordine di visualizzazione degli attributi nella scheda di ricerca
• parametri di ricerca per ogni attributo (input utente, scelta da lista semplice/complessa, data)

Nella sezione Lista vengono definite le impostazioni della scheda di lista:

• elenco degli attributi da visualizzare in lista (drag and drop dalla lista di attributi)
• ordine di visualizzazione degli attributi nella scheda di lista
• larghezza (px) delle colonne della lista

Nella sezione Gruppi Attributi vengono definiti i raggruppamenti tematici degli attributi:

• creazione raggruppamenti
• associazione attributi ai raggruppamenti
• ordinamento attributi nel raggruppamento

Consultare la sezione Widget per i dettagli sugli attributi

Nella sezione Layout vengono definiti i raggruppamenti tematici degli attributi:

• creazione raggruppamenti
• associazione attributi ai raggruppamenti
• ordinamento attributi nel raggruppamento

Nella sezione Handler Eventi vengono definiti gli eventi associati agli attributi:

• impostare l’attributo sorgente (‘’controllante’’)
• impostare il tipo evento dalla tendina
• Impostare l’attributo target (‘’controllato’’)
• cliccare sull’icona per inserire il codice dell’Handler

Inserimento del codice dell’Handler in javascript

In accoppiamento ad un Handler va di solito un’azione ‘’al caricamento del dettaglio’’ che consenta di gestire lo stato iniziale al caricamento del dettaglio

Per ogni classe è possibile definire le azioni, ovvero la possibilità da parte dell’utente di eseguire specifiche procedure sui dati della classe.

Nella sezione di configurazione della classe di interesse, cliccare su Nuova Azione e nel form di gestione:

• inserire il nome dell’azione (obbligatorio e univoco)
• inserire etichetta
• inserire descrizione
• inserire versione
• inserire stato
• inserire autore
• inserire note

Nella sezione di configurazione dell’azione:

• inserire il tooltip dell’azione
• associare un’immagine rappresentativa del tipo di azione (16×16 px, formato png)
• scegliere il tipo di esecuzione dell’azione (singolo dettaglio, record selezionati in lista, classe, libera…)
• inserire il codice eseguito dall’azione

Geoweb ® dispone di una serie di azioni «standard» (esportazione / importazione dati, inizializzazione processi, ecc.), ma è possibile creare azioni «personalizzate» tramite scrittura di apposito codice.

Per il codice delle azioni «standard» vedi gli esempi riportati nell’appendice C.

Nella sezione di lista di controllo degli accessi dell’azione:

• assegnare i permessi di esecuzione ai gruppi utente
• creare l’azione cliccando il tasto

Per le classi fra loro collegate è necessario configurare la corrispondente relazione che consente di visualizzare nella scheda di dettaglio le funzioni di collegamento fra i record.

Nella sezione di configurazione della classe di interesse, cliccare su Nuova Relazione e nel form di gestione:

• inserire la descrizione della relazione
• scegliere il campo locale di collegamento nella classe di partenza
• scegliere la classe di destinazione
• scegliere il campo di collegamento nella classe di destinazione
• scegliere la cardinalità della relazione (1:1; 1:N; 1:M)
• creare la relazione cliccando il tasto

Per ogni relazione creata dall’utente, Geoweb® genera la relazione inversa per la classe collegata.

La configurazione delle relazioni è necessaria per l’utilizzo dei widget linklist e linklistnam

Per ogni classe è possibile configurare la visualizzazione di reportistiche (es. report anagrafiche, dati di sintesi, ecc.). Nella sezione di configurazione della classe di interesse, cliccare su Nuova Report e nel form di gestione:

• inserire il nome della report
• inserire la descrizione estesa della report
• valorizzare l’url della posizione del file .jasper (a partire dalla cartella templates dei contenuti statici)
• scegliere il formato di output della report (PDF, HTML, RTF, XLS)
• scegliere il tipo di utilizzo della report (dettaglio, lista, lista/dettaglio)
• valorizzare il nome da assegnare al file generato dal sistema
• creare la report cliccando il tasto