Manuale EacqCE_Daemon Versione manuale 2.0.0 Copyright 2011 MMS Srl Manuale EacqCE_Daemon Pagina 1
Sommario Informazioni generali... 3 Introduzione... 3 Installazione del programma... 4 Avvio del programma... 5 Configurazione iniziale del programma... 6 Configurazione dell importazione... 6 Configurazione dell esportazione... 7 Configurazione della richiesta password... 9 Importazione dei dati... 9 Esportazione dei dati... 10 Ottimizzazione dei dati... 11 Altre informazioni... 11 Definizione dei tracciati delle anagrafiche articoli... 13 Manuale EacqCE_Daemon Pagina 2
Informazioni generali Introduzione EacqCE_Daemon (Enhanced Code Quantity Daemon) è un software che si occupa di gestire l invio e la ricezione di dati con palmari su cui è installato EacqCE. I dati ricevuti dai palmari potranno essere esportati in file di testo o in formato XML. Manuale EacqCE_Daemon Pagina 3
Installazione del programma Il software EacqCE_Daemon può essere installato su di un PC dotato di uno dei seguenti sistemi operativi: - Windows XP 32 Bit - Windows Vista 32 bit - Windows Vista 64 bit - Windows 7 32 bit - Windows 7 64 bit Requisito fondamentale per il funzionamento del software è aver installato precedentemente.net Framework 3.5 Per installare il programma è necessario attenersi alla procedura di seguito descritta: 1) Eseguire il file EACQCE_Daemon_setup.exe. 2) Una volta avviato il programma seguire le istruzioni che compaiono a video. Manuale EacqCE_Daemon Pagina 4
Avvio del programma Una volta installato, il programma potrà essere avviato tramite l icona sul desktop o tramite il menù Start Programmi MMS Srl come mostrato nell immagine sottostante: Oppure come mostrato nell immagine seguente se utilizzate Windows 7: Manuale EacqCE_Daemon Pagina 5
Configurazione iniziale del programma Avviato il programma sarà necessario eseguirne la configurazione per una corretta esecuzione. Configurazione dell importazione Dal menù Impostazioni selezionare la voce Importazione. Si aprirà una finestra nella quale è necessario indicare dove prelevare le anagrafiche articoli. Cliccando sul pulsante si potranno esplorare le cartelle del PC per indicare il file scelto. Da questa schermata è anche possibile impostare quale separatore di campo viene utilizzato nelle anagrafiche. Tale separatore sarà utilizzato anche in fase di esportazione dei dati. Manuale EacqCE_Daemon Pagina 6
Configurazione dell esportazione Dal menù Impostazioni selezionare la voce Esportazione. Si aprirà una finestra dalla quale si potrà scegliere come esportare i dati che vengono spediti dai palmari. N.B.: I dati vengono esportati in un unica soluzione, quindi se all interno del database di EacqCE_Daemon sono presenti i documenti inviati da diversi terminali questi verranno esportati, secondo le modalità scelte, in un unica azione. In questa finestra è possibile scegliere: - Tipologia di esportazione, ovvero nel formato TXT (semplice testo) o nel formato XML (che utilizza dei marcatori). - Nome del file esportato. - Cartella dove esportare i dati (è possibile utilizzare anche una cartella di rete a patto di possederne i diritti di lettura e scrittura). Manuale EacqCE_Daemon Pagina 7
- Tramite la spunta delle checkbox I valori che si desidera esportare. In particolare è possibile decidere se esportare o meno i valori di: o Codice articolo o Esistenze o Descrizione articolo o Unità di misura o Prezzo o Nome del palmare con cui sono stati inviati i dati o Quantità Nel caso si decida di esportare i file in formato TXT sono disponibili altre opzioni: - Esportare tutti i documenti in un unico file di testo. - Esportare i documenti in file di testo diversi a seconda del palmare. - Esportare i file in modalità Overwrite (sovrascrittura dei file precedenti con lo stesso nome), Append (continuare a scrive all interno di un file con lo stesso nome) e Progressive (utilizzando un numero progressivo che viene posto alla fine del nome del file di testo in modo da differenziare ogni file). Il separatore utilizzato tra i campi dati nei file di testo è lo stesso separatore impostato nella finestra Impostazioni Importazione Altre opzioni disponibili durante l esportazione riguardano la possibilità di: - Eseguire una copia di backup dell esportazione precedente. - Visualizzare automaticamente o meno i dati dopo l esportazione. - Esportare automaticamente i dati appena questi sono inviati da un dispositivo; In questo verranno esportati sia dati in formato TXT che XML singolarmente per ogni terminale. Manuale EacqCE_Daemon Pagina 8
Configurazione della richiesta password Dal menù Impostazioni selezionare la voce Password. Si aprirà una finestra dalla quale si potrà scegliere una password e per quale operazione sarà richiesta. N.B.: È presente una password di sistema, non modificabile, in caso di perdita della password scelta dall utente ( fibonacci ). Importazione dei dati Una volta avviato EacqCE_Daemon cliccare sul pulsante Importa dati. Prestare attenzione ai messaggi che compaiono a video, utili ad identificare eventuali errori di importazione. E possibile altresì importare un file tramite un operazione di Drag & Drop del file stesso all interno del programma. Una volta importato il file con questa modalità, il percorso di importazione del file presente in Impostazioni Importazione diventerà quello del file appena trascinato. Manuale EacqCE_Daemon Pagina 9
Esportazione dei dati I dati che vengono inviati dai terminali vengono memorizzati automaticamente dal programma all interno del proprio database. Per esportarli in formato TXT o XML selezionare la voce Esporta in XML o Esporta in TXT (a seconda della configurazione adottata) dal menù dati. Qui di seguito viene proposto un esempio di esportazione dati in formato XML: <?xml version="1.0" encoding="utf-8"?> <documento> <terminale> <nome_palmare>1504103371</nome_palmare> <letture> <barcode>54322</barcode> <qta>1</qta> <codice>12346</codice> <esistenze>0</esistenze> <descrizione /> <unita_di_misura /> <prezzo>0</prezzo> </letture> <letture> <barcode>54327</barcode> <qta>1</qta> <codice>12351</codice> <esistenze>11</esistenze> <descrizione>articolo_6</descrizione> <unita_di_misura>pz</unita_di_misura> <prezzo>18</prezzo> </letture> <letture> <barcode>54328</barcode> <qta>1</qta> <codice>12353</codice> <esistenze>11</esistenze> <descrizione>articolo_53</descrizione> <unita_di_misura>pz</unita_di_misura> <prezzo>20</prezzo> </letture> </terminale> </documento> Se invece l utente decide di esportare i dati in formato TXT il programma creerà un semplice file di testo in cui ogni riga corrisponde all articolo e ogni sotto stringa distinta dal separatore (in questo caso pipe) corrisponde al campo. Il seguente esempio riguarda un esportazione di dati in formato TXT costituita nel seguente modo: [codice a barre] [quantità] [codice articolo] [esistenze] [descrizione] [unità di misura] [prezzo] 54327 1 12351 11 articolo_6 pz 18 54328 1 12351 11 articolo_6 pz 18 Manuale EacqCE_Daemon Pagina 10
Ottimizzazione dei dati Dal menù File è possibile, selezionando la voce Elimina dati obsoleti, eliminare le vecchie copie di backup non più utili in modo da operare un ottimizzazione dello spazio occupato dal programma. Altre informazioni Dal menù Aiuto è possibile selezionare la voce Visualizza log. Si aprirà in questo modo una finestra con l archivio dei messaggi che il programma ha visualizzato a video. Questi messaggi vengono memorizzati all interno di un apposito file che viene eliminato automaticamente al raggiungimento delle dimensioni di circa un mega. Manuale EacqCE_Daemon Pagina 11
Dallo stesso menù selezionando invece la voce About comparirà la seguente finestra: Oltre a visualizzare il nome del programma e la versione da voi utilizzata è anche indicato dove sono memorizzati i database, i file di log e di configurazione e la versione del protocollo di trasmissione dati. Manuale EacqCE_Daemon Pagina 12
Definizione dei tracciati delle anagrafiche articoli Per un corretto funzionamento del programma, il file delle anagrafiche articoli deve rispondere alle seguenti caratteristiche: - Tutte le anagrafiche devono essere contenute all interno di un file di testo con estensione.txt. - Il tracciato è composto da vari campi separati dal carattere separatore configurabile dalla sezione Impostazione -- > Importazione. Di default il separatore è (pipe). - I campi sono a lunghezza variabile, eventuali spazi bianchi non vengono rimossi. - Il tracciato è composto dai seguenti campi: [codice articolo] [codice a barre] [esistenze] [descrizione] [unità di misura] [prezzo] - Non è necessario inserire tutti i campi. - Se non sono disponibili i campi alla fine della riga basta ometterli. - Se il valore di un campo in posizione n non è disponibile, ma è invece disponibile il valore del campo seguente ( n+1 ), il campo n deve essere comunque inserito assieme ai separatori di campo. - I valori dei campi esistenze e prezzo devono essere dei numeri con separatore decimale uguale al. (punto) o al separatore decimale impostato nel sistema operativo; il valore espresso deve essere formato da un numero massimo di 15 cifre significative (separatore, zeri iniziali e finali esclusi). - Tutti questi tracciati devono essere contenuti all interno di un unico file TXT. - La ricerca degli articoli (da parte del programma EacqCE) avviene sulla base del codice a barre e del codice articolo. - Ad un articolo possono essere assegnati più codici a barre diversi (nell esempio l articolo 12351). - Nel caso lo stesso codice a barre sia stato associato a più articoli diversi, verrà restituito (da parte del programma EacqCE) l ultimo articolo presente nell anagrafica (nelle esempio l articolo 12353). Per maggior chiarezza si fornisce un esempio di tracciato dati compatibile con EacqCE_Daemon: 12345 12346 54322 12347 54323 5 12348 7 articolo_4 12349 54325 9 articolo_5 nr 12350 54326 11 articolo_6 pz 17,12 12351 54327 articolo_6 pz 18,00 12351 54328 11 articolo_6 pz 18,00 12352 54329 11 articolo_52 pz 19,00 12353 54329 11 articolo_53 pz -01234.567890123450 Manuale EacqCE_Daemon Pagina 13