Servizio di importazione automatica documenti
Servizio di importazione automatica di allegati da file-system
Jolly consente l'importazione automatica di documenti (tipicamente
PDF, ma non solo) da file-system.
Questa funzionalità è svolta dall'applicazione JOLLY_IMPORT_SERVICE.exe.
INFORMAZIONI GENERALI
JOLLY_IMPORT_SERVICE è un servizio di Window (un servizio di Windows).
Il nome del servizio (che si può trovare sull'elenco dei servizio di
Windows) è "JOLLY importazione documenti".
Per far funzionare il servizio è necessario:
- eseguire l'installazione del servizio attraverso il comando JOLLY_import_server.exe /INSTALL (per disinstallare il servizio usare il parametro /UNINSTALL); esistono comandi già predisposti sia per l'installazione che per la disinstallazione
- eseguire le opportune configurazioni nel file JOLLY_import_server.INI
Tutti i files necessari per la funzionalità di importazione automatica si trovano nella cartella bin\IMPORT-SERVICE.
MODALITA' DI FUNZIONAMENTO
Il servizio di importazione documenti acquisisce documenti precedentemente salvati su file-system (tipicamente da un dispositivo che esegue una funzione di scan-to-folder) e li salva come allegati di Jolly in modalità TCP server (file system) (non è supportata la modalità di salvataggio all'interno del database).
Di norma il servizio JOLLY_import_server viene installato esclusivamente
sul server (o comunque sulla macchina dove vengono salvati i
documenti, o su una macchina che può accedere a tali documenti), e non deve
essere installato sui clients.
E' infatti importante - sia per motivi di gestione che per motivi di
riservatezza - che gli utenti non possano accedere direttamente alle cartelle
che contengono i files scansionati, ma possano accedere agli stessi solo
attraverso un'interfaccia (in questo caso rappresentata da Jolly) che separi
fisicamente il documento dall'utente che vi accede e che determini i diritti di
accesso di ogni utente in base a regole stabilite dall'amministratore del
sistema (o, nel caso, dall'amministratore di Jolly).
In linea teorica è comunque possibile installare più copie del servizio su
macchine differenti per gestire configurazioni più articolate. Per ciascuna
copia del servizio dovranno essere applicati i principi qui delineati.
PARAMETRI DI CONFIGURAZIONE DEL SERVIZIO
I parametri di configurazione del servizio si trovano nel file JOLLY_import_server.INI.
La presenza di questo file è obbligatoria.
Commenti (remarks): tutto ciò che su ciascuna riga segue una
doppia barra ( // ) viene considerato commento ed ignorato.
Messaggi di servizio: le comunicazioni di sistema (il registro di importazione ed
eventuali messaggi di errore) vengono spedite via SMTP agli indirizzi mail
specificati nelle opzioni
generali di Jolly.
I parametri del file di configurazione sono i seguenti:
- REGISTRO=valore -- modalità di gestione del registro di
importazione;
i valori validi sono i seguenti: 1=solo eventi principali, 2=registro dettagliato, 3=informazioni di debug - CONSOLE -- senza parametri; se specificato, i messaggi scritti nel registro vengono inviati anche alla console di sistema; da utilizzare esclusivamente per debugging purposes
- MINUTI-PERIODO-INVIO-ERRORI=valore -- rappresenta il periodo (in
minuti) di invio via SMTP di eventuali messaggi di errori; default=30;
specificare 0 per disattivare la funzionalità di trasmissione degli errori
ORE-PERIODO-INVIO-REGISTRO=valore -- periodo di trasmissione via SMTP del registro di importazione; serve anche per segnalare all'amministratore che il servizio è in funzione; default = 24 ore
- SMTP-HOST=host per la spedizione dei messaggi SMTP
- SMTP-FROM=indirizzo utilizzato per la spedizione dei messaggi SMTP
- SMTP-AUTH-ID=ID di autenticazione per il server SMTP
- SMTP-AUTH-PWD=password di autenticazione per il server SMTP
- DATABASE-SERVER=server -- server database di Jolly; default = jolly
- DATABASE-NAME=database -- database di jolly; default = jolly
- ODBC-SOURCE=nome -- sorgente dati ODBC che consente l'accesso al database di Jolly; alternativa a DATABASE-SERVER e DATABASE-NAME
- DATABASE-USER=username -- user da utilizzare per l'accesso al database
- DATABASE-PASSWORD=password -- password da utilizzare per l'accesso
al database
- SPOSTA-SU-PATH=path -- dopo l'acquisizione il file importato viene spostato sulla cartella specificata; il parametro è obbligatorio; può contenere MACRO DI SOSTITUZIONE e variabili di ambiente di sistema (del tipo %ProgramFiles%)
MACRO DI SOSTITUZIONE (lato server)
E' possibile definire delle macro di sostituzione sul lato server in
tutto e per tutto simili a quelle
gestite dal TCP server.
La definizione delle macro deve avvenire nel file JOLLY_import_server.INI.
I paths su cui ricercare i documenti da importare, prima di essere
applicati, saranno trattati alla ricerca di eventuali macro.
La sintassi delle macro lato server è la seguente:
#NOMEMACRO#=definizione
Tutte le occorrenze di #NOMEMACRO# saranno sostituite con definizione.
Solo a titolo di promemoria si ricorda che i paths possono contenere
anche delle variabili di ambiente.
GESTIONE DEGLI ERRORI
In caso di erronea o mancata identificazione della tabella e/o del record, il documento viene ignorato e viene registrato un errore nel registro di importazione.