PROCEDURA progetto pyou card e abbonamento musei MANUALE OPERATORE Vers. 2.0 del 12/05/2015
VERSIONI Versione Data Autore Modifiche Apportate 0.1 25/10/2012 Fabio Bachetti Prima stesura 0.2 13/11/2012 Fabio Bachetti Aggiornamento flusso e immagini schermate 0.3 04/12/2012 Fabio Bachetti Aggiornato flusso di lettura delle smartcard Mifare UL 1.0 04/12/2013 Annarita Pepe Modifiche per campagna abbonamenti 2014 2.0 12/05/2015 Fabio Bachetti Modifiche per estensione progetto alla Lombardia SOMMARIO 1 NOMENCLATURA E ABBREVIAZIONI... 3 2 INTRODUZIONE E OBIETTIVI... 4 3 CARATTERISTICHE DEL DISITIVO... 4 3.1 Alimentazione elettrica e batteria... 4 3.2 Programma... 5 3.3 Tastiera... 5 4 FUNZIONAMENTO DEL DISITIVO... 6 4.1 Comunicazione con il CdC... 6 4.2 Accensione e avvio della sessione... 6 4.3 Lettura delle smartcard... 10 4.3.1 Smartcard Abbonamento Musei e Carte Turismo Torino... 11 4.3.2 Smartcard Pyou ed Edisu... 12 4.3.3 Errori e/o Messaggi Vari... 14 4.4 Menu Principale... 16 4.5 Annullamento della registrazione di un ingresso... 16 4.6 Chiusura del turno e comunicazione con il CdC... 17 ManualeOperatore_v2.0.docx Pag. 2 di 19
1 NOMENCLATURA E ABBREVIAZIONI In questo paragrafo sono riportate tutte le abbreviazioni, le sigle e gli acronimi, utilizzati all interno del documento, con la loro descrizione e significato: TERMINE AMPT Card AMLM Card ATCCE BL CdC CDM DB GPRS PYC RDP RFID SAM S/N Smartcard RF SIGNIFICATO Abbonamento Musei Piemonte e Torino Card: smartcard con titolo d accesso, emessa da Associazione Torino Città Capitale Europea, che abilita il possessore dell omonima carta ad accedere ai musei convenzionati in Piemonte. Il titolare di questa smartcard potrà accedere anche ai musei convenzionati in Lombardia, previo acquisto di un integrazione del proprio titolo d accesso o di un titolo integrato Piemonte+Lombardia. Abbonamento Musei Lombardia e Milano Card: smartcard con titolo d accesso, emessa da Associazione Torino Città Capitale Europea, che abilita il possessore dell omonima carta ad accedere ai musei convenzionati in Lombardia. Il titolare di questa smartcard potrà accedere anche ai musei convenzionati in Piemonte, previo acquisto di un integrazione del proprio titolo d accesso o di un titolo integrato Piemonte+Lombardia. Associazione Torino Città Capitale Europea. Black List: lista inviata ai dispositivi in campo, che contiene l elenco delle carte che, pur essendo correttamente codificate, non possono essere utilizzate. Nella BL rientrano ad esempio tutte le carte smarrite (di cui il possessore ne abbia comunicata la perdita), tutte quelle duplicate e tutte le bloccate. Centro di Controllo: piattaforma software per la gestione del sistema multiazienda. Card Data Model: mascheratura della smartcard, che descrive il significato e l uso di ogni blocco di memoria della carta stessa. DataBase: base dati contenente tutte le anagrafiche e le transazioni effettuate nella piattaforma. General Packet Radio Service: è il primo sistema cellulare progettato specificatamente per realizzare un trasferimento dati a commutazione di pacchetto e a media velocità su rete cellulare. Viene convenzionalmente definita di generazione 2.5, vale a dire una via di mezzo fra la seconda (GSM) e la terza generazione (UMTS). Pyou Card: smartcard di tipo Calypso, destinata ai giovani dai 15 ai 26 anni, compatibile con il progetto BIP (Biglietto Integrato Piemonte). Remote Desktop Protocol: protocollo, sviluppato da Microsoft, che permette la connessione remota a un computer da un altro computer, in maniera grafica, tramite i Microsoft Terminal Services. Radio Frequency IDentification: tecnologia per l'identificazione e/o memorizzazione di dati automatica AIDC (Automatic Identifying and Data Capture), basata sulla memorizzazione di queste informazioni su particolari dispositivi elettronici (detti tag o transponder) e sulla capacità di questi di rispondere all'interrogazione a distanza (contactless) da parte di appositi apparati fissi o portatili (lettori/scrittori) a radiofrequenza, comunicando e aggiornando le informazioni contenute nei tag. Secure Access Module: un modulo SAM è costituito fisicamente da una smartcard (delle dimensioni di una SIM Telefonica), che custodisce una chiave crittografica, che si occupa di firmare e criptare i dati in fase di scrittura/lettura delle smartcard, garantendone la sicurezza. Nel progetto in questione non sono utilizzati moduli SAM. Serial Number: numero univoco che identifica una smartcard nel sistema multiazienda. La smartcard a Radio Frequenza è un particolare transponder, cioè un dispositivo hardware delle dimensioni di una carta di credito, che possiede potenzialità di ManualeOperatore_v2.0.docx Pag. 3 di 19
TTP T+PC T+PCJ WL elaborazione e memorizzazione dati ad alta sicurezza. La smartcard è costituita da un supporto di plastica nel quale è incastonato un microchip connesso a un'antenna. Il microchip fornisce funzionalità di calcolo e memorizzazione dati; l'antenna consente al microchip di dialogare con il terminale di lettura/scrittura (coupler), collegato ad un computer mediante porta USB. Turismo Torino e Provincia. Torino + Piemonte Card: smartcard con titolo d ingresso, emessa da Turismo Torino e Provincia, che abilita il possessore dell omonima carta ad accedere ai musei convenzionati. Torino + Piemonte Card Junior: smartcard con titolo d ingresso, emessa da Turismo Torino e Provincia, analoga alla T+PCJ ma dedicata ai minori di 18 anni. White List: contiene l elenco delle carte che, pur non avendo codificato al loro interno un contratto valido, hanno però il diritto di accedere al sistema, perché il possessore ha acquistato il titolo e non è ancora stato possibile codificarlo in tessera. Un caso tipico è rappresentato dall utente che ha rinnovato il proprio abbonamento online: l utente possiede quindi un titolo di accesso valido, ma questo non è stato codificato nella smartcard. Le postazioni PC di registrazione dell ingresso provvedono alla codifica dei titoli presenti in WL, quando la smartcard viene intercettata. 2 INTRODUZIONE E OBIETTIVI Questo manuale è destinato agli Operatori che utilizzeranno i Ingenico per la Registrazione degli Ingressi nei Musei e descrive il funzionamento dell applicativo installato nel terminale. I lavorano off-line e comunicano periodicamente con il Centro di Controllo (CdC), via GPRS, per verificare/scaricare aggiornamenti di versione, aggiornare in locale i dati delle smartcard attive e riallineare sul sever i dati degli ingressi registrati. 3 CARATTERISTICHE DEL DISITIVO 3.1 Alimentazione elettrica e batteria Il è dotato di una batteria ricaricabile e quindi può operare in qualsiasi punto, senza necessità di essere collegato all alimentazione elettrica. Sarà cura degli operatori rimettere il terminale sulla propria culla al termine del turno di lavoro, in modo che la batteria possa ricaricarsi. Non sono necessarie particolari attenzioni riguardo al posizionamento della culla; deve solamente trovarsi in prossimità di una presa di alimentazione elettrica. ManualeOperatore_v2.0.docx Pag. 4 di 19
3.2 Programma Il terminale mantiene sempre l applicativo in esecuzione e quindi non esiste una procedura di spegnimento completo e chiusura dell applicativo. Il terminale ritorna quindi sempre alla schermata di figura 3.1, che è la schermata iniziale e/o di stand-by: Figura 3.1 Schermata di stand-by del. Se il terminale viene lasciato nella sua culla collegata all alimentazione elettrica, non si spegne neppure il display; al contrario, quando il terminale non è in carica, dopo alcuni secondi il display si spegne, ma il programma rimane comunque in esecuzione. Per riattivare la retroilluminazione del display è sufficiente premere un tasto qualunque. 3.3 Tastiera Come illustrato in figura 3.2 il terminale è dotato di una tastiera numerica, di alcuni tasti funzione e di un joystick, che consentono di utilizzare il programma, scegliere opzioni e navigare all interno dei menu. Figura 3.2 Dettaglio della tastiera, dei tasti funzione e del joystick. Questo il significato e il funzionamento dei tasti principali: Tasti funzione (pulsanti neri sotto il display): la loro funzione è descritta nel display. Nel caso della schermata di figura 3.2, partendo da sinistra a destra, hanno questi significati: F1, F2, F3 e F4. Joystick: consente di scorrere i menù a video e di selezionare l opzione scelta, premendo il pulsante nero centrale. Tasto Rosso (X): è equivalente al tasto ESC di un PC; significa NO nelle varie opzioni di scelta. Tasto Giallo (<): consente di cancellare i caratteri digitati. Tasto Verde (O): è equivalente al tasto ENTER di un PC; significa SI nelle varie opzioni di scelta. ManualeOperatore_v2.0.docx Pag. 5 di 19
4 FUNZIONAMENTO DEL DISITIVO In questo paragrafo è descritto il flusso operativo del terminale e le varie fasi di funzionamento, che possiamo brevemente riassumere in questo modo: All avvio della sessione di lavoro, subito dopo il login dell operatore, il terminale stabilirà una connessione GPRS con server di gestione dell aggiornamento del programma di bordo per verificare se la versione installata è la più recente o ne è stata pubblicata una più recente: in caso affermativo, il scaricherà in locale il programma aggiornato; in caso negativo non scaricherà nulla. Il terminale si resetterà e riavvierà 1 e chiederà di nuovo all operatore di loggarsi. Di nuovo, dopo il login dell operatore, il stabilirà una connessione GPRS con il CdC per importare i flussi dati aggiornati (generati e pubblicati dal CdC). Il terminale cercherà comunque di inviare al CdC eventuali dati non ancora pubblicati. Verrà quindi riallineato l orologio interno del dispositivo con quello del CdC. Il terminale mostrerà la schermata di lavoro (per la registrazione degli ingressi). Alla chiusura del turno, sarà stampato un riepilogo delle registrazioni effettuate nell ultima sessione di lavoro e sarà stabilita una nuova connessione GPRS con il CdC, per trasmettere i dati delle registrazioni. 4.1 Comunicazione con il CdC Lo scambio dati con il CdC è molto importante, perché in questa fase il terminale, oltre ad inviare i dati delle registrazioni effettuate, si aggiorna con le informazioni pubblicate dal CdC. Il riallineamento iniziale (all apertura del turno) potrebbe richiedere alcuni minuti (nel caso ad esempio siano presenti aggiornamenti corposi da scaricare) e quindi si consiglia questa procedura operativa: Avviare il terminale (inserendo le credenziali dell operatore) subito all apertura del turno di lavoro; Far eseguire tutta la procedura di aggiornamento del e arrivare alla maschera di registrazione degli ingressi; A fine turno di lavoro, chiudere il turno sul dispositivo (anche se non è stata eseguita alcuna registrazione) e attendere il completamento delle operazioni. 4.2 Accensione e avvio della sessione La procedura operativa è quindi la seguente: Avviare il, premendo il pulsante VERDE; una volta alimentato, dopo la procedura di startup (SO), il presenta la schermata di figura 3.1 con il messaggio Premere F1 per avviare l applicazione : Questa schermata è quella di stand-by, che si riottiene chiudendo il turno oppure uscendo dall applicazione. Premuto F1, il richiede il login con la sequenza (cfr. figura 4.1): 1 Nel caso sia stata scaricata una versione aggiornata del programma, questo reset consente al terminale di eseguire immediatamente il nuovo programma. ManualeOperatore_v2.0.docx Pag. 6 di 19
o User = inserire il NomeUtente e premere pulsante VERDE per confermare; o Password = inserire la Password e premere pulsante VERDE per confermare. Figura 4.1 Login dell Operatore. Le credenziali d ingresso sono rilasciare da Associazione Torino Città Capitale Europea (ATCCE). Il programma effettua la connessione GPRS con il server APN del fornitore della SIM (cfr. figura 4.2): o Dapprima compare la scritta Connecting GPRS e le tacche del livello di campo GPRS; o Successivamente il nome del provider (I TIM nelle schermate di esempio) e la scritta Connecting PPP : Figura 4.2 Apertura della connessione GPRS con il server APN. Il terminale esegue ora la connessione con il Server di Aggiornamento del programma di bordo e controlla se è disponibile una nuova versione del software; mostra quindi in sequenza alcune schermate in inglese, che riassumono i vari passaggi. A titolo puramente indicativo in figura 4.3 sono riportate alcune di queste schermate: ManualeOperatore_v2.0.docx Pag. 7 di 19
Figura 4.3 Controllo della versione ed aggiornamento dell applicativo. o Il terminale si riavvia e, dopo aver mostrato le schermate di boot e la schermata di reset di figura 4.4, ripropone nuovamente la schermata di stand-by (cfr. figura 3.1): Figura 4.4 Riavvio del terminale. L operatore dovrà quindi premere nuovamente F1 per riaccedere al programma e ripetere il login con le proprie credenziali (User e Password). ManualeOperatore_v2.0.docx Pag. 8 di 19
Il terminale riattiva il model interno (spento durante il riavvio) ed effettua nuovamente la connessione GPRS con il server APN del fornitore della SIM (cfr. figura 4.5): Figura 4.5 Apertura della connessione GPRS con il server APN. Stabilita la connessione GPRS, si attiva lo scambio dati FTP con il CdC (cfr. figura 4.6): Figura 4.6 Attivazione scambio FTP con il CdC. o Il scarica dal server i file con le impostazioni aggiornate che sono state pubblicate dal CdC (cfr. figura 4.7) e invia al server eventuali dati non ancora riallineati (cfr. figura 4.8): Figura 4.7 Importazione file dal server. ManualeOperatore_v2.0.docx Pag. 9 di 19
Figura 4.8 Esportazione dati verso il server. Il terminale esegue l aggiornamento del proprio orologio interno (cfr. figura 4.9): Figura 4.9 Aggiornamento orario. A questo punto, terminata con esito positivo la procedura di aggiornamento, il visualizzerà la schermata iniziale di lavoro, con il messaggio Avvicinare la tessera X per uscire (cfr. figura 4.10): Figura 4.10 Schermata di lettura delle smartcard. 4.3 Lettura delle smartcard Il flusso di lettura/scrittura delle smartcard differisce leggermente a seconda della tipologia delle carte: nel caso delle carte Abbonamento Musei della Lombardia e Milano (AMLM) e Abbonamento Musei Piemonte e ManualeOperatore_v2.0.docx Pag. 10 di 19
Torino (AMPT), delle carte e delle carte turistiche Torino+Piemonte Card (T+PC) e Torino+Piemonte Card Junior (T+PC) le informazioni sull ingresso registrato sono memorizzate all interno della carta; al contrario, sulle Pyou Card (PYC) e sulle Carte Edisu non vengono scritte informazioni all interno delle carte 2. 4.3.1 SMARTCARD ABBONAMENTO MUSEI E CARTE TURISMO TORINO In questo caso la procedura è la seguente: o Partendo dalla schermata di figura 4.10, l operatore prende la carta contactless e la posiziona sopra il display; attende il bip (di conferma della lettura) e quindi rimuove la carta. o Il terminale recupera gli articoli dei vari percorsi del museo (partendo dall operatore di login usato) e mostra le schermate di figura di 4.11: Figura 4.11 Menu scelta dell articolo d ingresso. N.B. Nel caso il museo abbia un unico percorso di visita, le schermate di figura 4.11 non vengono mostrate e si arriva direttamente alla maschera di figura 4.12. o Sarà cura dell operatore selezionare l articolo corretto e premere il pulsante VERDE per selezionarlo; il terminale chiede di avvicinare nuovamente la tessera (cfr. figura 4.12): Figura 4.12 Richiesta di riavvicinare la tessera. o L operatore avvicina nuovamente la smartcard al display ed attende il bip (di conferma della lettura) e quindi rimuove la carta. Il dispositivo mostra le schermate di figura 4.13 e registra l ingresso nella carta e nel proprio log interno. 2 Le carte AMLM sono attive nei soli musei della Lombardia. Le carte AMPT, T+PC, T+PCJ, PYC ed Edisu sono invece valide nei soli musei del Piemonte. ManualeOperatore_v2.0.docx Pag. 11 di 19
Figura 4.13 Registrazione dell ingresso. o Il terminale mostra nuovamente la maschera di lettura della carta (cfr. figura 4.14) ed è di nuovo pronto per un altra registrazione: Figura 4.14 Richiesta di una nuova lettura della smartcard. o L operatore ripete la procedura di lettura. 4.3.2 SMARTCARD PYOU ED EDISU Nel caso delle PYC e carte Edisu (disponibili solo in Piemonte), non è necessario avvicinare due volte la tessera (poiché l ingresso non viene scritto in carta) e quindi la procedura è leggermente più semplice; in dettaglio: o Partendo dalla schermata di figura 4.10, l operatore prende la carta contactless e la posiziona sopra il display; attende il bip (di conferma della lettura) e quindi rimuove la carta. o Il terminale recupera gli articoli dei vari percorsi del museo (partendo dall operatore di login usato) e mostra le schermate di figura di 4.15: ManualeOperatore_v2.0.docx Pag. 12 di 19
Figura 4.15 Menu scelta dell articolo d ingresso. N.B. Nel caso il museo abbia un unico percorso di visita, le schermate di figura 4.15 non vengono mostrate e si arriva direttamente alla maschera di figura 4.16. o Sarà cura dell operatore selezionare l articolo corretto e premere il pulsante VERDE per selezionarlo. o Il dispositivo mostra direttamente le schermate di figura 4.16 e registra l ingresso nel proprio log interno. Figura 4.16 Registrazione dell ingresso. o Il terminale mostra nuovamente la maschera di lettura della carta (cfr. figura 4.17) ed è di nuovo pronto per un altra registrazione: Figura 4.17 Richiesta di una nuova lettura della smartcard. o L operatore ripete la procedura di lettura. ManualeOperatore_v2.0.docx Pag. 13 di 19
4.3.3 ERRORI E/O MESSAGGI VARI In questo paragrafo sono evidenziati alcuni errori e/o messaggi che il può visualizzare a seconda dello stato delle carte: Ingresso acquistato di recente con la tessera presente (cfr. figura 4.18): si tratta del controllo antipassback. In altre parole non è possibile registrare più volte un ingresso su uno stesso percorso con la stessa tessera nell arco di 2 ore; il terminale controlla ed impedisce gli ingressi reiterati. Figura 4.18 Controllo antipassback. ATTENZIONE Timeout attesa tessera scaduto (cfr. figura 4.19): significa che il terminale non è riuscito a leggere/scrivere la tessera nel tempo previsto; tipicamente questo errore si può verificare quando il terminale chiede di avvicinare nuovamente la carta per codificare l ingresso e l operazione non avviene nel tempo previsto per quest operazione. Basta semplicemente dare conferma al messaggio premendo il Tasto Verde (O) e ripetere l operazione di registrazione ingressi 3. Figura 4.19 Errore Timeout attesa tessera scaduto. Errore lettura contratto (cfr. figura 4.20): il terminale non è riuscito a trovare all interno della tessera un contratto valido. Potrebbe trattarsi semplicemente di un problema legato alla lettura della carta (perché ad esempio è stata posizionata male la tessera sul o perché è stata allontanata prima che il dispositivo abbia completato la lettura), oppure la tessera non contiene un titolo d ingresso. In ogni caso non è possibile registrare l ingresso. 3 Proprio perché il terminale controlla e blocca gli ingressi reiterati, se un operatore ha un qualunque dubbio che una registrazione sia andata a buon fine, conviene sempre ripetere la registrazione dell ingresso. ManualeOperatore_v2.0.docx Pag. 14 di 19
Figura 4.20 Errore lettura contratto. Errore contratto scaduto (cfr. figura 4.21): il titolo di abbonamento codificato in tessera è scaduto e quindi non è possibile registrare l ingresso. Figura 4.21 Errore contratto scaduto. Errore tessera non abilitata per gli ingressi (cfr. figura 4.22): in questo caso la tessera non è valida per accedere al museo; tipicamente questo errore si verifica nei seguenti casi: o Si tratta di una PYC senza un titolo di abbonamento valido 4 ; o SI tratta di una tessera con un abbonamento valido per un bacino diverso da quello cui appartiene il museo: ad esempio è una carta AMLM (AMPT) che prova ad accedere ad un museo del Piemonte (Lombardia). Figura 4.22 Errore tessera non abilitata per gli ingressi. 4 Questa casistica si verifica solo in Piemonte. ManualeOperatore_v2.0.docx Pag. 15 di 19
4.4 Menu Principale Al termine delle letture, premendo il bottone ROSSO, l operatore accede al MENU PRINCIPALE (cfr. figura 4.23), che si compone delle voci: o 0 AVVIA: consente di riavviare il programma e tornare alla figura 4.17. o 1 CHIUDI TURNO: consente di chiudere il turno corrente e di trasferire i dati immagazzinati nel durante lo svolgimento del turno stesso. Chiede anche se si vuole stampare un riepilogo degli ingressi registrati. Il torna poi alla schermata di stand-by (cfr. figura 3.1). o 2 RIEPILOGO INGRESSI: consente la stampa di riepilogo degli ingressi registrati. o 3 ANNULLA INGRESSO: consente di annullare l ultimo ingresso effettuato. Fino a che non si chiude il turno. Dopo non sarà più possibile annullare i titoli emessi nei turni precedenti a quello corrente. o 4 CAMBIA UTENTE: consente di effettuare la chiusura del turno e di riposizionarsi nella schermata di login (cfr. figura 3.1). o 5 MENU UTENTE: consente l apertura di un menu utente. o 6 USCITA : consente di ritornare nella posizione di stand-by senza chiudere il turno. Figura 4.23 Menù Principale. 4.5 Annullamento della registrazione di un ingresso E possibile annullare SOLO l ultimo ingresso registrato, se ad esempio è stato selezionato il percorso sbagliato. L operazione si esegue in questo modo: Dopo aver registrato un ingresso, il terminale si riposiziona nella schermata di attesa tessera di figura 4.14. L operatore preme il tasto ROSSO X ed accede al MENU PRINCIPALE. Seleziona l opzione 3 ANNULLA INGRESSO e conferma l operazione con il pulsante VERDE O. In figura 4.24 sono riportati i messaggi di richiesta conferma dell operazione e di avvenuto annullamento. ManualeOperatore_v2.0.docx Pag. 16 di 19
Figura 4.24 Annullamento dell ultimo ingresso. 4.6 Chiusura del turno e comunicazione con il CdC Terminato il proprio turno di lavoro, l operatore procede alla chiusura del turno di lavoro, in questo modo: Partendo dalla schermata di attesa tessera di figura 4.14, l operatore preme il tasto ROSSO X ed accede al MENU PRINCIPALE. Seleziona la voce di menu 1 CHIUDI TURNO e conferma l operazione con il pulsante VERDE O (cfr. figura 4.25): Figura 4.25 Chiusura del turno. Il terminale mostra la richiesta di stampa di riepilogo (cfr. figura 4.26): Figura 4.26 Chiusura del turno. o Premendo il tasto pulsante VERDE O, il terminale produce lo scontrino di riepilogo di figura 4.27: ManualeOperatore_v2.0.docx Pag. 17 di 19
Figura 4.27 Scontrino di riepilogo. o Premendo il tasto pulsante ROSSO X, il terminale non stampa alcun report. Il terminale avvia la comunicazione con il server, per la trasmissione dei dati degli ingressi registrati. o Viene attivata la connessione GPRS con l APN (cfr. figura 4.28): Figura 4.28 Apertura della connessione GPRS con l APN. o Si attiva lo scambio dati FTP con il server (cfr. figura 4.29): Figura 4.29 Attivazione scambio FTP con il server. o Il programma invia al server il file di log delle attività svolte e di riepilogo dei parametri e delle configurazioni del dispositivo (cfr. figura 4.30): ManualeOperatore_v2.0.docx Pag. 18 di 19
Figura 4.30 Esportazione file di log verso il CdC. A questo punto il terminale ritorna alla schermata di stand-by (cfr. figura 3.1) e l attività di lavoro è ultimata. ManualeOperatore_v2.0.docx Pag. 19 di 19