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 Tipologia Campo Lunghezza Campo Ammessa Obbligatorio   Tratta-progetto Testo 600 SI   CNO Testo   SI quale nomenclatura verrà usata? GISFO/PNI  o P+/G4W? (A475_CNO1 o CNO1) Lavorazioni Testo   SI   Note Lavorazioni Testo   NO   Data GL Date   SI   Stato Cantiere Testo   SI   Motivo (Stato Cantiere: Non Attivo) Testo   NO   Meteo Testo   SI   Presenza Archeologo Bool   SI se nullService per noigestire ètutte 'NO'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

OreViceversa, lavorateGisFo Archeologodovrà esporre un Web Service volto alla ricezione delle giornate lavori inviate da XME, ossia:

Intero

• WS2

da SIGisFo sea presenzaXME archologoper 'SI'Ricezione ed Esito GDL 

NomeSuccessivamente Lavoratore

si Testodescrivono 100nel SIdettaglio le mimiche, la struttura Cognomee Lavoratorele Testomodalità 100di SIgestione degli errori di ciascun CodiceWeb fiscaleService. LavoratoreAlla Testofine 100del SIcapitolo sono riepilogati i possibili Impresa esecutrice Lavoratore Testo   SI chiarireerrori con XMErelativo se su base testo o su base id numerico Qualifica Lavoratorecodice. Testo   SI   Tipologia Lavoratore Testo   SI   Ore lavorate Lavoratore Intero   SI  

WS1 per Invio dati Giornale Lavori

Per ogni transazione, si avrà una comunicazione sul WS 1 a seguito della richiesta dell'operatore, evento che definisce la data di inizio Transazione.
Il WS esposto sarà di tipo RESTful, metodo HTTP POST, raggiungibile tramite il seguente URL:

La struttura dell’oggetto json inserito nel body dell'invio del WS 1 dovrà essere analoga alla seguente:

{
    "id_transaction":1234,
    "tratta_g4w": [ 
        {
            "nome_tratta": "ABI2ARIELLI00000",
            "giornate":[
                {
                    "data_gl": "2023-02-06",
                    "stato_cantiere":"Attivo",
                    "motivo_stato_cantiere": null,
                    "meteo": "Sereno",
                    "presenza_archeologo": true,
                    "ore_lavorate_arch": 1.5,
                    "cno":[
                        {
                            "nome_cno": "CNO1",
                            "lavorazioni":[
                                    {
                                        "lavorazione": "Minitrincea",
                                        "note_lavorazione": "Via Poggibonsi",
                                    }
                            ]
                        }
                    ],
                    "lavoratori":[
                            {
                                "nome":"Federico",
                                "cognome":"Rossi",
                                "cod_fisc":"FRTRSS90M111L",
                                "impresa":"12339760964",
                                "dettagli_lavoratore":[
                                    {
                                        "qualifica_lavoratore": "Operaio Comune",
                                        "tipologia_lavoratore": "Distacco",
                                        "ore_lavorate": 8
                                    }
                                ]
                            }
                    ]
                }
            ]
        }
    ]
}

  Tipologia Campo Lunghezza Campo Ammessa Obbligatorio Tratta-progetto Testo 600 SI CNO Testo   SI Lavorazioni Testo   SI Note Lavorazioni Testo   NO Data GL Date   SI Stato Cantiere Testo   SI Motivo (Stato Cantiere: Non Attivo) Testo   NO Meteo Testo   SI Presenza Archeologo Bool   NO Ore lavorate Archeologo Intero   SI se presenza archologo 'SI' Nome Lavoratore Testo 100 SI Cognome Lavoratore Testo 100 SI Codice fiscale Lavoratore Testo 100 SI Impresa esecutrice Lavoratore Testo   SI Qualifica Lavoratore Testo   SI Tipologia Lavoratore Testo   SI Ore lavorate Lavoratore Intero   SI

Per la parte riguardante la presenza archeologo, il controllo sarà tale che in caso il campo sia null GisFo compilerà il campo con NO.

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.

 

 

 Verranno eventualmente aggiunti gli errori previsti da Geo4Wip in risposta alle Richieste provenienti da GISFO.