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

Configurazione tipo documento in Vista Plus

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:

Configurazione per 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!