a cura di M.L. Garberi

e-geco Clliient dii valliidaziione e normalliizzaziione degllii iindiiriizzii Manuale d Uso a cura di M.L. Garberi

1. Sommario 1. Sommario... 2 2. Introduzione... 3 3. Installazione di e-geco... 4 3.1 Prerequisiti... 4 3.2 Installazione... 4 3.3 Impostazione e Verifica della connessione ai servizi server... 5 3.3.1 Connessione mediante Servizi Web... 6 3.3.2 Connessione diretta alle stored procedures... 8 4. Architettura di e-geco... 10 5. Guida all Uso di e-geco... 11 5.1 Splash Screen... 11 5.2 Maschera Principale... 11 5.3 Import da File ASCII delimitati... 12 5.4 Impostazione dei parametri di GeoLocalizzazione... 17 Normalizzazione... 18 5.5 Normalizzazione assistita... 20 5.6 Export in File ASCII delimitati... 22 e-geco 2.03 - Manuale Utente Pag. 2 di 22

2. Introduzione La normalizzazione è un processo che modifica un oggetto per renderlo più conforme a qualche criterio di regolarità. Nel caso degli indirizzi, la normalizzazione li riconduce ad una denominazione standard fornita dai comuni che hanno rilevato lo stradario per conto della Regione Emilia-Romagna. e-geco confronta gli indirizzi contenuti nel file che gli viene sottoposto con l elenco ufficiale degli indirizzi contenuto nello stradario e nel caso di differenze riscontrate, restituisce un nuovo indirizzo ufficiale con un grado di attendibilità variabile a seconda della lontananza tra le parole confrontate e le coordinate del rettangolo che contiene l arco stradale corrispondente. L applicazione inoltre confronta il numero civico contenuto nell indirizzo fornito con i numeri civici dello stradario e restituisce la coppia di coordinate relative; anche in questo caso viene indicato il grado di attendibilità con cui il software ha riconosciuto il civico. Vengono inoltre restituite le sue coordinate nel sistema di riferimento predefinito dall Utente. Il sistema si propone di fornire all utente una serie di funzioni di normalizzazione di dati relativi ad indirizzi (Province, Comuni, vie.). e-geco utilizza per la normalizzazione i servizi e-geocoding, connettendosi ad essi in modalità web-service o, nel caso di accesso da intranet, anche mediante chiamate dirette a stored procedures. L infrastruttura necessaria per il sistema è implementata su un database Oracle. Nel DB sono presenti sia le tabelle che contengono tutti i dati necessari, sia tutto il codice PL/SQL necessario per accedere e gestire tali dati. I servizi vengono esposti in modalità webservice mediante il server SOAP-Dispenser, instalato presso la regione e raggiungibile anche da extranet con protocollo https. Il sistema opera con logiche fuzzy, ossia invece di limitarsi a dire se un certo indirizzo è valido, oppure no, propone l indirizzo ufficiale che più si avvicina a quello da identificare e ne fornisce un livello di affidabilità. Al fine di favorire l uso ampio e diffuso delle procedure di normalizzazione, è stata realizzata un applicazione Client ad hoc per la normalizzazione d indirizzari. Il software in oggetto ha quindi l obiettivo di gestire elenchi d indirizzi dell Utente e di supportare la fase di verifica e normalizzazione degli stessi interfacciandosi al servizio e-geocoding. e-geco 2.03 - Manuale Utente Pag. 3 di 22

3. Installazione di e-geco L interfaccia Utente e-geco è un applicazione desktop, da eseguire in locale e sviluppata in tecnologia Microsoft.Net 2005. 3.1 Prerequisiti Per utilizzarla e per poter operare con le funzioni di normalizzazione, è sufficiente avere installato sul proprio PC il framework Microsoft.Net 2.0 e disporre di una connessione ad internet. Se si opera dall interno della intranet regionale, è anche possibile accedere direttamente ai servizi esposti come stored procedures. In questo caso sulla postazione Utente deve essere presente anche il Client Oracle 11g a 16 bit. 3.2 Installazione Trattandosi di una applicazione Microsoft.Net full managed, per installare il software è sufficiente copiare la cartella contenente gli eseguibili e gli altri file di configurazione. il framework della Microsoft.Net 2.0, il Client Oracle per accedere al servizio di e-geocoding. copiare i file eseguibili. Il prodotto viene comunque distribuito mediante un file.msi che consente di procedere ad una installazione guidata mediante il Microsoft Windows Installer. Per eseguire la procedura di installazione guidata, è sufficiente clickare sul file Setup_eGeCo.msi Si verrà così guidati attraverso una serie di schermate fino al completamento dell installazione. e-geco 2.03 - Manuale Utente Pag. 4 di 22

