Per poter acquisire un documento da scanner è necessario che sul proprio PC sia installato il componente ZMicro HTTP Server (che per semplicità chiameremo Zscanner). Se si avviva l'acquisizione da scanner ed il componente non è installato verrà visualizzata la schermata per eseguire il download dal server e la successiva installazione.
Durante la fese di installazione sarà proposto quali componenti installare, lasciare attive entrambe le voci:
ZMicro HTTP Server
ZScanner Extensions
Al termine dell'installazione in automatico viene lanciato il componente per l'acquisizione.
Per verificare se il componente è in esecuzione controllare se nella barra di sistema di Windows è presente l'icona come in figura:
A questo punto, dopo aver installato e mandato in esecuzione il componente possiamo procedere con l'acquisizione da scanner.
La libreria ZScanner.dll è scritta in C++ e utilizza la libreria EZTWain di DOSADI (www.dosadi.com).
Tale libreria, nativamente, supporta la lettura di Barcode 3 of 9, ma è aperta all'utilizzo di altre librerie per la lettura di barcode, in particolare :
EZBAR_ENGINE_AXTEL - Axtel AX-4 engine (non consigliata)
EZBAR_ENGINE_LEADTOOLS - LEADTOOLS engine (ltbar15u.dll) (www.leadtools.com)
EZBAR_ENGINE_BLACKICE - Black Ice engine (BiBrw1D.dll) (www.blackice.com)
Tutte le librerie sopra elencate necessitano di eventuale licenza;
Attualmente Infinity usa la libreria di lettura built-in con DOSADI;
Per quanto concerne la lettura OCR, le librerie DOSADI si appoggiano alla libreria Transym TOCR engine (http://www.transym.com), l'acquisto della licenza per questa libreria è a carico del concessionario/utente che possono provvedere autonomamente.
I vari parametri di acquisizione possono essere letti e modificati agendo sul file ”r;zscanner.settings” presente nel proprio pc nella cartella C:\Programmi\ZMicro (default) di cui riportiamo esempio:
; Abilita/Disabilita il logging sul file zscanner.log
; Valori ammessi : true / false
enable_log = false
; Barcode Engine
; Seleziona il motore di acquisizione barcode da utilizzare
; Valori ammessi :
; EZBAR_ENGINE_NONE - Turns off recognition
; EZBAR_ENGINE_DOSADI - Dosadi built-in Code 3-of-9 engine
; EZBAR_ENGINE_AXTEL - Axtel AX-4 engine
; EZBAR_ENGINE_LEADTOOLS - LEADTOOLS engine (ltbar15u.dll)
; EZBAR_ENGINE_BLACKICE - Black Ice engine (BiBrw1D.dll)
barcode_engine = EZBAR_ENGINE_DOSADI
;Black Ice engine settings per lettura barcode 1D
DilationSize = 3;
MinimalBarNumber = 5;
EnlargePercent = 10;
MinimalSideLengthRatio = 2.5;
MaxDistanceRatio = 3.8;
MaxAngleDifference = 20.0;
;Black Ice engine settings per lettura barcode 2D - DataMatrix
; Minimal Cell Size in pixel
DataMatrix_MinimalCellSize = 5;
; Minimal Quiet Zone Size in pixel
DataMatrix_MinimalQuietZoneSize = 10;
;Black Ice engine settings per lettura barcode 2D - PDF417
; Filter Size in pixel
PDF417_FilterSize = 0;
; Quiet Zone Size in pixel
PDF417_MinimalQuietZoneSize = 10;
; OCR Engine
; Seleziona il motore di acquisizione OCR da utilizzare
; Valori ammessi :
; EZOCR_ENGINE_NONE - Turns off OCR.
; EZOCR_ENGINE_TRANSYM - TOCR engine by Transym Ltd.
ocr_engine = EZOCR_ENGINE_TRANSYM
; OCR Product key
; Imposta la chiave di licenza per il motore di lettura OCR utilizzato
; Valori ammessi :
; demo - Licenza demo (lettura OCR su 45 pagine)
; chiave di licenza - Codice di registrazione ricevuto dal produttore del motore di lettura OCR
ocr_productkey = demo
Ci sono situazioni di configurazione di rete in cui il PC dove risiede il componente ZScanner è impossibilitata ad uscire "direttamente" su Internet, ma necessita passare da un Server Proxy per poter accedere alla rete. In situazioni di questo è necessario specificare una variabile di ambiente di sistema "http_proxy" con l'indirizzo http del server proxy abilitato a gestire le richieste (ad es. http_proxy=http://192.168.90.90:800).
In questo modo automaticamente le DLL che effettuano le chiamate ai nostri servizi web passano dall'indirizzo specificato in http_proxy.
Ricordiamo che I barcode generati in qualsiasi modo e da qualsiasi applicazione, devono essere riprodotti con carattere AbriBarcode 39 e i caratteri consentiti sono quelli numerici (0-n), i caratteri (dalla A alla Z, scritti in maiuscolo) e i caratteri - (trattino), $, /, % e *.
Attenzione: in presenza di database case sensitive, come ad esempio Postgres, poichè i barcode con carattere AbriBarcode 39 vengono sempre riprodotti in MAIUSCOLO è necessario che anche l'equivalente codice attributo definito all'interno della gestione sia definito in carattere MAIUSCOLO. (es. CODICECLIENTE)
La libreria supporto anche la modalità di accesso tramite protocollo Https