Server OpenPass - Cronologia

Marco: /* Architettura software dei SERVIZI WEB Sistema openpass */

2016-10-14T08:15:39Z

‎Architettura software dei SERVIZI WEB Sistema openpass

Marco: /* Comunicazione tra il server openpass e i client delle stazioni */ : modifiche immagine

2016-10-14T08:13:24Z

‎Comunicazione tra il server openpass e i client delle stazioni: : modifiche immagine

Marco: /* Architettura software dei SERVIZI WEB Sistema openpass */

2016-10-14T08:05:23Z

‎Architettura software dei SERVIZI WEB Sistema openpass

Marco: /* Server Database */

2016-10-14T08:03:15Z

‎Server Database

Marco: /* Configurazione firewall */

2016-10-14T08:02:14Z

‎Configurazione firewall

Marco: /* Servizi del Formato 3 - Estensione dei servizi per la vendita online */

2016-10-14T07:59:03Z

‎Servizi del Formato 3 - Estensione dei servizi per la vendita online

Marco: /* Servizi del Formato 3 */

2016-10-14T07:52:05Z

‎Servizi del Formato 3

Marco: /* Servizi del Formato 3 */

2016-10-14T07:50:06Z

‎Servizi del Formato 3

Marco: /* Servizi del Formato 3 */

2016-10-14T07:49:26Z

‎Servizi del Formato 3

Marco: /* Servizi del Formato 3 */

2016-10-14T07:49:05Z

‎Servizi del Formato 3

