Upload
others
View
1
Download
0
Embed Size (px)
Citation preview
RT VIRTUAL CARD
Presentazione
2
Il progetto Grazie alla facilità di utilizzo degli attuali smartphone e al loro uso per funzioni sempre più differenti – non
solo telefonare o spedire messaggi, ma un vero e proprio strumento multimediale per immagazzinare
informazioni e gestire sia il proprio tempo libero che la propria attività professionale- è facile prevedere
che, a supporto delle più recenti politiche di dematerializzazione, siano proprio i cellulari a rappresentare
un nodo cruciale.
Proprio per questo, nel presente progetto gli smartphone sono pensati come strumenti a supporto di una
pratica comune in ambienti professionali (e non), ovvero lo scambio di biglietti da visita.
Inoltre, sempre più spesso le aziende, gli enti in generale stampano biglietti da visita, ma all’atto pratico i
contatti tra dipendenti e interlocutori esterni (clienti, stakeholder etc) vengono scambiati, salvati
direttamente e frettolosamente tramite smartphone. Durante un incontro, una riunione non c’è mai il
tempo necessario per copiare i dati dei partner, clienti o lead; e comunque la scansione tramite app con
OCR risulta abbastanza laboriosa e comunque demandata alla buona volontà dell’interlocutore. Quindi,
solo una piccolissima parte dei dati presenti sui biglietti da visita è poi realmente presente sui dispositivi
mobile, e nelle rubriche digitali.
L’APP – RT Virtual Card, progettata per dispositivi iOS e Android, si pone l’obiettivo di favorire e
ottimizzare il processo di gestione del contatto e delle informazioni contenute nei business card nel
contesto di politiche di dematerializzazione.
Il sistema è costituito da app native: iOS e Android e da una WebAPPlication residente su server Regione
Toscana.
Vantaggi
RT Virtual Card consente di:
- ridurre i costi di stampa/ristampa biglietti
- gestire le informazioni dei contatti dei propri dipendenti e collaboratori in maniera dinamica
I biglietti sono sempre aggiornati con le informazioni e anagrafiche presenti sul database di Regione
Toscana
- adottare strategie orientate alle dematerializzazione
3
MANUALE D’USO
1 - ACCESSO e AUTENTICAZIONE
L’utente non deve che fare pochi semplici passi per utilizzare RT Virtual Card
APRI RT VIRTUAL CARD
Una volta installata tramite i sistemi distribuzione MDM o
installazione diretta da parte del personale RT, si può accedere
all’app cliccando sull’icona della medesima.
LOGIN
Al primo accesso è richiesto
l’inserimento del Codice Fiscale
come ID personale identificativo
1 2
4
L’APP SI AGGIORNA CON LE INFORMAZIONI
DELL’UTENTE
L’app interrogando il database di Regione Toscana
(tramite WebService) recupera i dati dell’utente e
viene cosi generato AUTOMATICAMENTE il relativo
biglietto da visita con i dati presenti sul sistema.
Una volta effettuato l’accesso, l’utente sarà abilitato a
visualizzare e spedire il proprio biglietto da visita già
compilato. La sessione aperta sul device potrà
rimanere attiva per facilitare l’accesso e la gestione
dell’app senza dover, quindi, ripetere la procedura di
login.
Effettuando un tap sul pulsante “Update”,
l’app re-interroga nuovamente il
database di regione tramite il webservice
e aggiorna le informazioni istituzionali del
biglietto
3
5
2 – INVIO BIGLIETTO DIGITALE
2.1 – CHI SPEDISCE : come inviare il proprio biglietto da visita
L’utente, al momento dell’invio del proprio biglietto da visita, attiva una procedura semplice e immediata
Riassumiamo gli step:
INSERISCI DATI DESTINATARIO
L’utente inserisce sulla propria APP il numero di
telefono o email al quale recapitare il contatto.
L’utente ha la possibilità di selezionare eventualmente
i contatti dalla rubrica, qualora abbia il destinatario già
salvato. L’app riconosce automaticamente la stringa
(telefono o email) inserita e di conseguenza invia il
relativo formato.
Seleziona i biglietto
Nel caso specifico di RT Virtual Card l’utente ha a
disposizione un unico biglietto a disposizione, quello
generato dall’interrogazione al database degli utenti di
Regione Toscana. La selezione sarà pre-impostata.
Qualora l’utente fosse abilitato a creare ulteriori
biglietti, in fase di spedizione potrebbe selezionare il
biglietto che desidera inviare.
.
2
1
1
2
6
Dopo aver effettuato l’invio del proprio biglietto,
l’utente ha la possibilità di salvare il numero o email
del destinatario in rubrica senza reinserirlo
nuovamente
3
3
7
3 – RICEZIONE DA PARTE DELL’UTENTE
RICEZIONE SMS
L’utente destinatario riceve l’sms con i
riferimenti al mittente Nome e Cognome e
indicazioni per scaricare il biglietto da visita
digitale tramite il link
RICEZIONE EMAIL
L’utente destinatario riceve l’sms
con i riferimenti al mittente Nome
e Cognome e indicazioni per
scaricare il biglietto da visita
digitale tramite il BOTTONE
LINK
1 1
2 2
8
APERTURA E SALVATAGGIO DEL BIGLIETTO Dopo aver cliccato sul link del biglietto, la webapp riconosce iOS e dispositivo e restituisce i biglietti VCard
con modalità di salvataggio differenziati rispetto al dispositivo
IOS: Dopo aver cliccato sul link del biglietto l’utente che utilizza un
dispositvo iOS visualizzerà direttamente una schermata con il biglietto.
Effettuando il tap su “Apri in Contatti” si aprirà il biglietto direttamente
tramite l’app “Contatti” e sarà possibile cosi, visualizzare le informazioni e
salvarle sul dispositivo.
ANDROID: Dopo aver cliccato sul link del biglietto l’utente che utilizza un
dispositvo Android visualizzerà una schermata intermedia con un
pulsante “Scarica” in modo da dare la possibilità all’utente di gestire il
processo di download.
Una volta scaricato il biglietto, l’utente potrà aprire il medesimo e salvare i
dati sul dispositivo.
Gli utenti con device con altri OS, possono scaricare direttamente il VCard
A
B
9
4 – IL SISTEMA RT VIRTUAL CARD
Schema di funzionamento RT VIRTUAL CARD
AUTENTICAZIONE TRAMITE WEBSERVICE
L’app RT Virtual Card consente il login tramite codice fiscale dell’utente, e verifica tramite il webservice
raggiungibile all’indirizzo: http://www301.regione.toscana.it/bancadati/RTextragroup/ANAGRAFICA.xml.
10
Al webservice sono passati il codice fiscale dell’utente crittografato in MD5 oltre che una password di
autenticazione al servizio.
WEBSERVICE
Es.
http://www301.regione.toscana.it/bancadati/RTextragroup/ANAGRAFICA.xml?cf=7c712ef1db0a62542fc9b32
e0ad6415bf41852945002bf6705f01eb1d6b265f8&PASSWORD=xxxxxxxx
GESTIONE DEL BIGLIETTO TRAMITE WEBAPPLICATION
Una volta che l’utente ha effettuato l’accesso, i dati del biglietto da visita vengono salvati temporaneamente
sul database MySQL della webapp, in modo da garantire la consultazione e eventuale integrazione da parte
dell’utente sui campi sui quali è abilitato.
La web application, come visto, accede alle info ricavate direttamente dal webservice o integrate dall’utente
per generare on the fly il vcard alla richiesta esterna (da parte del destinatario che clicca sul link inviato
tramite sms o email, vedi grafico)
Di seguito la struttura del Database MySql:
‘id` int(11) unsigned NOT NULL auto_increment,
`serial` varchar(255) default NULL,
`name` varchar(255) default NULL,
`body` text,
`data` longtext,
`url` varchar(255) default NULL,
`note` tinyint(1) unsigned default NULL,
`id_code` varchar(256) default NULL,
id: Chiave primaria
serial: il serial che identifica il biglietto in modo univoco (il controllo viene fatto a livello di programma)
name: nome o titolo del biglietto in questo caso rappresentato dal codice fiscale
body: vecchio campo che conteneva il corpo del biglietto. Mantenuto per retrocompatibilità. DEPRECATO.
data: il corpo del biglietto. Contiene tutti i dati in formato json che vengono elaborati in forato vcf al momento della
richiesta del biglietto. Viene usato json perché è un ottimo formato di interscambio fra app di natura diversa.
url: l'url dal quale scaricare il biglietto
note: campo ausiliario
id_code: codice identificativo dell'utente legato al codice fiscale
Ad ogni accesso o quando l’utente clicca su “update” (vedi pag. 4) i dati presenti sul db vengono rigenerati.
La web application residente sul server RT raggiungibile all’indirizzo http://www309.regione.toscana.it è
11
sviluppato con Laravel 5 http://laravel.com/ , un framework php per lo sviluppo di web app tra i più moderni
ed apprezzati nella comunità di sviluppatori PHP. Fa parte del gruppo PHP-FIG ( PHP Framework Interop
Group) che garantisce alcuni coding standards nello sviluppo e nell'interoperabilità di risorse tra membri del
gruppo.
Laravel funziona con PHP 5.4. Questo permette di utilizzare tutte le ultime novità di PHP compreso i nuovi
autoloading standards PSR-4. Il sito web è ideato per funzionare con Mysql come Storage system.
Di seguito si riportano le librerie e relativa descrizione:
LIBRERIE E DOCUMENTAZIONE
doctrine/annotations v1.1.2 Docblock Annotations Parser doctrine/cache v1.3.0 Caching library offering an object-oriented API for many cache backends doctrine/collections v1.2 Collections Abstraction library doctrine/common v2.4.1 Common Library for Doctrine projects doctrine/dbal 2.3.4 Database Abstraction Layer doctrine/inflector v1.0 Common String Manipulations with regard to casing singular/plural rules. doctrine/lexer v1.0 Base library for a lexer that can be used in Top-Down, Recursive Descent Parsers. kriswallsmith/buzz v0.10 Lightweight HTTP client monolog/monolog 1.8.0 Sends your logs to files, sockets, inboxes, databases and various web services pimple/pimple v1.1.1 Pimple is a simple Dependency Injection Container for PHP 5.3 psr/log 1.0.0 Common interface for logging libraries sabre/vobject 3.2.0 The VObject library for PHP allows you to easily parse and manipulate iCalendar and vCard objects silex/silex v1.2.0 The PHP micro-framework based on the Symfony2 Components swiftmailer/swiftmailer v4.1.8 Swiftmailer, free feature-rich PHP mailer symfony/debug v2.4.3 Symfony Debug Component symfony/event-dispatcher v2.4.3 Symfony EventDispatcher Component symfony/http-foundation v2.4.3 Symfony HttpFoundation Component symfony/http-kernel v2.4.3 Symfony HttpKernel Component symfony/routing v2.4.3 Symfony Routing Component symfony/security v2.4.3 Symfony Security Component twig/twig v1.15.1 Twig, the flexible, fast, and secure template language for PHP REDBEANPHP v3.5 DOCUMENTAZIONE APPROFONDIMENTO Per doctrine/* documentazione: http://www.doctrine-project.org/projects.html Per kriswallsmith/buzz documentazione: https://github.com/kriswallsmith/buzz Per monolog/monolog documentazione: https://github.com/Seldaek/monolog Per pimple/pimple, silex/silex, swiftmailer/swiftmailer, symfony/debug, symfony/event-dispatcher, symfony/http-foundation, symfony/http-kernel, symfony/routing ,symfony/security, twig/twig documentazione: https://sensiolabs.com/ Per psr/log documentazione: https://github.com/php-fig/log
12
Per sabre/vobject documentazione: https://github.com/fruux/sabre-vobject Per REDBEANPHP documentazione: http://www.redbeanphp.com/ INVIO SMS
L’SMS con il link al biglietto da visita viene inviato direttamente dal dispositivo dell’utente. INVIO EMAIL
L’email con il link al biglietto da visita viene inviata tramite un’interrogazione da parte l’app mobile nei
confronti della webapplication. Viene passata la chiamata assieme ad un seriale univoco generato con
UniqId Php. I dati inviati sono estratti dal db in locale senza che le query vengano influenzate da dati esterni.
Webapplicaton al momento dell’invio controlla i dati passati dall’app e controlla:
- se è il campo destinatario è presente nella chiamata da parte della app mobile,
- se è presente il seriale, se è presente cerca nel db il seriale per verificare se esiste.
- se esiste il seriale, invia l’email
Come SMTP viene utilizzato il server SMTP 159.213.225.100 con hostname hosting-rt-
mailproxy.rete.toscana.it sulla porta 25.
Non viene, quindi, spedita nessuna email direttamente dal dispositivo dell’utente. La webapplicatione è predisposta all’utilizzo del protocollo TLS.
GENERAZIONE VCARD
Chi riceve l’SMS o l’email con il link al VCARD, ha la possibilità di scaricare il biglietto da visita dell’utente
mittente cliccando sul link presente nel messaggio. Cliccando sul link viene interrogata la webapplication che
genera on the fly il vcard. Viene utilizzata la versione VCard 3.0, ma alcuni dispositivi possono avere dei
campi personalizzati particolari.