Presenze V Installazione:

Transcript

1 Presenze V 1.24 Il programma delle presenze estrae i movimenti di alcuni lettori a scelta dall archivio storico di AxWin in un file ASCII. Normalmente è utilizzato per agganciare ad AxWin un software di gestione presenze. Installazione: Lanciare il programma install.exe che provvederà a copiare i files necessari per l'uso del programma presenze. Se si possiede una vecchia versione di AxWin può darsi che la tabella stora.db non contenga il campo Extr che è necessario per l'uso del programma presenze. Il programma presenze non sovrascrive il vecchio stora.db con il nuovo ma mette a disposizione una copia di stora.db vuota nella directory c:\axwin\archpres. Se si incorresse in questo problema è sufficiente copiare tutti i file stora.* dalla directory c:\axwin\archpres in c:\axwin\arch. Se si deve sostituire il file e non si vuole perderne il contenuto del vecchio storico procedere come segue: 1) Da AxWin svuotare lo storico in un file. 2) Uscire da AxWin. 3) Copiare il nuovo stora.* da c:\axwin\archpres a c:\axwin\arch. 4) Lanciare AxWin 5) Recuperare i movimenti dello storico precedentemente copiati al punto 3. Funzionamento: Presenze può essere lanciato sia senza parametri, sia con parametri opzionali. Per la descrizione del funzionamento dei singoli parametri vedere di seguito. Se non si specifica nessun parametro per il nome del file di destinazione, questo si chiamerà presenze.dat. Presenze può generare due tipi di formato record: Ridotto (default) Esteso (compatibile ltrasf) Personalizzato 1

2 Record ridotto: CCCCCCCCCCGGMMAAHHNNSS<newLine> Dove: CCCCCCCCCC = Codice carta, lunghezza = 10 caratteri riempiti a sinistra con 0 Data e ora di transito (due caratteri ogni campo riempiti di 0 a sinistra): GG = giorno MM = mese AA = anno (a due cifre con gestione anno 2000) HH = ore NN = minuti SS = secondi <newline> = Carattere di new line Record esteso: LVPPKKKKCCCCCCCCCCDDDDDDHHHHHHSSSNNN<CR> Identificatore N. caratteri Descrizione L 1 0 = Transito dal lettore interno al terminale 1 = Transito dal lettore esterno V 1 0 = Transito scorrendo la tessera da destra a sinistra 1 = Transito scorrendo la tessera da sinistra a destra PP 2 Prefisso della carta (da 1 a 10) KKKK 4 Eventuale codice di identificazione personale digitato alla tastiera quando il funzionamento del lettore lo prevede, altrimenti vale CCCCCCCCCC 10 Codice della carta magnetica transitata. DDDDDD 6 Data di transito nel formato GGMMAA dove: GG = giorno (01-31) MM = mese (01-12) AA = anno (90 = = 2050). HHHHHH 6 Ora di transito nel formato HHMMSS dove: HH = ore (00-23) MM = minuti (00-59) SS = secondi (00-59) SSS 3 Causale di transito ( ) [opzionale, vedi parametro - D] NNN 3 Numero del terminale ( ) [opzionale, vedi parametro -I] <CR> 1 Carattere di new line 2

3 Record personalizzato: Quando si utilizza il parametro -X (vedi paragrafo successivo) e nella directory di lavoro di presenze.exe è presente il file "wtrasf.ini", le impostazioni del record di uscita sono personalizzate conformemente al contenuto di questo file. Aprendo il file "wtrasf.ini" si troveranno le seguenti righe che, come detto, impostano i record secondo lo schema del vecchio Ltrasf (e anche del record esteso senza personalizzazione), per motivi di compatibilità: [WTRASF V 1.00] LEGGO.DAT 0 2,1,-1 3,1,0 4,2,0 5,14,0 6,2,0 7,2,0 8,2,0 10,2,0 11,2,0 12,2,0 13,3,0 1,3,0 Dove: La prima riga è fissa ed indica la versione del formato del file La seconda riga indica percorso e nome del file di scarico. La terza riga indica la modalità si salvataggio dei dati: 0 sovrascrivi, 1 append. Dalla quarta in poi si hanno i seguenti campi: n,a,o dove: n è il numero progressivo; a è l ampiezza del campo, ossia il numero di caratteri che lo compongono; è l offset ovvero un valore da sommare a quello scaricato dal lettore. In alcuni campi un offset pari a 1 ha una funzione speciale. Di default sono tutti 0 tranne per il campo 2 dove per compatibilità con Ltrasf è necessario un 1. 3