Ulteriori installazioni possono essere fatte semplicemente copiando i files contenuti nella cartella di installazione prescelta. Di default il programma viene installato nella cartella: [Programmi]\Regione Emilia-Romagna\eGeoCoding\eGeCoClient\ 3.3 Impostazione e Verifica della connessione ai servizi server Prima di iniziare ad utilizzare e-geco è opportuno verificare che la connessione ai servizi server sia correttamente impostata. Le impostazioni di connessione ai servizi server di e-geocoding si differenziano a seconda della modalità di accesso. Nell angolo in basso a sinistra della finestra principale di e-geco è possibile verificare la modalità correntemente impostata. Per impostare i parametri di connessione e testare che tutto sia a posto, si deve aprire la maschera associata alla voce Servizi server : Il radiobottone Web Service / Client Server consente di definire la modalità di connessione. A seconda della scelta si devono inoltre correttamente impostare gli ulteriori parametri contenuti nelle rispettive tabs. e-geco 2.03 - Manuale Utente Pag. 5 di 22

3.3.1 Connessione mediante Servizi Web E l impostazione di default. Presuppone che il PC dell Utente possa accedere mediante extranet o internet ai servizi regionali. Le impostazioni possono richiedere il supporto di un tecnico dei sistemi informativi. Il riquadro relativo al proxy deve essere impostato nel caso in cui sia richiesto tale setup per potere accedere ai servizi di e-geocoding, che attualmente rispondono all URL https://servizigis.regione.emilia-romagna.it Il pulsante Test internet, consente di verificare che le impostazioni per l accesso a internet siano corrette. N.B.: nel caso di accesso dalla rete regionale, potrebbe essere scorretto impostare il proxy, in quanto potrebbe essere richiesto l uso del proxy per un accesso extranet, ma non per un accesso ai servizi interni alla rete. Il pulsante Test Servizio effettua un test di una chiamata ad uno dei servizi esposti da e- GeoCoding. Per effettuare questo test è necessario disporre di un account (utente/password) abilitato. Il test può dare luogo a tre differenti risultati, nel seguito descritti. Chiamata Riuscita Se l applicazione si è riuscita correttamente a collegare ai servizi di e-geocoding, apparirà una finestra come la seguente: e-geco 2.03 - Manuale Utente Pag. 6 di 22

Eccezione SOAP Se l applicazione si è riuscita correttamente a collegare ai servizi server messi a disposizionemediante SOAP-Dispenser, ma non è riuscita a chiamare le procedure di e-geocoding, apparirà un messaggio simile al seguente: In questo caso, è possibile che non siano stati immessi correttamente i dati di accesso (utente o password, oppure che vi siano dei momentanei problemi sul database). Se invece appare una segnalazione di errore differente da una eccezione SOAP, allora è possibile che vi sia uno di questi problemi: le impostazioni di connessione sono sbagliate (ad esempio la configurazione del proxy) ci sono dei problemi di rete l URL del servizio non è corretto il server regionale su cui è installato SOAP Dispenser è temporaneamente inattivo In questi casi, se il messaggio che compare nella finestra non è di aiuto a risolvere il problema, si può provare un ulteriore test mirato a verificare i pacchetti di informazione che e-geco sta scambiando con i servizi server. Si tratta di una pagina di test che è stata realizzata per i tecnici al fine di meglio identificare la natura del problema. e-geco 2.03 - Manuale Utente Pag. 7 di 22

3.3.2 Connessione diretta alle stored procedures Questa modalità di connessione è utilizzabile solo dalla intranet regionale, e richiede che sul PC dell Utente sia installato un Client Oracle 10g o 11g a 16 bit. Per configurare la connessione occorre conoscere ed impostare correttamente il tnsname associato al database, l utente e la password Oracle predefinita per l accesso diretto ai servizi. Impostazioni al database locale e-geco 2.03 - Manuale Utente Pag. 8 di 22