@@ Riga 347: / Riga 347: @@
 |}
 * Customer type (residenza utilizzatori)
 {| class="wikitable"
 ! Nome file !! Campi !! Collegamento ad altri file (chiave esterna)

@@ Riga 13: / Riga 13: @@
 Il server gestisce a frequenza prestabilita operazioni di configurazione e di caricamento dati, attraverso chiamate XML.
-[[File:Comunicazione_openpass.png|frame|center|link=|Comunicazione tra il server OpenPass e i client delle Stazioni]]
+[[File:Comunicazione_openpass.png|thumb|800px|center|link=|Comunicazione tra il server OpenPass e i client delle Stazioni]]
 === Servizi del Formato 3 ===

@@ Riga 293: / Riga 293: @@
 === Architettura software dei SERVIZI WEB Sistema openpass ===
-Il server OPENPASS deposita nella cartella condivisa in questa cartella i flussi che contengono le informazioni da trasferire (anagrafiche e passaggi).
+Il server OPENPASS deposita nella cartella condivisa i flussi che contengono le informazioni da trasferire (anagrafiche e passaggi).
 Per ogni file, il nome sarà auto esplicativo e,per ogni flusso, sarà così composto:

@@ Riga 213: / Riga 213: @@
 ==== Server Database ====
-Sia per  VM-OpenPass-Master che per VM-OpenPass-Slave viene installato il server database '''MariaDB'''.
+Sia per  VM-OpenPass-Master che per VM-OpenPass-Slave viene installato il server database ''MariaDB''.
 Per l’installazione del software viene utilizzato il seguente comando:

@@ Riga 167: / Riga 167: @@
 ==== Configurazione firewall ====
 Sia per  VM-OpenPass-Master che per VM-OpenPass-Slave viene gestita la configurazione del firewall software mediante il sistema ''iptables''.
 La configurazione del firewall prevede regole riportate nella seguente tabella.
 {| class="wikitable"
@@ Riga 183: / Riga 184: @@
 | SSH || Non stardard || Solo IP del gestore del server
 |}
 ==== Server Web ====
 Sia per  VM-OpenPass-Master che per VM-OpenPass-Slave viene installato il server WEB ''Apache 2'' e l’application server ''PHP 5''.

@@ Riga 113: / Riga 113: @@
 ! Servizio !! Specifiche implementazioni
 |-
-| '''RegisterWebSales''' || Servizio per inviare le transizioni di vendita effettuate dal un WebShop. Ogni transazione di vendita verrà identificata univocamente dal proprio seriale di vendita RegisterWebSaleID fornito dal server OpenPass. Più transazioni di vendita possono essere raggruppate da un unico OrderNumber fornito dal Webshop in fase di invio transazioni. Tra le varie informazioni inviate ci saranno: * ''OperationType'': (0-ritiro, 1 ricarica, 2 registrare rata di denaro, 3 storno), * ''Payperuse'': (0 = no peyperuse, 1 = si payperuse), * ''Insurance'': Abbinata un’assicurazione (0 = no, 1 = si), * ''CardPaid'': inclusa la card nella transazione di vendita (0 = no, 1 = si)
+| '''RegisterWebSales''' || Servizio per inviare le transizioni di vendita effettuate dal un WebShop. Ogni transazione di vendita verrà identificata univocamente dal proprio seriale di vendita RegisterWebSaleID fornito dal server OpenPass. Più transazioni di vendita possono essere raggruppate da un unico OrderNumber fornito dal Webshop in fase di invio transazioni. Tra le varie informazioni inviate ci saranno:<ul><li> ''OperationType'': (0-ritiro, 1 ricarica, 2 registrare rata di denaro, 3 storno),</li><li>''Payperuse'': (0 = no peyperuse, 1 = si payperuse),</li><li>''Insurance'': Abbinata un’assicurazione (0 = no, 1 = si),</li><li>''CardPaid'': inclusa la card nella transazione di vendita (0 = no, 1 = si)</ul>
 |-
 | '''UpdateWebSalesAmmount''' || Servizio per aggiornare le vendite Web con il quantitativo economico derivato dal calcolo dell'uso

@@ Riga 16: / Riga 16: @@
 === Servizi del Formato 3 ===
-La comunicazione tra il server OpenPass ed i client delle stazioni avviene su protocollo HTTP mediante l’architettura
+La comunicazione tra il server OpenPass ed i client delle stazioni avviene su protocollo HTTP mediante l’architettura software RESTful.
-Per la comunicazione sono stati progettati e realizzati dei servizi organizzati in risorse web accessibili a seguito di
+Per la comunicazione sono stati progettati e realizzati dei servizi organizzati in risorse web accessibili a seguito di autenticazione.
-L’architettura software utilizza il paradigma ''client-server'': i servizi attivati, in architettura RESTful, sono di seguito
+L’architettura software utilizza il paradigma ''client-server'': i servizi attivati, in architettura RESTful, sono di seguito riportati.
-Il servizio è finalizzato a ricevere i dati relativi ai passaggi e alle vendite dei biglietti regionali dalle stazione consociate
+Il servizio è finalizzato a ricevere i dati relativi ai passaggi e alle vendite dei biglietti regionali dalle stazione consociate ANEF SKI Lombardia.
 I web services si possono dividere in queste macro-categorie:
@@ Riga 35: / Riga 31: @@
 * Servizi di SICUREZZA
-ANEF SKI Lombardia ha distribuito ad ogni stazione delle credenziali di accesso (username e password) ai web services
+ANEF SKI Lombardia ha distribuito ad ogni stazione delle credenziali di accesso (username e password) ai web services per l’invio dei dati al server OpenPass. La company, per autenticarsi, deve chiamare i ''Servizi di LOGIN'', in particolar modo il '''Web Service''' (d’ora in poi '''WS''') '''LOGIN''' che consente l’autenticazione di un utente; tale autenticazione rimarrà attiva per tutta la durata della sessione di scambio dei dati.
 Una volta autenticati, si devono chiamare i WS della categoria ''Servizi di GESTIONE del FORMATO'': tali WS sono
@@ Riga 46: / Riga 39: @@
 * '''GETFORMAT'''.
-'''REGISTERTOKEN''' consente di registrare un token personalizzato. I tokens che cominciano con ‘Root.’ richiedono
+'''REGISTERTOKEN''' consente di registrare un token personalizzato. I tokens che cominciano con ‘Root.’ richiedono l’accesso di un amministratore. Ogni token ha un tipo associato (es. numerico, data, ora etc.). Il token non dipende dalla Stazione che ne fa richiesta.
-'''REGISTERFORMAT''' consente di registrare un formato di registrazione da utilizzare per la produzione e l’interpretazione
+'''REGISTERFORMAT''' consente di registrare un formato di registrazione da utilizzare per la produzione e l’interpretazione di biglietti. Ritorna un codice identificativo univoco per il formato. La chiamata può essere effettuata tutte le volte che si vuole, il sistema ritornerà sempre lo stesso codice. Il codice di formato è quindi uguale per tute le stazioni che ne fanno richiesta. Lo stesso formato può essere condiviso tra più biglietti (es. Stagionale Adulti, Ridotto, FISI etc.).
 '''ENUMERATEFORMATS''' restituisce l'elenco esaustivo dei codici identificativi dei formati noti al server.
@@ Riga 67: / Riga 55: @@
 * '''REGISTERSALES'''
-Il WS '''REGISTERTICKET''' consente di registrare un set di valori di tokens costanti per una certa categoria di biglietti al fine
+Il WS '''REGISTERTICKET''' consente di registrare un set di valori di tokens costanti per una certa categoria di biglietti al fine di poterla identificare con rapidità nelle elaborazioni dati. (Es. Stagionale adulti, Stagionale ridotto). Ritorna un codice identificativo univoco per il biglietto che è identico al valore passato per il token “TicketID” obbligatorio. La chiamata può essere effettuata tutte le volte che si vuole; a parità di valori il sistema ritornerà sempre lo stesso codice. La chiamata consente una registrazione diversa per ogni Stazione, ma il codice numerico ritornato sarà a parità di set di valori lo stesso su più stazioni. Due biglietti uguali non possono né devono avere codici identificativi differenti.
-Il WS '''ENUMERATETICKETS''' ottiene l’elenco esaustivo dei codici identificativi dei biglietti noti al server per la stazione
+Il WS '''ENUMERATETICKETS''' ottiene l’elenco esaustivo dei codici identificativi dei biglietti noti al server per la stazione specificata in fase di chiamata.
 Il WS '''GETTICKET''' ottiene la definizione del biglietto di cui si è specificato il codice identificativo in fase di chiamata.
@@ Riga 81: / Riga 63: @@
 Il WS '''REGISTERCUSTOMER''' permette la registrazione di un cliente sul sistema , restituendo al chiamante un codice numerico identificativo del customer.
-Il WS '''REGISTERSALES''' registra un insieme di vendite di biglietti di consorzio in formato comune sul server per il gruppo,
+Il WS '''REGISTERSALES''' registra un insieme di vendite di biglietti di consorzio in formato comune sul server per il gruppo, la società e le postazioni specificate. Ogni chiamata può contenere una o più registrazioni di vendita. Ogni vendita è associata ad un cliente, il cui codice identificativo va ottenuto con l'invocazione del servizio '''REGISTERCUSTOMER'''. Il CustomerIdentifier è a 0 per i biglietti non nominativi. All’interno di ogni vendita, unitamente al ticket identifier (che specifica i valori costanti), vengono specificati i valori rilevanti dei tokens ‘dinamici’, ovvero quelli assegnati al momento dell’edizione di un biglietto.
-All’interno dei ''Servizi di INVIO DATI'' ci sono anche i servizi dedicati alla ''GESTIONE dei PASSAGGI'': il WS
+All’interno dei ''Servizi di INVIO DATI'' ci sono anche i servizi dedicati alla ''GESTIONE dei PASSAGGI'': il WS '''REGISTERPASSAGES''' registra un insieme di passaggi agli impianti di biglietti di consorzio in formato comune sul server per il gruppo, la società e gli impianti specificati. Ogni chiamata può contenere una o più registrazioni di passaggio. Ogni passaggio è opzionalmente associato ad un cliente, il cui codice identificativo va ottenuto con l'invocazione del
-'''REGISTERPASSAGES''' registra un insieme di passaggi agli impianti di biglietti di consorzio in formato comune sul server
+servizio '''REGISTERCUSTOMER'''. Ricordiamo che il CustomerIdentifier è a 0 per i biglietti non nominativi. All’interno di ogni passaggio, unitamente al ticket identifier (che specifica i valori costanti), vengono specificati i valori rilevanti dei tokens ‘dinamici’, ovvero quelli assegnati al momento dell’edizione di un biglietto e che si modificano durante l’utilizzo.
-Tra i ''Servizi di INVIO DATI'' rientra anche il WS '''SETDAILYFIRSTPASSAGESCOUNT''' che invia al server, ai fini statistici, il
+Tra i ''Servizi di INVIO DATI'' rientra anche il WS '''SETDAILYFIRSTPASSAGESCOUNT''' che invia al server, ai fini statistici, il conteggio indistinto dei primi passaggi di tutti i biglietti di stazione e di consorzio e non obbligatoriamente il conteggio distinto dei primi passaggi categorizzati.
 Tra i ''Servizi di STRUTTURA dell’ARCHITETTURA'' ci sono i WS:
@@ Riga 107: / Riga 77: @@
 Infine ci sono i ''Servizi di SICUREZZA'' che sono:
 * '''REGISTERWORKSTATIONKEY''' che registra una chiave pubblica appartenente ad una postazione emittente
-* '''ENUMERATEKEYS''' che consente di ottenere l’elenco esaustivo delle chiavi pubbliche della postazione
+* '''ENUMERATEKEYS''' che consente di ottenere l’elenco esaustivo delle chiavi pubbliche della postazione emittente specificata
 * '''GETKEY''' che consente di ottenere la chiave pubblica specificata.

@@ Riga 102: / Riga 102: @@
 Tra i ''Servizi di STRUTTURA dell’ARCHITETTURA'' ci sono i WS:
-* '''ENUMERATEGROUPS''' che consente di ottenere l’elenco esaustivo dei codici identificativi dei gruppi noti al
+* '''ENUMERATEGROUPS''' che consente di ottenere l’elenco esaustivo dei codici identificativi dei gruppi noti al server
-server
+* '''ENUMERATECOMPANIES''' che consente di ottenere l’elenco esaustivo delle stazioni note al server appartenenti al gruppo specificato
-* '''ENUMERATECOMPANIES''' che consente di ottenere l’elenco esaustivo delle stazioni note al server
+* '''ENUMERATEWORKSTATIONS''' che consente di ottenere l’elenco esaustivo delle postazioni di vendita note al server appartenenti alla società specificata.
 Infine ci sono i ''Servizi di SICUREZZA'' che sono: