====== GeoWeb Admin - Manuale utente ====== ===== Menù di I° Livello ===== 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 {{:gwadminusermanual:gest_progetti.png?600|}} ===== Gestione Progetti ===== Il menù di I° livello Gestione [[gwusermanual:gwobjects:start#progetti|Progetti]] rende disponibili le funzionalità per: * configurare una categoria di progetto (raggruppamento di progetti) * configurare un progetto * configurare la tipologia (geoexplorer/geomanager) e il [[gwusermanual:gwobjects:start#layout_e_gruppi_attributi|layout]] di rappresentazione * attribuire i [[gwusermanual:gwobjects:start#permessi_statici_e_dinamici|permessi]] di accesso al progetto ai gruppi utente {{:gwadminusermanual:nuovo_progetto.png?600|}} ===== Gestione Temi e Classi ===== Il menù di I° livello Gestione [[gwusermanual:gwobjects:start#temi|Temi]] e [[gwusermanual:gwobjects:start#classi|Classi]] rende disponibili le funzionalità per: * configurare un tema * configurare una classe (attributi, gruppi attributi, layout di rappresentazione) * attribuire i [[gwusermanual:gwobjects:start#permessi_statici_e_dinamici|permessi]] di consultazione/gestione della classi ai gruppi utente * configurare [[gwusermanual:gwobjects:start#azioni|azioni]] * configurare layer * configurare processi * configurare relazioni * configurare [[gwusermanual:gwobjects:start#report_di_classe|report]] {{:gwadminusermanual:gest_classe.png?600|}} ===== Gestione Ambiti ===== Il menù di I° livello Gestione [[gwusermanual:gwobjects:start#ambiti|Ambiti]] rende disponibili le funzionalità per: * configurare un ambito funzionale / territoriale * configurare i valori associati agli ambiti {{:gwadminusermanual:gest_cat_ambito.png?600|}} {{:gwadminusermanual:gest_ambito.png?600|}} ===== Gestione Mappe ===== Il menù di I° livello Gestione [[gwusermanual:gwobjects:start#mappe_e_planimetrie|Mappe]] rende disponibili le funzionalità per: * configurare le mappe associate ai [[gwusermanual:gwobjects:start#progetti|progetti]] * configurare gli sfondi cartografici (es. WMS, Google Maps, Open Street Map, ecc.) * associare gli sfondi cartografici alle mappe {{:gwadminusermanual:gest_mappa.png?600|}} ==== Configurazione della Mappa ==== -tramite la funzione New Map accedere alla maschera di inserimento dei dati; -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); -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; -confermare cliccando sul tasto funzione Create; -nell’albero di gestione viene aggiunta la mappa appena creata. === Inserimento di un nuova mappa === -tramite la funzione New Map accedere alla maschera di inserimento dei dati; -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); -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. -confermare cliccando sul tasto funzione Create; -nell’albero di gestione viene aggiunta la mappa appena creata. === Modifica/Eliminazione della mappa === Visualizzare l’Albero di Gestione delle mappe attraverso la dicitura Maps Management e selezionare la mappa: **per la modifica** -modificare i dati; -salvare tramite apposita funzione. **per l’eliminazione** -cliccare sul tasto funzione Delete; -il sistema manda un messaggio di conferma di eliminazione; -confermare cliccando su ok. ==== Configurazione delle mappe di sfondo ==== Per mappe di base si intendono le basi cartografiche che fanno da sfondo ed inquadramento del progetto. {{:gwadminusermanual:cart.png|}} \\ === Inserimento di un nuova mappa di sfondo === -tramite la funzione New Base Map accedere alla maschera di inserimento dei dati; -inserire i campi obbligatori; -confermare cliccando sul tasto funzione Save; -nell’albero di gestione viene aggiunta la base appena creata. === Modifica/Eliminazione della mappa di sfondo === Visualizzare l’Albero di Gestione delle mappe attraverso la dicitura Maps Management e selezionare la mappa: **per la modifica** -modificare i dati; -salvare tramite apposita funzione. **per l’eliminazione** -cliccare sul tasto funzione Delete; -il sistema manda un messaggio di conferma di eliminazione; -confermare cliccando su ok. === Definizione di uno sfondo basato su WMS === Inserire una nuova Base Map e definire i parametri necessari: *Type=WMS *Tiled= *Parameter= *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'} {{:gwadminusermanual:gcart.png|}} \\ ===== Gestione Gruppi e Utenti ===== 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) {{:gwadminusermanual:gruppi.png?600|}} {{:gwadminusermanual:utenti.png?600|}} ===== Importa / Esporta ===== 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 [[gwusermanual:gwobjects:start#progetti|progetto]] (comprensivo di temi e classi) * esportazione in XML di un [[gwusermanual:gwobjects:start#temi|tema]] (comprensivo di classi) * esportazione in XML di una o più [[gwusermanual:gwobjects:start#classi|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 {{:gwadminusermanual:importa_progetti.png?600|}} ===== Nuovo Gruppo Utenti ===== * 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 {{:gwadminusermanual:gruppi2.png?600|}} ===== Nuovo Utente ===== * 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 {{:gwadminusermanual:utenti2.png?800|}} 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. ===== Nuovo Progetto ===== ==== Scheda Informazioni ==== * cliccare su Nuovo [[gwusermanual:gwobjects:start#progetti|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 {{:gwadminusermanual:gest_progetto2.png?600|}} ==== Scheda Configurazioni ==== * inserire il tipo [[gwusermanual:gwobjects:start#progetti|progetto]] (obbligatorio) [1] * inserire la categoria del progetto * inserire l’ordine del progetto (all’interno della categoria) * selezionare la [[gwusermanual:gwobjects:start#mappe_planimetrie_modelli_bim|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 {{:gwadminusermanual:gest_progetto3.png?600|}} ==== Scheda Editor XML ==== Contiene la definizione del menu di [[gwusermanual:gwobjects:start#progetti|progetto]] in formato XML. Ulteriori approfondimenti sono disponibili nell’ Appendice A – Layout Progetto {{:gwadminusermanual:gest_progetto4.png?600|}} ==== Permessi Progetto ==== * abilitare nel [[gwusermanual:gwobjects:start#progetti|progetto]] i permessi di apertura da parte dei gruppi utente {{:gwadminusermanual:project_manag.png?600|}} ==== Risultato della configurazione del progetto ==== {{:gwadminusermanual:gest_punti_vend.png?600|}} [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. ===== Nuovo Tema ===== * cliccare su Nuovo [[gwusermanual:gwobjects:start#temi|Tema]] * inserire il nome del tema * inserire la descrizione del tema * creare il nuovo tema cliccando il tasto {{:gwadminusermanual:crea.png|}} {{:gwadminusermanual:gest_tema.png?700|}} ===== Nuova Classe ===== ==== Scheda Informazioni ==== * nella sezione del tema di interesse, cliccare su Nuova [[gwusermanual:gwobjects:start#classi|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 {{:gwadminusermanual:gest_classe2.png?600|}} ==== Scheda Configurazioni ==== * 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 [[gwusermanual:gwobjects:start#classi|classe]] * scegliere il campo contenente la geometria * creare la nuova classe cliccando il tasto {{:gwadminusermanual:crea2.png|}} {{:gwadminusermanual:gest_classe3.png?600|}} 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 ==== Permessi Classe ==== * nella cartella [[gwusermanual:gwobjects:start#permessi_statici_e_dinamici|Permessi]], per ogni [[gwusermanual:gwobjects:start#ambiti|ambito]] assegnare ad ogni gruppo di utenti i livelli autorizzativo sulla [[gwusermanual:gwobjects:start#classi|classe]]. * confermare l’assegnazione cliccando il tasto Salva {{:gwadminusermanual:save.png|}} si riporta di seguito l’elenco ed i dettagli dei livelli autorizzativi attualmente definiti. ^lettura^ |accesso in sola lettura alle informazioni contenute nella classe| ^inserimento^ |accesso in gestione completa (inserimento / modifica / eliminazione) delle informazioni contenute nella classe| ^modifica^ |accesso in sola modifica alle informazioni contenute nella classe| ^cancellazione^ |accesso in modifica alle informazioni contenute nella classe ed autorizzazione ad eliminare i relativi record| {{:gwadminusermanual:gest_classe4.png?700|}} ===== Attributi Classe ===== ==== Attributi ==== In fase di creazione di una nuova [[gwusermanual:gwobjects:start#classi|classe]], viene automaticamente generato l’elenco degli [[gwusermanual:gwobjects:start#attributi_e_controlli_widget|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 [[gwusermanual:gwobjects:start#layout_e_gruppi_attributi|layout]] della scheda di presentazione dei dati * Handler Eventi: configurazione dell’Handler degli Eventi {{:gwadminusermanual:gest_attributi.png?700|}} ==== Configurazione Label e Controlli Attributi ==== Per ogni [[gwusermanual:gwobjects:start#attributi_e_controlli_widget|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 {{:gwadminusermanual:gest_attributi2.png?700|}} ===== Filtro Classe ===== ==== Filtro ==== Nella sezione Filtro vengono definite le impostazioni della scheda di ricerca: * elenco degli [[gwusermanual:gwobjects:start#attributi_e_controlli_widget|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) {{:gwadminusermanual:gest_attributi3.png?700|}} ===== Lista Classe ===== ==== Lista ==== Nella sezione Lista vengono definite le impostazioni della scheda di lista: * elenco degli [[gwusermanual:gwobjects:start#attributi_e_controlli_widget|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 {{:gwadminusermanual:lista.png?700|}} ===== Gruppi Attributi Classe ===== ==== Gruppi Attributi ==== Nella sezione [[gwusermanual:gwobjects:start#layout_e_gruppi_attributi|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 {{:gwadminusermanual:gruppi_attributi.png?700|}} ===== Layout Classe ===== ==== Layout ==== Nella sezione [[gwusermanual:gwobjects:start#layout_e_gruppi_attributi|Layout]] vengono definiti i raggruppamenti tematici degli attributi: * creazione raggruppamenti * associazione [[gwusermanual:gwobjects:start#attributi_e_controlli_widget|attributi]] ai raggruppamenti * ordinamento attributi nel raggruppamento {{:gwadminusermanual:layout.png?700|}} ===== Handler Eventi Classe ===== ==== Handler Eventi ==== Nella sezione Handler Eventi vengono definiti gli eventi associati agli attributi: * impostare l’[[gwusermanual:gwobjects:start#attributi_e_controlli_widget|attributo]] sorgente (‘’controllante’’) * impostare il tipo evento dalla tendina * Impostare l’attributo target (‘’controllato’’) * cliccare sull’icona {{:gwadminusermanual:icona.png|}} per inserire il codice dell’Handler {{:gwadminusermanual:handler_eventi.png?700|}} 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 {{:gwadminusermanual:handler.png?700|}} ===== Nuova Azione ===== ==== Scheda Informazioni ==== Per ogni classe è possibile definire le [[gwusermanual:gwobjects:start#azioni|azioni]], ovvero la possibilità da parte dell’utente di eseguire specifiche procedure sui dati della classe. Nella sezione di configurazione della [[gwusermanual:gwobjects:start#classi|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 {{:gwadminusermanual:gest_azioni.png?700|}} ==== Scheda Configurazioni ==== Nella sezione di configurazione dell’[[gwusermanual:gwobjects:start#azioni|azione]]: * inserire il tooltip dell’azione * associare un’immagine rappresentativa del tipo di azione (16x16 px, formato png) * scegliere il tipo di esecuzione dell’azione (singolo dettaglio, record selezionati in lista, classe, libera…) * inserire il codice eseguito dall’azione {{:gwadminusermanual:configurazioni.png?600|}} 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 [[gwusermanual:gwobjects:start#permessi_statici_e_dinamici|permessi]] di esecuzione ai gruppi utente * creare l’azione cliccando il tasto {{:gwadminusermanual:crea3.png|}} {{:gwadminusermanual:lista_contr_accessi.png?600|}} ===== Nuova Relazione ===== ==== Scheda Collegamento ==== Per le [[gwusermanual:gwobjects:start#classi|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 {{:gwadminusermanual:crea4.png|}} 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 {{:gwadminusermanual:gest_relaz.png?600|}} ===== Nuova Report ===== Per ogni [[gwusermanual:gwobjects:start#classi|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 [[gwusermanual:gwobjects:start#report_di_classe|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 {{:gwadminusermanual:crea4.png|}} {{:gwadminusermanual:gest_report.png?600|}}