6. Implementazione dei WS GISFO-XME e XME-GISFO
due nuovi WS: WS1 da GISFO a XME per chiedere le giornate, WS2 da XME a GISFO per inviare le giornate
Come anticipato, sarà necessario implementare una serie di Web Service per gestire tutte le comunicazioni da GisFo a XME e viceversa. In particolare, XME dovrà esporre un Web Service volto all' invio dei dati relativi alle giornate lavori e alle tratte da inserire in modo automatico :
- WS1 da XME a GisFo per invio dati
Viceversa, GisFo dovrà esporre un Web Service volto alla ricezione delle giornate lavori inviate da XME, ossia:
- WS2 da GisFo a XME per Ricezione ed Esito GDL
Successivamente si descrivono nel dettaglio le mimiche, la struttura e le modalità di gestione degli errori di ciascun Web Service. Alla fine del capitolo sono riepilogati i possibili errori con relativo codice.
WS2
{ "id_transaction":1234, "tratta_g4w": [ { "nome_tratta": "ABI2ARIELLI00000" , "esito_tratta": "KO", "giornate":[ { "data_gl": "2023-02-06", "esito": "OK", "motivazione": "" } { "data_gl": "2023-02-07", "esito": "OK", "motivazione": "Inserimento mezzi" } { "data_gl": "2023-02-08", "esito": "KO", "motivazione": "Superamento ore Lavoratore,Ore Archeologo non compatibili,ecc" } { "data_gl": "2023-02-09", "esito": "Non Inserito", "motivazione": "Giornata presente e approvata DL" } ] } ]}
5.6 Elenco codici errore previsti
A valle della descrizione dei singoli Web Service, si riepiloga nella seguente tabella l’elenco dei possibili errori previsti in risposta alle comunicazioni ricevute da Geo4Wip.
error_code |
error |
|
ERR_WORKORDER_NOTFOUND |
identificativo progetto non presente sul sistema |
|
ERR_INVALID_FIELD |
formato non valido/campo obbligatorio mancante per il campo nomecampo |
|
ERR_INVALID_VALUE |
valore non ammesso per il campo nomecampo |
|
ERR_UNEXPECTED_EVENT |
notifica non coerente con il flusso |
|
ERR_REQUESTID_NOTFOUND |
identificativo richiesta idrichiesta non presente a sistema |
|
ERR_UNEXPECTED_DATE |
nomecampodata non coerente con i dati a sistema |
|
ERR_GENERIC |
errore generico |
Verranno eventualmente aggiunti gli errori previsti da Geo4Wip in risposta alle Richieste provenienti da GISFO.