Inventario v1.0 Frequently Asked Questions

Transcript

1 Inventario v1.0 Frequently Asked Questions (Revisione del 17/05/2013) ITMonster S.r.L Via G.B. Pergolesi, Milano (MI) Tel: 02/ Fax: 02/

2 Indice 1 Introduzione Lettura di barcode tramite fotocamera La fotocamera non funziona La fotocamera legge il barcode in maniera errata La fotocamera è molto lenta/non riesce a leggere il barcode Lettura di barcode tramite dispositivo Bluetooth Come utilizzare un dispositivo Bluetooth Il dispositivo non funziona correttamente Il dispositivo ha smesso di funzionare correttamente Non compare più la tastiera Android nell applicazione Operazioni con file Dove trovare la cartella per l importazione/esportazione dei file Percorsi file Formato file Cosa si intende con Incorpora file Varie Suoni Immagini Altro... 10

3 1 Introduzione Questa guida nasce con lo scopo di indicare all utente come risolvere le problematiche più comuni dell applicazione Inventario. Possiamo dividerle in tre categorie: Problemi di lettura con fotocamera Configurazione di un lettore Bluetooth da utilizzare con l applicazione L utilizzo di file per importazione ed esportazione dell anagrafica articoli 2 Lettura di barcode tramite fotocamera 2.1 La fotocamera non funziona L applicazione utilizza la fotocamera del sistema, verificare quindi il corretto funzionamento della stessa (Es. Obiettivo della fotocamera non sia coperto da eventuali custodie) 2.2 La fotocamera legge il barcode in maniera errata ATTENZIONE! Per motivi che non dipendono dall app, potrebbe succedere che il codice a barre letto non corrisponda a quello reale. In questo caso l applicazione non si accorgerà del problema, quindi procederà come se nulla fosse accaduto. Per non incappare in questo errore verificare prima della scansione che: La linea rossa della fotocamera sia perpendicolare alle righe parallele del barcode La linea rossa della fotocamera non sia posizionata sopra altri barcode La fotocamera abbia inquadrato interamente il barcode Il barcode sia stampato correttamente e sia leggibile (Eseguire dei test con un altro dispositivo) Dopo che la scansione è stata effettuata si consiglia all utente di controllare che i dati dell articolo siano relativi al codice a barre letto e, nel caso in cui non venga trovato nell anagrafica, che non sia stato mal interpretato dalla fotocamera.

4 2.3 La fotocamera è molto lenta/non riesce a leggere il barcode Le tempistiche con cui avvengono le acquisizioni dipendono dalla velocità con cui la fotocamera mette a fuoco il barcode, tramite l autofocus. Si suggerisce di: Attivare/disattivare il flash, se presente, per garantire al dispositivo una migliore scansione del codice Premere il tasto contrassegnato dalle righe parallele nella schermata con la fotocamera (Letture-> Lettura fotocamera) e spuntare l impostazione relativa Se possibile, spostare il barcode o il dispositivo in una zona più luminosa/meno luminosa in modo da evitare eventuali riflessi o problemi di luce A volte la fotocamera si sofferma tentando di mettere a fuoco il codice a barre senza riuscirci. In questo caso mantenere il dispositivo il più fermo possibile, così da consentire una migliore messa a fuoco. Nel caso in cui il barcode non venga riconosciuto si può provare a : Spostare leggermente il dispositivo/barcode per riprovare l operazione di messa a fuoco Rimuovere completamente il barcode dal riquadro e riprovare Chiudere e riaprire la finestra con la fotocamera Se, anche con questi accorgimenti non si riuscisse a leggere il codice a barre, il problema potrebbe essere il barcode stesso; testare con un altro lettore che il codice a barre sia stampato correttamente e sia leggibile. Si tenga presente che è possibile inserire/modificare la quantità di un articolo manualmente utilizzando la finestra anagrafica articoli, cliccando sull articolo e premendo sui pulsanti + e - per aumentarne o diminuirne la giacenza. 3 Lettura di barcode tramite dispositivo Bluetooth 3.1 Come utilizzare un dispositivo Bluetooth Android supporta l utilizzo di scanner Bluetooth per la lettura dei barcode. Ogni dispositivo deve eseguire una breve procedura di accoppiamento prima di poter essere utilizzato. L accoppiamento consiste nell eseguire le seguenti operazioni: 1. scansione di un barcode con il dispositivo, per renderlo visibile al telefono/tablet 2. stabilire una connessione dal tablet/telefono selezionando l applicazione dal menu Bluetooth 3. scansionare un codice pin per completare l accoppiamento Una volta terminata la suddetta procedura si può effettuare un semplice test: aprire l Inventario, selezionare la scheda Impostazioni e modificare da OFF ad ON la voce utilizza dispositivo esterno. Premere poi sul pulsante verifica per controllare che i codici a barre letti compaiano sul display.

