UpdateState() metod
Akcija
Metod prihvata isključivo JSON-formatiranu listu elemenata tipa klasa Message i upisuje podatke u bazi menjajući joj stanje. Koristi se za evidenciju aktivnosti servisera.
Sintaksa
HttpResponseMessage UpdateState(List<Message> stateMsg)
Rezultat
Metoda vraća HttpResponseMessage čiji je sadržaj HttpStatus kod za “Created” i JSON-formatirana lista dinamičkih objekata (definisanih u toku kompajliranja) koji predstavljaju rezultate transakcija. Jedan rezultat transakcije je ili null (prazan), ako je akcija vezana za Servisni nalog uspela, ili JSON-formatirani Error string u obliku {“ErrID”:kod_greške,“SerID”:ID_dokumenta}, u slučaju da zahtev za traženom akcijom nije obradjen. Specijalno, vraćaju se 2 greške bez errID, a samo sa tekstualnim porukama, kada:
1. primljeni JSON ne odgovara modelu, tj. klasi Message (HTTP error code za Bad Request) i
2. korisnik nije autorizovan za korišćenje tražene funkcije servera (HTTP error code za Unauthorized).
Error čvor
U slučaju da zahtev ne može biti procesiran, vraća se JSON sa dva čvora:
{“ErrID”:kod_greške,“SerID”:ID_dokumenta_kod_kojeg_se_javila_greška}
Poznati kodovi grešaka i značenje:
| ErrID | Objašnjenje |
|---|---|
| 1 | Greška pri povezivanju sa bazom podataka ili pri izvršenju upita |
| 10 | Dokument već označen kao prihvaćen |
| 20 | Dokument već označen kao započet |
| 30 | Dokument već označen kao završen |
| 35 | Loša šifra za DocStatus (110 i 120 su dozvoljene vrednosti) |
| 40 | Dokument već označen kao odbijen |
| 50 | Dokument već označen kao otkazan |
| 60*) | Serijski broj nije prepoznat |
| 100 | Loša šifra HttpPost Akcije (1, 2, 3, 4 i 5 su dozvoljene vrednosti) |
Parametri
| Naziv | Vrsta | Opis |
|---|---|---|
| stateMsg | Message | Element tipa klase Message formatiranih kao JSON sa podacima o zahtevanim akcijama (izmenama podataka) |