La maschera di Impostazioni Base Dati Locale, consente di definire la posizione del database in formato Access destinato ad accogliere l indirizzario da normalizzare: egeco.mdb Questo file si trova di default nella stessa cartella degli eseguibili e al primo lancio della applicazione dopo il setup, il percorso del file viene automaticamente impostato in modo corretto. E possibile però che un Utente decida di spostare l intera cartella di e-geco, oppure di mantenere questo file in un altra posizione del file system. In questi casi occorre aggiornare il puntamento mediante la finestra in oggetto, ed agendo attraverso il pulsante... Il pulsante Test, consente di verificare che il sistema acceda correttamente al file Access. Per l accesso al file Access viene utilizzata la libreria Microsoft.jet.OLEDB4.0, che normalmente è disponibile su tutti i sistemi Windows. In caso di problemi si suggerisce ai tecnici di consultare l articolo presente al seguente link: http://support.microsoft.com/kb/239114 e-geco 2.03 - Manuale Utente Pag. 9 di 22

4. Architettura di e-geco Il software e-geco guida l utente durante il processo di normalizzazione e permette di: acquisire file.txt contenenti gli indirizzari, memorizzandoli in un database di appoggio locale effettuare la normalizzazione degli indirizzi, sia in modalità massiva/batch, che assistita dall Utente, mediante chiamate ad e-geocoding consentire di riesportare i file normalizzati in un formato testo che possa essere reimportato nei database dell Utente. Oracle e-geocoding DBOracle Rete.txt e-geco.txt File di indirizzi da normalizzare.mdb File di indirizzi normalizzato Db locale Le comunicazioni tra il Client ed il server avvengono attraverso lo strato di networking. e-geco 2.03 - Manuale Utente Pag. 10 di 22

5. Guida all Uso di e-geco 5.1 Splash Screen Lanciando l applicazione, viene visualizzata per qualche secondo la splash screen, per poi accedere alla maschera principale: 5.2 Maschera Principale La maschera da cui si potranno selezionare le varie attività che il software svolge: e-geco 2.03 - Manuale Utente Pag. 11 di 22

5.3 Import da File ASCII delimitati Con questa funzione s importano i dati da normalizzare presenti in un file ASCII di tipo delimitato, ovvero con campi e record separati da caratteri speciali (tab,...). L importazione è fatta attraverso una serie di maschere stile wizard, in cui l Utente deve descrivere le caratteristiche del file, i cui dati saranno memorizzati in un file.mdb locale; inoltre è possibile memorizzarsi le caratteristiche del file per una successiva normalizzazione di una banca dati simile. Eseguendo un importazione, i dati precedentemente memorizzati nel mdb locale saranno persi. È quindi molto importante a fine normalizzazione esportare sempre i dati! Passo 1 Definizione file Il primo passo consiste nella definizione del file da importare o nell eventuale recupero di una configurazione pre-definita. File da Importare - Il tasto contrassegnato da permette di navigare il proprio albero delle directory per effettuare la scelta del file da importare. Il file deve essere in formato txt con i campi delimitati. File di Definizione Il software, come già detto, permette di memorizzare le impostazioni definite per l importazione, in modo da riutilizzarle per banche dati analoghe. Il tasto contrassegnato da permette di navigare il proprio albero delle directory per effettuare la scelta del file di Definizione già salvato in una precedente sessione di normalizzazione. e-geco 2.03 - Manuale Utente Pag. 12 di 22

Passo 2 Definizione delimitazioni Nel secondo passo sono specificati i delimitatori di campo e di riga, nonché si indicherà se la prima riga è costituita dalle intestazioni. Il programma importa al massimo 50 colonne di dati. Delimitatore di riga nel menu a tendina è possibile identificare i caratteri che delimitano le righe Delimitatore di colonna - nel menu a tendina è possibile identificare i caratteri che separano i campi: Virgola, Tabulazione oppure Punto e Virgola. Intestazioni La check box consente di segnalare al software se è presente una riga di intestazioni. e-geco 2.03 - Manuale Utente Pag. 13 di 22

Passo 3 Definizione Provincia e Comune Nel terzo passo si indica al software in quale posizione sono presenti le informazioni relative alla provincia ed al comune. Identificazione Provincia nel menu a tendina è possibile identificare il campo che contiene il dato della Provincia. I radio-button consentono di identificare se il campo contiene la denominazione della provincia oppure il Codice Istat, composto da tre cifre. Identificazione Comune - nel menu a tendina è possibile identificare il campo che contiene il dato del Comune. I radio-button consentono di identificare se il campo contiene la denominazione del Comune oppure il Codice Istat, definibile nella forma a 3 o a 6 cifre. Passo 4 Definizione Toponimo Il quarto passo consente di fornire al software in quali campi risiedono le informazioni relative al toponimo ed alla Denominazione Urbana Generica DUG (via, p.zza, viale,...). e-geco 2.03 - Manuale Utente Pag. 14 di 22

