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.