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 tre pannelli di configurazione distinti: uno per l'accesso Web Browser, uno per l'accesso Web Services e uno per la configurazione della mappatura dei meta dati. Una spunta presente nei primi due pannelli 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.
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.
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.
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 e vengono gestite esclusivamente dal driver stesso.
L'utente specificato deve avere i permessi necessari alla corretta gestione dei documenti: inserimento/modifica/cancellazione.
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
Attenzione: Dato che le informazioni relative allo stato del documento non vengono assolutamente persistite in locale ma vengono demandate a Vista Plus, è estremamente importante che il tipo di documento utilizzato venga configurato in Vista Plus come segue
| 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.
Trasferire file in blocchi da (Kb)
Il trasferimento in invio e in ricezione dei documenti avviene a blocchi. E' possibile specificare una dimensione di blocco minimo di 1 Kb e massimo di 9999 Kb. Una dimensione maggiore garantisce minore overhead durante il trasferimento. Se si verificano problemi di timeout è necessario impostare un valore inferiore. Se non impostato, il default è 100 Kb.
Mappatura metadati
E' possibile definire una connessione tra i metadati dell'applicativo locale e quelli definiti in Vista Plus. Ci sono due tipi di mappature: una per le ricerche ed una per lo storage dei metadati.
La mappatura per le ricerche (SEARCH) e' una mappatura in sola lettura e viene utilizzata esclusivamente dalla funzione di ricerca WEB.
Al contrario, la mappature per lo storage (R/W) e' in lettura/scrittura e permette di memorizzare dei metadati assieme al documento durante la fase di inserimento in Vista Plus.
Di default le mappature sono SEARCH, per retro compatibilità.
Il seguente esempio di configurazione è applicabile alla situazione di ricerca dell'Anagrafe Dematerializzata:
| Nome locale | Nome VistaPlus | Tipo VistaPlus | Uso |
|---|---|---|---|
| cognome | COGNOME | STRING | SEARCH |
| nome | NOME | STRING | SEARCH |
| data_nas | DATANAS | DATE | SEARCH |
Quando invece si utilizza la mappatura R/W e' necessario definire gli attributi mappati anche in Vista Plus tramite un opportuno tipo di documento. Si ricorda che il tipo di documento, oltre contenere i dati mappati esplicitamente tramite il pannello di mapping del driver deve contenere anche tutti gli attributi necessari alla corretta gestione del documento da parte dell'applicativo locale, come definito precedentemente.
Nota: La funzione di ricerca lato client seve essere supportata dall'applicativo chiamante!