5 La procedura di accoppiamento varia da lettore a lettore ed è indicata sul sito del produttore del dispositivo. La nostra applicazione non modifica/gestisce l accoppiamento dei dispositivi, ma ne riceve semplicemente l input. 3.2 Il dispositivo non funziona correttamente Verificare se è un problema totale o parziale, ovvero se non funziona: 1. Sia all interno di un programma che accetta input da periferiche che nell Inventario 2. Solo nell inventario Nel primo caso vi invitiamo a controllare che: La batteria del dispositivo sia carica Il Bluetooth sia attivo La procedura di accoppiamento sia andata a buon fine (viene indicato come dispositivo associato) I dispositivi siano connessi fra loro Se le condizioni sopra indicate sono tutte verificate, provare a eseguire le seguenti operazioni: Chiudere e riaprire l applicazione. Selezionare la scheda Impostazioni, attivare la voce utilizza dispositivo esterno e premere verifica. Controllare che, dopo aver effettuato la lettura di un barcode, il codice letto compaia sullo schermo. Provare a disconnettere e riconnettere il dispositivo Bluetooth Provare a spegnere e riaccendere il dispositivo Bluetooth Rieseguire la procedura di accoppiamento Se non dovesse funzionare, provare a rieseguire la procedura indicata dal produttore del dispositivo dopo aver spento e riacceso il vostro telefono/tablet e averlo rimosso come dispositivo associato. Se il problema si verifica solo con la nostra app significa che il lettore è connesso correttamente col dispositivo e che dovrebbe essere sufficiente chiudere e riaprire l applicazione.

6 3.3 Il dispositivo ha smesso di funzionare correttamente Questa situazione si verifica solo dopo alcuni eventi, ad esempio se: La batteria del dispositivo si è scaricata Il Bluetooth o la connessione col dispositivo non è più attiva Interferenze o allontanamento eccessivo fra le due periferiche L applicazione è chiusa L applicazione non è in primo piano (Es. Menu a tendina di Android che mostra lo stato della batteria e della connessione) Se nessuno di questi eventi è avvenuto provare una delle modalità di risoluzione indicate nel punto Non compare più la tastiera Android nell applicazione Nel momento in cui andiamo a collegare un lettore Bluetooth, esso viene considerato come strumento di input ; quindi non comparirà più la tastiera. E necessario disattivare l opzione tastiera fisica per poter compilare le caselle di testo. ATTENZIONE! Questa impostazione è configurabile solo se il telefono/tablet è collegato ad un dispositivo di input. La procedura di disattivazione è semplice: selezionare una casella di testo presente nel programma (ad esempio quella che consente di inserire il testo per ricercare un articolo) e utilizzare il menu che compare sulla barra di Android. L icona raffigura una tastiera e consente di modificare l opzione attiva tastiera fisica da si a no. Dopo questa modifica l applicazione verrà riavviata. Conviene quindi effettuarla prima di partire con l operazione di inventario vero e proprio. 4 Operazioni con file 4.1 Dove trovare la cartella per l importazione/esportazione dei file La cartella viene creata nel telefono/tablet all interno della directory /mnt/sdcard e viene utilizzata per l importazione/esportazione dei file ed il caricamento di eventuali immagini per gli articoli.

7 Il nome di default è com.itmonster.inventario e viene creata ad ogni avvio dell applicazione; nel caso di un eventuale spostamento o modifica è necessario copiare i file nella nuova cartella per poterli utilizzare. ATTENZIONE! I file generati dall applicazione in fase di esportazione possono essere utilizzati in fase di caricamento, ma le giacenze degli articoli non saranno azzerate. 4.2 Percorsi file E possibile creare altre sottocartelle all interno di com.itmonster.inventario da utilizzare a proprio piacimento. Per comodità l applicazione è strutturata in modo da avere le immagini in una sottocartella e i file di transizione nella directory corrente. Nel caso fosse necessario usare sottocartelle per i file, ecco come indicare i percorsi: Caricamento da file : nome cartella/nomefile Esportazione file : l esportazione avviene solo nella cartella principale, si potrà procedere allo spostamento dei file manualmente Immagini: l idea di base è quella di mantenere file e le immagini separate, quindi l applicazione richiede il nome di una sottocartella o Per utilizzare la directory principale basta modificare il nome cartella cancellando tutti i caratteri nel campo nome cartella o Per utilizzare una sotto cartella, discendendo di un altro livello, utilizzare come percorso nome cartella uno/nome cartella finale E quindi possibile creare cartelle interne alla directory dell applicazione per salvare una copia della propria anagrafica. 4.3 Formato file I file generati possono essere in formato csv o txt; per quanto riguarda il csv il separatore utilizzato è il ; mentre per il txt è il carattere \t ovvero il carattere di tabulazione. Le informazioni devono essere contenute fra doppi apici, e fra un informazione e l altra deve essere presente il separatore. Ad ogni riga del file corrisponde un singolo articolo, escluse le prime tre che indicano invece la denominazione della colonna, la tipologia di dato che devono contenere e se è un informazione obbligatoria. (Vedere l esempio alla pagina successiva)

