Protocollo di comunicazione Preventivo di meccanica

Protocollo di comunicazione
di Infocar-Repair Preventivo di Meccanica
MANUALE DI UTILIZZO
a cura di Quattroruote Professional
Redatto Versione Data
Gabriele Bonanomi V.1.0 03/07/2012
Gabriele Bonanomi v.2.0 11/10/2012
Gabriele Bonanomi v.2.1 11/10/2012
Gabriele Bonanomi v.2.2 16/10/2012
Gabriele Bonanomi v.3.0 19/10/2012

Obiettivo del documento
Definizione delle linee guida di comunicazione con il preventivo di meccanica di InfocarRepair.
L’applicazione del preventivo riceverà in ingresso le informazioni relative all’azienda, al veicolo e al cliente e fornirà
in uscita il risultato del processo di stesura di un preventivo di meccanica.
Schema di flusso
Schema:
Il flusso di comunicazione coinvolge 3 applicazioni:
- Chiamante (in questo caso iRelief).
- Gateway di autenticazione.
- WEBApp Preventivo di meccanica.
Il chiamante esegue una richiesta al gateway autenticandosi e inviando un file xml di specifica della richiesta.
Il gateway dopo aver effettuate le verifiche della richiesta e se tutto è corretto restituisce un token.
Il chiamante contatta la WEBApp (in questo caso il preventivo di meccanica).
Alla fine del processo, il preventivo di meccanica invocherà un metodo del webservice del chiamante (dichiarato
nell’xml della richiesta) fornendogli l’output e ridirigerà la “navigazione” verso al pagina del chiamante (dichiarata
nell’xml della richiesta).
Dettagli tecnici:
Di seguito definiamo quali sono in dettaglio i parametri di configurazione per la chiamata alla WEBApp del
preventivo di meccanica.
1) Lo schema dell’xml di input può essere di 4 tipi:
UC Descrizione XML
UC00 Creazione di un preventivo non mostra ricambi alternativi
UC00Input.xml
UC01
Modifica di un preventivo di meccanica non mostra ricambi alternativi
UC01Input.xml

UC08
Richiesta di stampa Preventivo Base
UC08Input.xml
UC09
Richiesta dell’xml contenente tutte le informazioni del preventivo
UC09Input.xml
Note:
• per UC08 il valore del nodo attualmente può essere esclusivamente “Preventivo_base”.
• L’attributo portal, presente all’interno del nodo di root, definisce il prodotto. Attualmente i valori possibili
sono 2: “prod0” Preventivo senza scelta ricambi alternativi e Preventivo con scelta dei ricambi alternativi,
codificato con la stringa “prod1”. A breve tali codifiche saranno modificate, sarà nostra premura comunicare
le eventuali modifiche.
2) Il Gateway da chiamare per l’autenticazione è il seguente:
http://www.infocar-repair.it/Jestimate_Gateway/PersistentrequestService.asmx
Il WebMethod è GetAuthenticationToken.
3) L’URL del Preventivo di meccanica di InfocaRepair è
http://www.infocar-repair.it/IR_Preventivo/Startup.aspx?token=
4) Gli xml di output, previsti per i 4 use case, sono così definiti:
UC00Output.xml UC01Output.xml UC08Output.xml UC09Output.xml
Note implementative
Viene riportato qui sotto una porzione di codice C# per l’autenticazione al Gateway come esempio:
JEGateway_Request.PersistentRequestService jerWs = new JEGateway_Request.PersistentRequestService();
string _username = "******@*****.***";
string _pwd = "******";
JEGateway_Request.AuthHeader Credentials = new JEGateway_Request.AuthHeader();
Credentials.UserName = _username;
Credentials.Password = _pwd;
jerWs.AuthHeaderValue = Credentials;
string token = jerWs.GetAuthenticationToken(stringId, xml.ToString());
Username e password saranno forniti separatamente.
Il webServer di Response deve implementare l’interfaccia
http://www.infocar-repair.it/Jestimate_Gateway/PersistentResponseService.asmx?wsdl
in particolare sarà compito del chiamante ridefinire il webMethod SetClientDataByApplicationID affinché salvi su
file l’xml restituito. Si tenga presente che il parametro “token” del metodo contiene il valore del token restituito dal
Gateway.