4 In particolare si ha: N Descrizione Ampiezza 0 Non Utilizzato 1 N terminale (3) 2 Lettore interno/esterno 1 interno, 0 esterno (1) -1 comporta 0 interno e 1 esterno 3 Direzione strisciata dx-sn/sn-dx 0 dx-sn e 1 sn-dx (1) -1 inverte, 0 sn-dx e 1 dx-sn 4 Tipo tessera A seconda dei tipi usati (2) 5 Codice tessera A seconda del codice usato (14) 6 Giorno 2 caratteri gg (2) 7 Mese 2 caratteri mm (2) 8 Anno formato 2 cifre 2 caratteri aa (2) 9 Anno formato 4 cifre 4 caratteri aaaa 10 Ore 2 caratteri hh (2) 11 Minuti 2 caratteri nn (2) 12 Secondi 2 caratteri ss (2) 13 Causale unica 3 caratteri ccc (2) 14 Campo Reparto In axwin * 15 Separatore Codice ASCII del separatore (NU) * Attenzione il campo deve essere necessariamente Numerico Se si imposta una Grandezza minore del numero di caratteri del campo l impostazione non avra effetto 4

5 Parametri a linea di comando: -X = Setta il record di uscita in formato esteso, in mancanza del parametro il record di uscita viene generato ridotto. Nel caso in cui si utilizzi questo switch e, nella directory di lavoro di "presenze.exe" si trovasse il file "wtrasf.ini", il formato del record di uscita diventa personalizzato. -I = (solo nel record esteso) Inserisce il numero del terminale alla fine del record. -Dc = (solo nel record esteso) Setta il modo causale al valore del parametro c. I valori ammessi per c sono 0, 1 e 3. L'argomento 0 è non accoda la causale al record (come se si omettesse il parametro -D), il valore 1 accoda al record la causale su 3 caratteri mentre l'argomento 3 accoda la causale su 9 caratteri. -S = Esegue e chiude automaticamente il programma di scarico. -Fnomefile = Esegue lo scarico nel file di nome nomefile e non nel file di default presenze.dat. Se si utilizza il file "wtrasf.ini", il nome del file di destinazione viene specificato nel file e non in questo parametro. Quando il programma viene eseguito automaticamente, avviene l estrazione dei movimenti dallo storico di AxWin che non sono mai stati estratti. 5

6 Funzionamento da interfaccia utente: Lanciando presenze senza il parametro S si avvia l interfaccia utente. Seleziona i lettori e i tipi di utente da scaricare. Estrai i movimenti mai estratti dall archivio storico di AxWin. Estrai nuovamente dell archivio storico di AxWin i movimenti compresi tra due date. Esci dal programma. Scegliendo il menù Configura o il primo pulsante della barra, compare la seguente finestra: Pulsante per spostare un lettore selezionato dalla finestra sinistra a quella di destra. Pulsante per spostare un lettore selezionato dalla finestra destra quella di sinistra. Lista dei lettori del sistema. Fintanto che stanno in questa finestra non sono selezionati per l estrazione dei movimenti. Lettori del sistema da cui si devono estrarre i movimenti delle presenze. 6

7 Una volta selezionati i terminali dai quali si estraggono i movimenti delle presenze, si deve premere OK e comparirà la seguente finestra: Questa finestra ha le stesse funzioni alla precedente solo che interessa i tipi di utenti invece che i terminali. Tutti i movimenti dell'archivio storico degli utenti appartenenti ai tipi di utenti selezionati nella lista sinistra saranno estratti nel file ASCII di destinazione. Gli utenti appartenenti invece ai tipi di utenti che rimangono nella lista destra non saranno estratti. 7

8 Selezionando l estrazione di tutti i movimenti non estratti, compare la seguente finestra: Rispondendo YES si avvia l operazione di estrazione dei movimenti MAI ESTRATTI nel file presenze.dat. Selezionando invece l estrazione dei movimenti nel periodo da data a data comparirà la seguente finestra: Indicando due date, si avrà l estrazione dei movimenti delle presenze compresi tra le date indicate (esse incluse) anche se già estratti in precedenza. 8