Identificazione Toponimo nel menu a tendina è possibile identificare il campo che contiene il dato del Toponimo (il toponimo è inteso come nome della strada nei centri urbani o come località nell extraurbano). Il toponimo può contenere in un solo campo l intero indirizzo, ad esempio Via Verdi 25, oppure la banca dati di origine può essere strutturata in modo tale per cui l indirizzo è costituito da due o da tre campi separati. L Utente deve indicare al software cosa contiene il toponimo. Identificazione Denominazione Urbana Generica DUG il DUG è la tipologia di denominazione che una strada può avere: Via, Piazza, Viale... Se il DUG è contenuto nello stesso campo del nome della strada, la check box deve essere vuota, nel caso invece sia contenuto in un campo a parte, va taggata la box e deve essere indicato, attraverso il menu a tendina, il campo che lo contiene. Passo 5 Definizione Numero Civico Il quinto passo consente di specificare le informazioni relative al numero civico ed al suffisso. Identificazione Civico la check box va taggata solo se il numero civico è contenuto in un campo diverso dal toponimo. Il menu a tendina permette di scegliere l eventuale campo che contiene il civico. Il suffisso non è incluso nel campo del numero civico. Nel caso in cui venga taggata la check box precedente la finestra permette di indicare anche se il suffisso al numero civico è contenuto in un campo separato. Il menu a tendina permette di scegliere l eventuale campo che contiene il civico e-geco 2.03 - Manuale Utente Pag. 15 di 22

Passo 6 Salvataggio Impostazioni Il sesto passo consente di salvare le definizioni appena passate al software per successive importazioni di file con la medesima struttura. Passo 7 Importazione Al termine delle impostazioni si procede all importazione vera e propria delle informazioni, il software comunica il termine del processo. e-geco 2.03 - Manuale Utente Pag. 16 di 22

5.4 Impostazione dei parametri di GeoLocalizzazione Le funzioni di normalizzazione, oltre a restituire i nomi ufficiali dei toponimi e gli identificativi univoci delle entità ad essi associati, restituiscono un set di coordinate utili alla geo-localizzazione, ovvero a rappresentare le informazioni associate all indirizzario su una mappa. e-geco consente di restituire queste coordinate espresse secondo uno qualsiasi dei sistemi di riferimento regionali. Per quanto concerne i numeri civici, è inoltre possibile selezionare il tipo di coordinate associate all entità. L impostazione di questi parametri avviene mediante la maschera Parametri del menù Normalizzazione. Queste impostazioni devono essere fatte prima di effettuare la normalizzazione dell indirizzario. e-geco 2.03 - Manuale Utente Pag. 17 di 22

