13.02.2018 Views

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

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!