8 ATTENZIONE! L ultimo carattere del file deve essere un carattere di fine linea, altrimenti l ultimo articolo del file non sarà aggiunto all anagrafica. I campi obbligatori del file sono : "CODICE_ARTICOLO";"DESCRIZIONE";"GIACENZA";"BARCODE "String";"String";"Integer";"String" "Not Null";"Not Null";"Not Null";"Not Null E possibile: invertire l ordine delle colonne, prestando attenzione a non modificare i tipi di dato dei campi base e la loro obbligatorietà Aggiungere nuove colonne seguendo lo stesso standard o Prima riga: non possono essere presenti due colonne con lo stesso nome o simboli non consentiti o Seconda riga: I tipi di dato possibili sono i seguenti: Integer(numeri interi) Boolean(Si o no) Double(numeri con virgola) Char(singolo carattere) String(testo) o Terza riga: indica se i campi possono essere vuoti. I valori consentiti sono Null e Not Null Segue un esempio di file di testo con dati personalizzati: "CODICE_ARTICOLO";"DESCRIZIONE";"GIACENZA";"BARCODE";"DATA_ARRIVO";"PROMOZIONE" "String";"String";"Integer";"String";"String";"Boolean" "Not Null";"Not Null";"Not Null";"Not Null";"Null";"Not Null" "12HP";"EVIDENZIATORE ARANCIONE";"5";"34145";"05/04/2013";"Si" "G2Z3";"MATITA 2H";"4";"96011";"";"No" "FF3R";"PENNA ROSSA";"0";"30748";"04/05/2013";"Si" "Z4GH";"PENNA BLU";"9";"93771";"05/04/2013";"No" "W5W3";"MATITA 2B";"1";"98595";"09/04/2013";"No"

9 "6LK2";"EVIDENZIATORE GIALLO";"2";"98905";"08/03/2013";"No" "7ZL0";"PACCO 100 FOGLI RACCOGLITORE RIGHE";"5";"31891";"";"Si" Se non si è sicuri di aver composto bene il file è possibile ricreare la vostra struttura all interno dell applicazione, inserire un articolo di prova ed esportarlo così da avere un file di riferimento. 4.4 Cosa si intende con Incorpora file L idea di base è quella di poter suddividere il magazzino in diverse zone e procedere in parallelo con la stessa applicazione su dispositivi diversi. Al termine della conta dei prodotti in ciascuna zona, sarà possibile unire le letture fatte da ciascun dispositivo, sommando le quantità corrispondenti. La funzione Incorpora file consente appunto di integrare ai dati del proprio dispositivo quelli provenienti da altri file generati (tramite esportazione) dall applicazione Inventario. Unendo le informazioni si otterrà l insieme delle giacenze dell intero magazzino. 5 Varie 5.1 Suoni L applicazione utilizza dei suoni per indicare all utente il risultato dell operazione di lettura. Gli effetti sonori che si possono sentire sono: Lettura di un barcode con un articolo già presente in anagrafica Lettura di un barcode non presente in anagrafica (E lo stesso suono che viene utilizzato per il test audio) L audio si può abilitare/disabilitare direttamente dal menu delle impostazioni. E possibile, sempre dal suddetto menu, effettuare un test audio per verificarne il corretto funzionamento. Il volume degli effetti audio dell applicazione è lo stesso del dispositivo; verificare quindi che sia settato correttamente. Esiste poi un terzo suono che viene utilizzato solo nella modalità con fotocamera e viene riprodotto anche se nel menu impostazioni il suono è disabilitato. Questo effetto sonoro è un campanello di emergenza per evitare scansioni duplicate dello stesso articolo.

10 Anche questo suono mantiene il volume dell audio del sistema e può essere disabilitato, ma in maniera differente rispetto ai precedenti: aprire la schermata di lettura con fotocamera, premere il tasto Android contrassegnato da righe parallele e selezionare la voce impostazioni e poi suono. Questa scelta è stata fatta appunto per evitare letture duplicate. 5.2 Immagini L utente può decidere di associare una immagine ad ogni articolo che verrà visualizzato nella scheda del prodotto e, se ne è sprovvisto, assegnare una figura di default. Tutte le immagini devono essere nello stesso formato ( jpg, jpeg o png) e la denominazione della figura deve essere uguale al codice dell articolo. Le immagini si possono inserire nella cartella com.itmonster.inventario ; se l utente decide di non utilizzare le immagini viene mostrato un riquadro vuoto. 5.3 Altro Si ricorda che: L applicazione utilizza la data del dispositivo per creare il log delle ultime modifiche alle giacenze. Se la data viene cambiata o vi è un cambio dell ora le scansioni precedenti al cambio non verranno aggiornate e il log potrebbe non essere ordinato correttamente. Se dal menu impostazioni di Android si decide di cancellare tutti i dati dell applicazione, le anagrafiche con relative giacenze e le impostazioni andranno perse. Nella versione Tablet dell applicazione è possibile selezionare il numero di prodotti per pagina e quali informazioni mostrare. La visualizzazione potrebbe risultare lenta o veloce a seconda delle scelte effettuate.