Protocollo di comunicazione
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
<strong>Protocollo</strong> <strong>di</strong> <strong>comunicazione</strong> Dati Tecnici<br />
MANUALE TECNICO<br />
a cura <strong>di</strong> Quattroruote Professional
1.0. Componenti del Sistema e flusso informazioni<br />
Durante l’utilizzo <strong>di</strong> Dati tecnici possiamo identificare tre attori software che definiscono una vista architetturale del contesto<br />
applicativo, e un attore che corrisponde all’utilizzatore del sistema:<br />
Portal: è un generico portale e rappresenta il sistema terzo che permette l’utilizzo <strong>di</strong> Dati tecnici. Più in generale,<br />
Portal identifica l’applicazione (dunque non necessariamente un “portale” web) che deve praticamente essere<br />
realizzata da chi vuole utilizzare il software dall’esterno;<br />
Dati tecnici: si intende l’applicazione;<br />
Gateway: è un ambiente tramite il quale Portal può inviare a Dati tecnici informazioni circa la modalità <strong>di</strong> accesso<br />
all’applicazione stessa;<br />
Figura 1<br />
Descrizione dei passi da compiere per una corretta <strong>comunicazione</strong> con il software Dati tecnici:<br />
1. Il launcher (come launcher si intende una serie <strong>di</strong> istruzioni utilizzate per comunicare con il gateway e per lanciare<br />
Dati tecnici) del portale chiamerà il gateway passando le credenziali e l’xml <strong>di</strong> input.<br />
2. Il gateway controllerà le credenziali e risponderà con il token.<br />
3. Il launcher chiama Dati tecnici con il token recuperato dal gateway
2.0. Dettagli tecnici<br />
Di seguito definiamo quali sono in dettaglio i parametri <strong>di</strong> configurazione per la chiamata all’applicazione. I<br />
Il Gateway da chiamare per l’autenticazione è il seguente:<br />
http://www.infocar-repair.it/Jestimate_Gateway/PersistentrequestService.asmx<br />
Il web method è GetAuthenticationToken.<br />
L’URL dei Dati tecnici è la seguente<br />
http://www.infocar-repair.it/IR_DatiTecniciTelaio/Startup.aspx?token=&user=<br />
Viene riportato qui sotto una porzione <strong>di</strong> co<strong>di</strong>ce C# per l’autenticazione al Gateway come esempio:<br />
JEGateway_Request.PersistentRequestService jerWs = new JEGateway_Request.PersistentRequestService();<br />
string _username = "******@*****.***";<br />
string _pwd = "******";<br />
JEGateway_Request.AuthHeader Credentials = new JEGateway_Request.AuthHeader();<br />
Credentials.UserName = _username;<br />
Credentials.Password = _pwd;<br />
jerWs.AuthHeaderValue = Credentials;<br />
string token = jerWs.GetAuthenticationToken(stringId, xml.ToString());
3.0. XML<br />
La struttura degli xml è identica per ogni tipologia <strong>di</strong> informazione che si vuole visualizzare.<br />
All’interno del tag si dovrà specificare il valore del parametro UC e client.<br />
Dove l’UC riconosce la tipologia <strong>di</strong> informazione che vogliamo visualizzare mentre il client è l’utente che sta lanciando<br />
l’applicazione.<br />
Nei tag si dovranno specificare rispettivamente i co<strong>di</strong>ci BDRT <strong>di</strong> marca modello e<br />
versione.<br />
UC<br />
Cinghie<br />
DTC<br />
InfoChiavi<br />
Pneumatici<br />
SpieService<br />
InfoTecniche<br />
Descrizione<br />
Permette <strong>di</strong> accedere alle informazioni<br />
sulle cinghie dei veicoli<br />
Permette <strong>di</strong> accedere alle informazioni<br />
sulla programmazione delle chiavi<br />
Permette <strong>di</strong> accedere alle informazioni<br />
sui pneumatici dei veicoli<br />
Permette <strong>di</strong> accedere alle informazioni<br />
sulle spie dei veicoli<br />
Permette <strong>di</strong> accedere a una serie <strong>di</strong><br />
informazioni sui veicoli