Mostra paginaRevisioni precedentiPuntano quiEsporta in PDFTorna su Questa pagina è in sola lettura. Puoi visualizzare il sorgente, ma non puoi modificarlo. Contatta l'amministratore se pensi che ci sia un errore. ======Oggetti principali del framework====== Le funzionalità messe a disposizione sono organizzate all’interno di menù omogenei di I° livello: - Gestione Progetti: - - configurare un progetto - - configurare la tipologia (geoexplorer/geomanager) e il layout di rappresentazione - - attribuire i permessi di accesso al progetto ai gruppi utentGestione Progetti(Projects Management) - Gestione Temi e Classi(Themes and Classes Management): - - 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 - Gestione Ambiti(Scopes Management): - -configurare un ambito funzionale / territoriale - - configurare i valori associati agli ambiti - Gestione Mappe(Maps Management): - - configurare le mappe associate ai progetti - - configurare gli sfondi cartografici (es. WMS, Google Maps, Open Street Map, ecc.) - - associare gli sfondi cartografici alle mappe - Gestione Gruppi e Utenti(Groups and Users Management): - - creazione nuovo gruppo di utenti - - creazione nuovo utente - - associazione di un utente ai gruppi di appartenenza - Importa ed Esporta(Import and Export): - - 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 =====Progetti===== Strumento per la personalizzazione vera e propria del software ovvero definisce i temi che si vuole trattare in questa particolare installazione, i dati che verranno gestiti, i progetti che s’intende amministrare, organizzando il tutto in una minuziosa archiviazione. I dati così divisi e le applicazioni che vi operano sono i componenti principali su cui agiscono le autorizzazioni concesse ai gruppi di utenti. {{:gwusermanual:3_progetto.png?600|}} ====Funzioni relative alle maschere di gestione==== Ogni maschera di gestione contiene sempre le seguenti funzioni. \\ Delete {{:gwusermanual:4_freccia.png?nolink|}} elimina nel database il record che identifica l’oggetto in esame Save {{:gwusermanual:4_freccia.png?nolink|}} Salva nel database le informazioni presenti sulla maschera Create {{:gwusermanual:4_freccia.png?nolink|}}inserisce nel database il record che identifica l’oggetto in esame * campo obbligatorio X {{:gwusermanual:4_freccia.png?nolink|}} elimina il record corrispondente + {{:gwusermanual:4_freccia.png?nolink|}} aggiunge il record corrispondente Le maschere hanno la funzione drag-and-drop che consente di effettuare diverse semplicemente cliccando su un elemento e trascinarlo nella posizione desiderata. ==== Project ==== Questa maschera consente di visualizzare l’elenco di tutti i progetti configurati. È possibile personalizzare l’immagine associata al progetto, e che compare nell’home page dell’applicazione, facendo il doppio click e sostituendola con un’altra. ====Layout==== Tramite tale maschera viene impostato il layout del progetto: è possibile scegliere tra GeoManager (accesso ai dati tramite interfaccia alfanumerica) e GeoExplorer (accesso ai dati tramite interfaccia mappa). ==== Permissions ==== Tramite tale maschera si assegnano i gruppi di utenti che hanno il permesso di visualizzare determinati ambiti. ====Configurazione di un progetto ==== Per Progetto si intende un raggruppamento di Temi la cui gestione può essere effettuata attraverso una o più applicazioni. Un progetto è caratterizzato quindi da un nome, da una descrizione, da un elenco di temi e da un elenco di applicazioni. Se il progetto prevede la mappa è possibile specificare il nome e il tipo di file da caricare. L’ordine con cui vengono inseriti i temi i le applicazioni determina l’ordinamento in fase di visualizzazione. Per poter configurare un progetto si deve quindi: * aver configurato almeno un tema (vedi procedure di amministrazione dei temi) * inserire un nuovo progetto (vedi procedura inserimento nuovo progetto) **Inserimento nuovo progetto** - aprire la voce di menù Projects Managment e tramite la funzione New Project accedere alla maschera di inserimento dei dati; - inserire il Nome che identificherà il progetto, la Descrizione che comparerà sulla home page; - aggiungere i temi trascinandoli della scheda Available Themes alla scheda Associated Themes; - nella maschera Layout scegliere la tipologia del layout e compilare il file XML; - assegnare gli ambiti che possono accedere al progetto; - confermare cliccando sul tasto funzione Create. **Modifica/Eliminazione progetto**\\ Tramite apposita funzione aprire la maschera di dettaglio del progetto da modificare/eliminare * Per la modifica: * modificare i dati principali e le associazioni progetto-tema (vedi procedura); * salvare tramite apposita funzione. * Per l’eliminazione: * cliccare sul tasto funzione Cancel (Attenzione! Eliminando il progetto verranno eliminate anche tutte le associazioni che fanno riferimento a questo progetto ossia le associazioni progetto-tema); * il sistema manda un messaggio di conferma di eliminazione; * confermare cliccando su ok. **Associazione progetto-tema**\\ Per aggiungere ulteriori temi al progetto: * aprire la voce di menù Projects Managment e selezionare il progetto da integrare; * aggiungere i temi trascinandoli della scheda Available Themes alla scheda Associated Themes; * confermare cliccando sul tasto Save. Per completare la configurazione del tema, o le singole classi, vanno inserite anche nel Layout del progetto stesso come sotto indicato. **Eliminazione associazione progetto-tema** Per eliminare un tema dal progetto: - aprire la voce di menù Projects Managment e selezionare il progetto da integrare; - aggiungere i temi trascinandoli della scheda Available Themes alla scheda Associated Themes. **Configurazione del layout del progetto** Tale funzione serve per configurare i vari menù tramite i quali è possibile navigare i dati del progetto: - scegliere la tipologia: * GeoManager per progetti di consultazione dei dati alfanumerici; * GeoExplorer per progetti con visualizzazione della mappa; - compilare il file XML. Per le specifiche sulla compilazione del file XML consultare il Capitolo ‘Configurazione XML di Progetto’ - confermare cliccando sul tasto Save. **Associazione dei permessi al progetto**\\ Tale funzione serve per assegnare i permessi dei gruppi di utenti per ogni ambito associato al progetto. {{ :gwusermanual:14_progetto.png?600 |}} Tramite la spunta su Open del singolo ambito si dà al relativo gruppo di utenti di accedere all'applicazione. =====Temi===== =====Classi===== =====Attributi e Controlli (Widget)===== =====Azioni===== =====Processi===== =====Report===== Geoweb è integrato con Jasper Report, quindi le report, che hanno diverse finalità e modalità di utilizzo, sono realizzate utilizzando iReport. Le reportistiche possono essere prodotte in formati come pdf, xls, rtf. Le report sono di divise nelle seguenti tipologie: [[gwusermanual:elements#Reports di classe]|Reports di classe]] Sono le report di lista o di dettaglio che vengono agganciate alla classe, e che seguono eventuali filtri applicati alla classe stessa al momento in cui viene chiamata la report. Queste report hanno il vincolo di poter includere solo i campi presenti negli attributi definiti nella classe. Tale vincolo può essere aggirato, vedere il paragrafo dedicato. **[[gwusermanual:elements#Reports di Comando]|Reports di Comando]]** o Report HTML Si tratta di pagine HTML realizzate sempre con Jasper Report, che permettono attraverso la configurazione di HyperLink, di fare chiamate a Geoweb, come aperture di liste o dettagli, attivazione di altre report, lancio di azioni e cosi via. In tale modo si possono bypassare i casi d'uso applicativi imposti dal framework, e creare delle interfacce utente specializzate e accattivanti. **[[gwusermanual:elements#Reports di Cruscotto]]** Sono Report Generiche, richiamabili dalla scheda gwReportsSheet o in altre modalità (Report di Comando). Servono ad estrarre i dati senza alcun vincolo. In queste Report possono essere definiti dei parametri che vengono richieste lato client all'utente che esegue la report stessa ===N.B.=== Opzione **'Quando non ci sono dati Stampa'** : é importante impostare questa opzione per tutte le report, in maniera tale che non diano errori se la report viene chiamata e non ci sono dati da stampare. L'impostazione corretta è **'Tutte le sezioni senza Dettaglio'** ====Reports di classe==== Di seguito sono illustrati gli standard di riferimento per predisporre, con iReport delle report HTML che possono essere utilizzate come pannelli Comandi di Geoweb. Tali report sono richiamabili come tipo Scheda e da queste, attraverso l’utilizzo di Hyperlink, potranno essere lanciate altre report - sia di classe, che di cruscotto, che di comando - azioni, schede, ecc. ====Reports di comando==== * [[#id=gwusermanual:elements#reports_di_comando|Layout standard report in formato HTML]] * [[#id_gwusermanualelements_reports_di_comando|Definizione di hyperlink nella report]] __**Layout standard report in formato HTML**__ Dimensioni minime della pagina Larghezza = 700 Altezza = 100 Numero minimo di bande previste 3, di seguito le caratteristiche delle bande **Titolo** – h banda = 50 **Testata di colonna** – h banda = 30 **Dettaglio** – h banda = 20 //Esempio di struttura di report con Titolo – Testata di colonna - Dettaglio// {{:gwusermanual:rep1.png?900|}} ===TITOLO=== La banda dovrà contenere il titolo della report e opzionalmente il logo del cliente / prodotto ed un eventuale grafico. Il titolo della report dovrà essere inserito utilizzando l’oggetto testo statico di jreport e dovrà avere le seguenti caratteristiche: Font = Arial Dimensione = 14 Grassetto = Si Colore in primo piano = 2,72,133 (scala rgb) Colore di sfondo = Nessuno Allineamento orizzontale = Centro Allineamento verticale = Medio Larghezza dell’elemento = Pari alla larghezza della banda Per quanto riguarda l’eventuale logo si riporta una breve descrizione di quanto necessita: - Creare in jreport un parametro denominato logo che abbia come tipo di classe parametro = Object - Inserire nella tabella gw_global_report_param (presente nel db dei dati) un nuovo record con i seguenti parametri: - Param_name= logo - Param_data_type = image - Param_file = caricare il file di immagine del logo - Param_file_name = logo.jpg - Param_file_ctype = image/jpg - Inserire il file logo.jpg nella cartella \web\template\report dei contenuti statici del progetto (le dimensioni del logo genericamente si dovrebbero attestare intorno ai 65 x 65 pixel) - Inserire l’oggetto immagine con le seguenti caratteristiche: Sinistra = 10 (distanza dal margine sx della banda) Altezza = 5 (distanza dal margine basso della banda) Larghezza= 40 Altezza = 40 Espressione immagine = new java.io.ByteArrayInputStream((byte[]) $P{logo}) Scala immagine = Mantieni proporzioni Per quanto concerne la presenza di un eventuale grafico la configurazione dello stesso varierà da report a report. Nel caso di presenza di un grafico bisognerà aumentare le dimensioni della pagina della report (altezza complessiva) in modo da poter aumentare la dimensione della banda. //Esempio di struttura della banda Titolo// {{:gwusermanual:rep_2a.png?600|}} Oggetto Immagine per Logo Oggetto testo statico {{:gwusermanual:repp.png?400|}} ===TESTATA DI COLONNA=== Contiene le etichette dei campi che vengono richiamati nella report. Le etichette dovranno essere inserite utilizzando l’oggetto testo statico di jreport e dovranno avere le seguenti caratteristiche: Font = SansSerif (ininfluente nel caso in cui l’ output del font rimanga quello di default) Dimensione = 10 Grassetto = Si Colore in primo piano = 255,255,255 (scala rgb) Colore di sfondo = 2,72,133 (scala rgb) Opaco = Si Allineamento orizzontale = Centro Allineamento verticale = Medio Altezza elemento = Pari all'altezza della banda //Esempio di struttura banda Titolo di colonna// {{:gwusermanual:reppp.png?400|}} {{:gwusermanual:rep4a.png?400|}} ===Definizione di Hyperlink nella Report=== Per creare i collegamenti ipertestuali all'interno di un report occorre: {{:gwusermanual:rep_5a.png?600|}} - Fare clic sulla scheda Collegamento ipertestuale nella vista Proprietà. - Impostare su oggetto con il Collegamento la proprietà: Properties Expression - aggiungere manualmente la proprietà: net.sf.jasperreports.export.html.class - definire il valore: reportlink In Geoweb è presente un foglio di stile .css nel quale è definito tale stile, che provoca uno 'scurimento' del controllo al passaggio del mouse. -------------------------- **Dalla versione 4.6.11.30 (issue #1251)** Dato che in 4.6 lo stile hover dei button è differente da quello delle row delle grid, sono state aggiunti contestualmente i selettori css (integrabili nelle report): * **gwReportButton**: da usare per i button (come reportlink, di cui ne viene scoraggiato l'uso per le nuove report) * **gwReportRow**: da usare per le row degli elenchi Il set di regole di queste class css, se necessario, saranno tenute allineate di volta in volta nel framework. E' bene nelle report avere hook point differenti almeno per bottoni e righe -------------------------- 3. Scegliere il tipo di Hyperlink target tra i seguenti: * Self: Questa è l'impostazione predefinita. Si apre il link nella finestra corrente. * Blank: Apre il bersaglio in una nuova finestra. Utilizzato per formati di output come HTML e PDF. * Top: Apre la destinazione nella finestra corrente, ma al di fuori alla fine cornici. Utilizzato per formati di output come HTML e PDF. * Parent: Apre la destinazione nella finestra principale (se disponibile). Utilizzato per formati di output come HTML e PDF. 4. Nel collegamento a discesa Hyperlink Type, scegliere se il tipo di collegamento è: None , Reference, LocalAnchor, LocalPage, RemoteAnchor, RemotePage o ReportExecution. Per le nostre casistiche basta selezionare il tipo di hyperlink target = Self e il tipo di hyperlink type = Reference. Definiti questi 2 parametri bisogna inserire nel box Hyperlink le varie istruzioni java riportate di seguito. NB. **Tutte le istruzioni java devono essere riportate su un’unica riga, non devono in alcun modo andare a capo altrimenti ireport non lo riconosce come istruzione javascript.** * [[10.2.1 Inserimento di un nuovo record su classe definita]] * [[10.2.2 Apertura scheda di dettaglio(pop-up)]] * [[10.2.3 Apertura scheda di dettaglio(tab)]] * [[10.2.4 Apertura lista con filtro su classe definita]] * [[10.2.5 Apertura report da report(open report HTML)]] * [[10.2.6 Apertura report da report(open report di classe)]] * [[10.2.7 Apertura di mappa da report HTML]] * [[10.2.8 Apertura di planimetria da report HTML]] * [[10.2.9 Inserimento di immagine tipo SVG su report]] * [[3.2.10 Chiamata di un'azione definita in un 'groovy']] ===INSERIMENTO DI UN NUOVO RECORD SU CLASSE DEFINITA=== n questo caso occorre definire all'interno del file jrxml della report un oggetto che abbia il collegamento. Riporto di seguito i passaggi eseguiti: Inserimento di immagine all'interno della report html Selezionare l’immagine inserita, tasto destro del mouse e selezionare //**Collegamento**// Selezionato il comando collegamento si aprirà la maschera di definizione dello stesso Impostare Hyperlink target = Self Hyperlink type = Reference Nell’ Hyperlink Reference Expression occorre riportare la seguente stringa: ''"javascript:openGwClassDetailFloatingPane('newItem', 'ClassName');"'' {{:gwusermanual:reps.png?600|}} L’unico parametro che deve essere modificato è il parametro ClassName che rappresenta il nome della classe in cui verrà inserito un nuovo record Nell'esempio riportato di fianco ho aggiunto la possibilità di inserire un nuovo elemento nella classe ril_cabina. ===APERTURA SCHEDA DI DETTAGLIO (pop – up)=== Aprire la report con ireport; Selezionare il valore che deve avere un Hyperlink Tasto destro del mouse e selezionare //**Collegamento**// Impostare Hyperlink target = Blank Hyperlink type = Reference Nell’ Hyperlink Reference Expression occorre riportare la seguente stringa: ''"javascript:openGwClassDetailFloatingPane(‘itemId’,’className’);"'' {{:gwusermanual:rep6a.png?600|}} itemID = Inserire la chiave primaria della classe ClassName = Inserire il nome della classe a cui si fa riferimento per apertura della scheda di dettaglio Nell’ esempio riportato ho creato un hyperlink che, selezionando un campo definito apre la scheda di dettaglio in base alla chiave primaria del campo stesso e relativa classe. Esempio: "javascript:openGwClassDetailFloatingPane(" + $F{OGC_FID} +", 'ril_cabina');" ===APERTURA SCHEDA DI DETTAGLIO (tab)=== Aprire la report con ireport; Selezionare il valore che deve avere un Hyperlink Tasto destro del mouse e selezionare Collegamento Selezionato il comando collegamento si aprirà la maschera di definizione dello stesso Impostare Hyperlink target = Self Hyperlink type = Reference Nell’ Hyperlink Reference Expression occorre riportare la seguente stringa: "javascript:var avoidReturn = openGwClassDetailTab('"+$F{nome_campo}+"','nome_classe',{ forceReplaceTab: true });" $F{nome_campo} = Inserire la chiave primaria della classe Nome_classe = Inserire il nome della classe a cui si fa riferimento per apertura della scheda di dettaglio L’aggiunta di var avoidReturn serve per aggirare problemi legati ad alcuni browser tipo Internet Explorer e Mozilla Firefox nella visualizzazione di alcuni tab legati alla report html ===APERTURA LISTA CON FILTRO SU CLASSE DEFINITA=== Dopo aver selezionato il campo che dovrà avere il collegamento (sempre all'interno della report in jreport) definire lo stesso inserendo la seguente stringa: "javascript:var tabWidgetType = 'gwClassList'; var className = 'Ril_Pod'; var tabName = className; var tabWidgetId =tabWidgetType+'_'+tabName+'_tab'; var tabWidgetTitle = 'Elenco POD fornitura Centralizzata'; var parametersMap = {className: className,staticFilters: { condition: 'AND', columnName: 'tipo_fornitura', operator: '=', filterType: 'STRING', value: ['Centralizzata'] } };openTab(tabWidgetId, tabWidgetType, tabWidgetTitle, parametersMap);" Bisogna definire le seguenti variabili: className: nome della classe di riferimento sulla quale si vuole aprire la lista filtrata tabWidgetTitle: Titolo dell’elenco filtrato parameterMap: in questa variabile si deve definire la condizione del filtro che si vuole applicare e quindi columnName: nome della colonna sulla quale si effettua il filtro; operator filterType: stringa, numero ecc. ecc., dipende dal tipo di campo che si filtra; value: valore della colonna per il quale si effettua il filtro. ===APERTURA REPORT DA REPORT (OPEN REPORT HTML)=== Dopo aver selezionato il campo che dovrà avere il collegamento (sempre all’interno della report in jreport) definire lo stesso inserendo la seguente stringa: "javascript:var tabWidgetType = '**gwHtmlReport**'; var reportUrl='Cruscotto/Conteggi_POD_Cabine.jasper'; var tabName = className; var tabWidgetId = tabWidgetType+'_'+tabName+'_tab'; var tabWidgetTitle = 'titolo scheda'; var parametersMap = {reportUrl:reportUrl};openTab(tabWidgetId, tabWidgetType, tabWidgetTitle, parametersMap);" Definire la seguente variabile: reportUrl: inserire il percorso dove risiede la report che si vuole aprire ===APERTURA REPORT DA REPORT (OPEN REPORT DI CLASSE)=== Dopo aver selezionato il campo che dovrà avere il collegamento (sempre all’interno della report in jreport) definire lo stesso inserendo la seguente stringa: "javascript:var tabWidgetType = 'gwReport'; var className = 'Ril_Pod';var reportUrl='Cruscotto/Conteggi_POD_Cabine.jasper'; var tabName = className; var tabWidgetId = tabWidgetType+'_'+tabName+'_tab'; var tabWidgetTitle = 'titolo scheda'; var parametersMap = {className:className,reportUrl:reportUrl}; openTab(tabWidgetId, tabWidgetType, tabWidgetTitle, parametersMap);" Definire le seguenti variabili: className: inserire il nome della classe reportUrl: inserire il percorso dove risiede la report che si vuole aprire. ===APERTURA REPORT (non html) DA REPORT HTML=== "javascript:var reportName='RepVerFolderMain.pdf'; var itemId =" + $F{ID_FOLDER}+ "; var className = 'v_ver_folder';var reportUrl='VER_Report/RepVerFolderMain.jasper'; var attachment = true; var reportParameters = {className:className,attachment:attachment}; openGwReport(reportUrl,reportName,reportParameters,className,attachment);" ===APERTURA DI MAPPA DA REPORT HTML=== In questo caso occorre definire all'interno del file jrxml della report un oggetto che abbia il collegamento. Riporto di seguito i passaggi eseguiti: Inserimento di immagine all'interno della report html Selezionare l’immagine inserita, tasto destro del mouse e selezionare //**Collegamento**// Selezionato il comando collegamento si aprirà la maschera di definizione dello stesso Impostare Hyperlink target = Self Hyperlink type = Reference Nell’ Hyperlink Reference Expression occorre riportare la seguente stringa: "javascript:var gwMapName = 'nome della mappa da aprire';var mapId = gwMapName;var mapUri = project_gwid+'/mapLayout/'+gwMapName+'.html';var mapLabel = 'Mappa cruscotto';openMapTab(mapId, mapUri, mapLabel);" I parametri che devono essere impostati: gwMapName = nome della mappa che si intende aprire, la mappa deve essere stata definita negli strumenti di amministrazione di Geoweb. mapLabel = etichetta che deve essere visualizzata in apertura del tab ===APERTURA DI PLANIMETRIA DA REPORT HTML=== In questo caso occorre definire all’interno del file jrxml della report un oggetto che abbia il collegamento. Riporto di seguito i passaggi eseguiti: Inserimento di immagine all’interno della report html Selezionare l’immagine inserita, tasto destro del mouse e selezionare //**Collegamento**// Selezionato il comando collegamento si aprirà la maschera di definizione dello stesso Impostare Hyperlink target = Self Hyperlink type = Reference Nell’ Hyperlink Reference Expression occorre riportare la seguente stringa: "javascript:var gwMapName = 'nome_mappa_in_geoweb';var planId = 1234;var mapId = gwMapName+'_'+planId ;var mapUri = project_gwid+'/mapLayout/'+gwMapName+'/'+planId+'.html';var mapLabel = 'Titolo scheda planimetria';openMapTab(mapId, mapUri, mapLabel);" I parametri che devono essere impostati: gwMapName = nome della mappa che contiene la planimetria che si intende aprire, la mappa deve essere stata definita negli strumenti di amministrazione di Geoweb. planID = chiave primaria della planimetria che si intende aprire mapLabel = etichetta che deve essere visualizzata in apertura del tab ===INSERIMENTO DI IMMAGINE TIPO SVG SU REPORT=== Di seguito i passaggi per poter inserire un’immagine di tipo svg all'interno di una report con i report. - Inserire un oggetto di tipo immagine nel dettaglio della report; - Aprire l’xml editor e modificare la riga di riferimento dell’immagine con la seguente: Nell'esempio sopra riportato sono stati creati files di immagini di tipo svg che hanno come nome il codice di un singolo elemento presente in tabella, in questo modo ad ogni codice cabina viene visualizzato il relativo file di immagine. ===Chiamata di un'azione definita in un groovy=== Nell’ Hyperlink Reference Expression occorre riportare la seguente stringa: "javascript:var parameterQueryList = {filters: [{condition: 'OR',columnName: 'cod_resource_ou_zone',filterType: 'STRING',operator: '=',value: ['"+$F{cod_resource_ou_zone}+"']}]}; groovyActionList('inserisciJORTurnoSettimana_2',parameterQueryList,{gwClassName:''},function(map){openGwClassDetailTab(''+map.result, 'jor_workshift_week', { forceReplaceTab: true });});" Dove i parametri sono i seguenti: **parameterQueryList**: parametri che vengono passati al groovy. All'interno del groovy è possibile riferirsi a tali parametri con la sintassi seguente: log.debug("item:"+items[0].cod_resource_ou_zone); groovyActionList: parametri di chiamata del groovy: nome del groovy; lista parametri (sopra definita); mappa con il nome della classe nella quale è definita la action?; funzione GW che deve essere eseguita, a cui viene passato il valore restituito dal groovy; Nell’esempio viene aperto il form della classe 'jor_workshift_week', posizionato sul record ottenuto dal Groovy (PK_TURNO); ====Reports di cruscotto==== ====Template Analisi Excel==== La report di class di tipo "Analisi Excel" è una tipologia di Reportistica di Geoweb, che scrive i dati in un Documento Excel **(.xlsx)** costruito a mò di template con una serie di regole Il Documento conterrà dei fogli di lavoro di sintesi (Tabelle Pivot, Grafici) basati sul foglio dati 'riempito' da Geoweb. **Regole di definizione del Documento Excel** * Posizione del Documento: URL definito nell'Admin (comportamento analogo alle altre report di classe) es.**test/template_analysis_aec_room.xlsx** * Nome del Foglio Dati, ovvero il foglio di lavoro del Documento destinato a ospitare i dati: Data * Contenuto del foglio **'Data'**: * Elenco delle colonne riferite al nome dei CAMPI degli attributi della classe (Se non trova la colonna sulla classe viene segnalato nel log). Le colonne possono essere un sottoinsieme delle colonne che si riferiscono agli attributi della classe. **Esecuzione della Report** - Come report di lista di classe: deve essere configurata nell'Admin come report di classe di tipo "Analisi Excel". - Nell'admin, dopo aver scelto il tipo "Analisi Excel" **è possibile generare un template di Analisi Excel** contenente un foglio Data con solo tutti nomi delle colonne riferite al nome dei CAMPI degli attributi della classe. - Comparirà quindi tra le report di lista della classe - Se viene lanciata dalla lista senza elementi selezionati, riempirà il foglio //Data// con tutti i record della lista (considerando eventuali ACL e Ambiti). - Se viene lanciata dalla lista con elementi selezionati, riempirà il foglio //Data// solo con quest'ultimi 2. Come report lanciata da un cruscotto o da un pannello di lancio in HTML (es. reportHTML) - passando dei parametri di Filtro: * openListReportWithFilter(className,reportName,type,attachment,grid,queryParameter) * className: nome della classe * reportName: nome della report * type: 4 (nel caso di Template Analisi Excel) * attachment: se aprire la report come allegato (true) o in pop-up (false) * grid (opzionale): se la funzione javascript è lanciata da una lista il valore è 'grid', altrimenti 'null' * queryParameter (opzionale): filtri =====Mappe / Planimetrie===== 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 {{ :gwusermanual:10_mappe.png?600 |}} Strumenti per la personalizzazione delle mappe del progetto che compongono il singolo progetto. {{ :gwusermanual:30_mappe.png?600 |}} Da tale maschera è possibile creare nuovi mappe o modificare le impostazioni di quelli già configurate. ====Procedure di configurazione==== Tutte le procedure che seguono hanno come passi iniziali i seguenti: * effettuare l’Accesso agli strumenti di Amministrazione; * visualizzare l’Albero di Gestione dei Temi attraverso la dicitura Maps Management. ====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 mappe 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 mappe appena creata. ===Modifica/Eliminazione la 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. ====Configurare gli sfondi cartografici==== Per mappe di base si intendono le basi cartografiche che fanno da sfondo ed inquadramento del progetto. {{ :gwusermanual:31_sfondo.png?600 |}} ===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 la 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=<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'} {{ :gwusermanual:32_sfondo.png?600 |}} ==== Configurazione di un layer relativo ad una classe 'gerarchizzata' o 'classificata'==== In questo paragrafo viene descritto come configurare un layer di mapguide affinché possa supportare un meccanismo automatico di GeoWeb di creazione del layer ad ogni configurazione di una nuova famiglia o gerarchia. ===Istruzioni da seguire lato Geoweb Maestro=== - Controllare nel file configuration.properties che sia corretto il percorso definito per il parametro ‘mapguide.library.path’.\\ Es. mapguide.library.path=Library://GWMODULES \\ - Controllare negli attributi della classe che lo widget CLASSIFICATION abbia ben configurato il percorso della Mappa per il parametro <mapPath> \\ Es. Library://GWMODULES/maps/floorPlan.MapDefinition \\ - Controllare che il Tema a cui appartiene la classe sia associato al Progetto - Definire un LAYER nella classe che si chiami come la classe stessa ===Istruzioni da seguire lato MapGuide Maestro=== - Creare una cartella vuota, nella folder ‘layers’ che si chiami come la classe - Creare anche nella Mappa una cartella vuota che si chiami come la classe. - Creare nella folder ‘symbols’ un simbolo che si chiami ‘Template’ sul quale mettere una immaginetta qualsiasi che sia di formato ‘.png’ e di dimensioni 16x16 px Una volta seguite tutte le istruzioni, nel progetto sul client, ad ogni nuova definizione di Famiglia verrà creato il corrispondente layer con il simbolino scelto in quel momento. NB. È necessario aggiornare la mappa (F5) per vedere il layer subito dopo la creazione della famiglia. =====Ambiti===== Strumenti per la personalizzazione e creazione degli ambiti del progetto. Con Ambito si intende la possibilità di suddividere i dati in un numero n di sottoinsiemi indicati con il termine di valori di ambito. È quindi possibile ad esempio definire una categoria di ambito ‘Comune’ per suddividere i dati della base dati in base al comune. In questo caso potrebbero essere definiti tanti valori di ambito quanti sono i differenti comuni presenti nella base di dati. Sarà necessario individuare in ogni tabella della base dati un campo che indica il comune di appartenenza e indicare come valori di ambito i possibili valori che può assumere. Potrebbe accadere che questo campo non abbia lo stesso nome per tutte le tabelle, per questo è necessario specificare per ciascuna tabella quale è il nome di questo campo. In conclusione per ciascuna categoria di ambito deve essere indicato la lista di valori di ambito e l’associazione classe (tabella) – colonna per tutte le classi su cui si vuole applicare l’ambito. {{ :gwusermanual:29.png?600 |}} Da tale maschera è possibile creare nuovi ambiti o modificare le impostazioni di quelli già configurati. ====Procedure di configurazione==== Tutte le procedure che seguono hanno come passi iniziali i seguenti: * effettuare l’Accesso agli strumenti di Amministrazione; * visualizzare l’Albero di Gestione degli ambiti attraverso la dicitura Scopes Management. * Inserimento di nuovo ambito * Modifica/Eliminazione dell'ambito * Definizione del ambito === Inserimento di nuovo ambito === - tramite la funzione New Scope 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 il Value che è il valore in base al quale viene effettuata la suddivisione dei dati; - confermare cliccando sul tasto funzione Create; - nell’albero di gestione degli ambiti viene aggiunto il nuovo scope. ===Modifica/Eliminazione dell'ambito=== Visualizzare l’Albero di Gestione degli ambiti attraverso la dicitura Scopes Management e selezionare l’ambito: * 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 dell'ambito=== - cliccare su AmbitoDefault e si apre la finestra Scope Definition Management; - selezionare la classe che si vuole inserire nell’ambito, scegliere l’attributo (column) che contiene il Value definito per l’ambito e assegnare il Type corrispondente; - cliccare su + per aggiungere la nuovo classe alla lista e continuare con tutte le altri classi che si vogliono inserire nell’ambito; - confermare cliccando sul tasto funzione Save; - nella finestra Scope Classes vengono salvati i dati inseriti. gwusermanual/elements.txt Ultima modifica: 2024/02/26 18:02da giorgio.scali