Normalizzazione La funzione di normalizzazione massiva esamina ciascun indirizzo presente nell indirizzario importato e, mediante una chiamata al servizio di e-geocoding, ne effettua la normalizzazione. Questo processo consente di aggiungere le informazioni sui dati normalizzati accanto alle informazioni presenti nel file originale. Le informazioni che saranno correlate sono: Nome Campo Descrizione STRADARIO_ID Codice identificativo del Toponimo usato dai servizi di e-geocoding ENTITA_ID Codice dell'entità così come definita nel db Topografico DUG Descrizione denominazione urbanistica generica (Via, Piazza,.) DENOMINAZIONE Nome della strada, denominazione dell'area di circolazione. TIPO_STRADA Tipoogia della strada COMUNE Comune in cui è effettuata la ricerca PROVINCIA Provincia in cui è effettuata la ricerca REGIONE Regione in cui è effettuata la ricerca MIN_X Minima coordinata X del rettangolo di inclusione dell arco Stradale, espressa nel sistema di riferimento selezionato. MIN_Y Minima coordinata Y del rettangolo di inclusione dell arco Stradale, espressa nel sistema di riferimento selezionato. MAX_X Massima coordinata X del rettangolo di inclusione dell arco Stradale, espressa nel sistema di riferimento selezionato. MAX_Y Massima coordinata X del rettangolo di inclusione dell arco Stradale, espressa nel sistema di riferimento selezionato. CENTR_X Coordinata X del centroide relativo all arco Stradale, espressa nel sistema di riferimento selezionato. CENTR_Y Coordinata Y del centroide relativo all arco Stradale, espressa nel sistema di riferimento selezionato. CIVICO_ID Codice che identifica il numero civico all interno dei servizi di e- GeCoding. Se il civico non viene trovato, viene restituito NULL ENTITA_CIVICO_ID Codice che identifica il numero civico all interno del database topografico. Se il civico non viene trovato, viene restituito NULL NUM_CIVICO Numero civico. Se il civico non viene trovato, viene restituito NULL SUFFISSO_CIVICO CIVICO_X CIVICO_Y GR_AFFIDABILITA GR_AFFIDABILITA_CIV Suffisso. Se il suffisso non viene trovato, viene restituito NULL Coordinata X del civico, espressa nel sistema di riferimento selezionato. Se il civico non viene trovato, viene restituito NULL Coordinata Y del civico, espressa nel sistema di riferimento selezionato. Se il civico non viene trovato, viene restituito NULL Grado di affidabilità della riga restituita sulla base del toponimo (escluso il civico). Valori bassi indicano una maggiore affidabilità. 0 indica la massima affidabilità. Grado di affidabilità del numero civico. 0 indica la massima affidabilità; 1 non è stato trovato il suffisso, se passato come e-geco 2.03 - Manuale Utente Pag. 18 di 22

NUMERO_RIGHE DTA_LAST_UPD ERR_MSG parametro, altrimenti non è stato trovato il civico; 2 non è stato trovato ne il civico ne il suffisso. Totale delle righe restituite Data dell ultima normalizzazione Eventuale messaggio di errore Dato che il processo di normalizzazione potrebbe richiedere molto tempo, sarà possibile interrompere e riprendere questo processo, oppure partizionare questo processo in più sessioni. A tal fine è stata prevista un area di filtro in cui specificare alcuni criteri con cui selezionare i dati che dovranno essere normalizzati/ri-normalizzati. È possibile filtrare i dati per il criterio della provincia, del comune o del grado di affidabilità. È inoltre possibile taggando l apposita check box scegliere indirizzi normalizzati rispetto ad una data. Questo criterio è utile quando, ad esempio, si sono aggiunti indirizzi nuovi ad un elenco, che non contengono ancora la data di normalizzazione. e-geco 2.03 - Manuale Utente Pag. 19 di 22

5.5 Normalizzazione assistita La funzione di normalizzazione assistita prevede una griglia di dati, da usare per visualizzare i dati dell indirizzario, modificarli e per potere effettuare una normalizzazione manuale, in base all elenco di risposte che il sistema propone. La maschera propone due TAB: Filtro e Dati. La tab Filtro è stata pensata perchè il sistema potrebbe trattare anche quantità molto significative di dati,per cui è necessario assicurare di portare a video un numero di record compatibile con le risorse del sistema (indicativamente fino a qualche decina di migliaia). È possibile filtrare i dati per il criterio della provincia, del comune o del grado di affidabilità. È inoltre possibile taggando l apposita check box scegliere indirizzi normalizzati rispetto ad una data. e-geco 2.03 - Manuale Utente Pag. 20 di 22

La tab Dati consente di : modificare i dati di descrizione del toponimo provenienti dall indirizzario da normalizzare (campi gialli), in modo da correggerli e facilitarne la normalizzazione, digitando direttamente nel campo da correggere richiamare, con il tasto Normalizza il servizio di normalizzazione su uno specifico indirizzo, ottenendo in questo modo, invece dell indirizzo più simile a quello, una intera lista degli indirizzi più somiglianti, con il relativo grado di affidabilità. L utente seleziona la riga di interesse, confermando la normalizzazione manuale. e-geco 2.03 - Manuale Utente Pag. 21 di 22

5.6 Export in File ASCII delimitati Questa funzione consente di esportare i dati normalizzati secondo il formato di tipo testo delimitato. Delimitatore di Riga i delimitatori possono essere Windows (CR+LF) oppure Unix (CR) Delimitatori di colonna i delimitatori possono essere Tab, Virgola o Punto e Virgola. La funzione, inoltre, richiede di indicare se inserire oppure no le intestazioni delle colonne nella prima riga del file. e-geco 2.03 - Manuale Utente Pag. 22 di 22