Configurazione Driver di Repository Vista Plus
Introduzione
Questa interfaccia permette le configurazione del driver di repository documentale Vista Plus dell'azienda Tesi&Automazione.
Modalità di funzionamento
Il driver possiede due pannelli di configurazione distinti: uno per l'accesso Web Browser ed uno per l'accesso Web Services. Una spunta presente in ogni pannello permette di attivare o meno la funzionalità . E' possibile configurare entrambi oppure uno solo dei due pannelli. Un driver con entrambe le funzionalità disattivate non permetterà alcun tipo di operazione.
Accesso Web Browser
Questa funzione permette di sfruttare l'interfaccia dedicata dell'applicazione Vista Plus per visualizzare i risultati delle ricerche. Questa funzionalità dev'essere esplicitamente attivata dall'applicazione chiamante. Se l'applicazione chiamante non supporta la funzione di ricerca lato client verrà utilizzata la funzione di ricerca lato server (lo standard). La particolarità di questa visualizzazione con applicazione dedicata consiste nel fatto che i risultati verranno visualizzati in una pagina del Web Browser. Quindi per la visualizzazione dei risultati comparirà automaticamente il programma di navigazione Web e l'applicazione chiamante verrà messa temporaneamente in secondo piano. Una volta che il browser Web è stato invocato, l'applicazione chiamante può lavorare simultaneamente allo stesso.
La funzione di accesso Web Browser ha l'unico scopo di visualizzare i risultati delle ricerche. Per la manipolazione dei documenti è necessario utilizzare la funzione di accesso Web Service.
Accesso Web Service
La funzione di accesso Web Service permette di interagire con Vista Plus al fine di inserire/modificare/cancellare documenti. La funzione permette di lavorare su una partizione di Vista Plus che verrà dedicata al driver. In particolare, i documenti interessati potrebbero essere quelli della funzione "documenti collegati".
Configurazione Accesso Web Browser
Di seguito vengono descritti i vari parametri presenti nel pannello.
Abilita accesso Web Browser
Attiva o meno la funzionalità .
URL di base
L'URL dove è situata l'installazione dell'applicazione Web Vista Plus.
Ad esempio: http://www.vistaplus.it
Nome applicazione Vista Plus
E' il nome dell'applicazione alla quale ci si vuole connettere. Vista Plus prevede un partizionamento del suo archivio con un primo livello di granularità detto "applicazione".
Ad esempio: ArchivioComunale
Folder per ricerche
E' un filtro che si può impostare (opzionale) per restringere i risultati delle ricerche.
Ad esempio: SERVIZIDEMOGRAFICI
Tipo doc. per le ricerche
E' un ulteriore filtro (opzionale) per restringere la ricerca su particolari tipologie di documento. Non essendo possibile, a livello di Vista Plus, definire una lista di tipi di documento, se la ricerca deve agire su più tipi contemporaneamente è necessario lasciare questo campo vuoto e andare ad agire sul campo Folder. Questo tuning necessita una corretta configurazione anche dell'ambiente Vista Plus.
Mappatura metadati per ricerche
La funzione di accesso lato client è stata sviluppata principalmente per ricerche tramite l'uso di metadati. E' necessario configurare la mappatura tra i metadati dell'applicazione locale e i metadati dell'applicazione Vista Plus al fine di garantire la corretta generazione dei parametri di ricerca.
Il seguente esempio di configurazione è applicabile alla situazione di ricerca dell'Anagrafe Dematerializzata:
| Nome locale | Nome VistaPlus | Tipo VistaPlus |
|---|---|---|
| cognome | COGNOME | STRING |
| nome | NOME | STRING |
| data_nas | DATANAS | DATE |
Nota: La funzione di ricerca lato client seve essere supportata dall'applicativo chiamante!
Configurazione Accesso Web Services
Di seguito vengono descritti i vari parametri presenti nel pannello.
Abilita accesso Web Services
Attiva o meno la funzionalità .
Port Address (URL)
L'indirizzo della porta di accesso al Web Service.
Ad esempio: http://www.vistaplus.it/VistaPlus.asmx
Nome applicazione VistaPlus
Stesso significato del medesimo parametro per l'accesso Web Browser. In particolare, si noti che per i due accessi le applicazioni possono differire.
Utente
E' l'utente Vista Plus che verrà utilizzato dal driver per effettuare la connessione. Tutte le chiamate vengono effettuate tramite il medesimo utente, indipendentemente dall'utente dell'applicazione locale. Le informazioni relative all'utente fisico che ha effettuato l'operazione vengono immagazzinate nei meta dati del documento Vista Plus.
Password
La password dell'utente Vista Plus.
Folder per nuovi documenti
E' il folder dell'applicazione Vista Plus dove verranno posizionati i nuovi documenti inseriti. Questa informazione serve per l'inserimento del documento ma non viene utilizzata per l'accesso diretto al documento in quanto questo viene acceduto per identificativo diretto. Questa informazione influenza anche i filtri di ricerca quando viene utilizzata la ricerca lato server.
Ad esempio: SICRAWEB_FOLDER
Tipo doc. per nuovi documenti
E' il tipo documento che viene assegnato ai nuovi documenti.
Ad esempio: SICRAWEB_DOC
E' estremamente importante che il tipo di documento utilizzato venga configurato in Vista Plus nel seguente modo:
| Descrizione | Codice | Tipo | Lunghezza |
|---|---|---|---|
| Nome file | FILE_NAME | Alfanumerico | 200 |
| Descrizione file | FILE_DES | Alfanumerico | 500 |
| Stato di modifica | MODIFY_STATUS | Numerico intero | 20 |
| Data creazione | CREATE_DATE | Alfanumerico | 20 |
| Id utente creazione | CREATE_USER_ID | Numerico intero | 20 |
| Utente creazione | CREATE_USER | Alfanumerico | 64 |
| Data ultimo check out | LAST_CHECK_OUT_DATE | Alfanumerico | 20 |
| Id utente ultimo check out | LAST_CHECK_OUT_USER_ID | Numerico intero | 20 |
| Utente ultimo check out | LAST_CHECK_OUT_USER | Alfanumerico | 64 |
| Data ultimo check in | LAST_CHECK_IN_DATE | Alfanumerico | 20 |
| Id utente ultimo check in | LAST_CHECK_IN_USER_ID | Numerico intero | 20 |
| Utente ultimo check in | LAST_CHECK_IN_USER | Alfanumerico | 64 |
Nota: Attenzione al fatto che i campi identificati come data sono definiti invece come alfanumerici. Questo è necessario in quanto Vista Plus non gestisce l'ora.
Dato che le informazioni relative allo stato del documento non vengono assolutamente persistite in locale ma vengono demandate a Vista Plus, è assolutamente necessario che il tipo di documento sia definito come sopra descritto, altrimenti il driver non sarà in grado di interagire correttamente con il repository remoto.