Interfacciamento allo scanner con itaScanner

itaScanner è una libreria che permette ad itaEngine di interfacciarsi agli scanner installati sul client tramite SmartAgent.

La libreria è formata da due elementi:

• classe itaScannerClient contiene la logica di interfacciamento allo scanner
• classe itaScanner classe statica che contiene i metodi di interfacciamento allo scanner.

In linea di massima itaScanner l'unica classe con cui ci si dovrebbe andare ad interfacciare, di seguito se ne descrivono i metodi

Permette di aprire la finestra dello scanner sul client e richiamare un model ed un evento scelto a piacere a scansione avvenuta. Il metodo prende i seguenti parametri:

• $model stringa con il nome del model da richiamare una volta avvenuta la scansione
• $event stringa dell'evento da scatenare sul model (default='scanCallback')
• $scannerDriver permette di indicare che driver usare, i valori concessi sono contenuti nelle costanti itaScanner::ITASCANNER_DRIVER_*
• $parameters array che contiene i parametri addizionali da configurare.

Al richiamo del metodo verrà aperta una schermata di interfacciamento allo scanner (differente a seconda del driver selezionato). L'utente potrà così effettuare una o più scansioni, al termine delle quali, alla pressione del tasto “chiudi” verrà scatenato l'evento impostato. Il model riceverà così una chiamata avente le seguenti informazioni:

• $_POST['event'] valore passato in $event
• $_POST['id'] valore fisso 'scan'
• $_POST['data'] path (server side) che contiene il pdf della scansione.

Permette di aprire la finestra dello scanner sul client e di gestire in maniera automatizzata il return dello stesso. Il metodo prende i seguenti parametri:

• $mode indica la modalità di gestione della risposta dello scanner, può assumere i seguenti valori:

1. itaScanner::ITASCANNER_TAB a scansione avvenuta viene aperta una nuova tab di itaEngine con l'anteprima del pdf scannerizzato
2. itaScanner::ITASCANNER_MODAL a scansione avvenuta viene aperta una modale di itaEngine con l'anteprima del pdf scannerizzato
3. itaScanner::ITASCANNER_NONE a scansione avvenuta non viene mostrato niente all'utente.

• $scannerDriver permette di indicare che driver usare, i valori concessi sono contenuti nelle costanti itaScanner::ITASCANNER_DRIVER_*
• $parameters array che contiene i parametri addizionali da configurare.
• $savePath stringa contenente il path completo di nome del file dove salvare il documento scannerizzato. Se lasciato a null non verrà salvato il documento. Il campo è obbligatorio nel caso si usi la modalità ITASCANNER_NONE
• $allowDownload booleana che indica se l'utente può scaricare o meno il documento scannerizzato. Se impostata a true verrà mostrato nella tab/modale di anteprima il documento insieme a due tasti per aprirlo con l'editor di sistema o per scaricarlo.

La libreria itaScanner è dotata di diversi parametri che possono essere trasmessi nel momento in cui si richiamano i metodi scanCallback() e scannerService(). Di seguito la descrizione:

• 'color' integer: 0=Bianco e nero, 1=colori, 2=scala di grigi
• 'quality' integer: valore da 1 a 100 che indica la qualità dell'immagine
• 'forceClose' boolean: indica se chiudere automaticamente la finestra dello scanner o meno a scansione avvenuta
• 'showUi' boolean: indica se visualizzare o meno la finestra dello scanner.

Questi parametri hanno delle configurazioni di default nella forma delle chiavi dei parametri visualizzabili sotto 'PARAMETRI PER LA GESTIONE DELLO SCANNER'3 visualizzazioni.