Gegarandeerde Aflevering
p. 2 Referte : unieke identificatie van berichten, vragen en antwoorden Vraag / Antwoord : De afzender dient voor elke vraag een unieke referte te versturen. Deze wordt bij het antwoord terug gegeven opdat het mogelijk is vraag en antwoord te correleren. HTTP(S) is geen gegarandeerd protocol dus … –Het bericht werd verwerkt, de gevraagde acties werden uitgevoerd, maar er loopt iets mis bij het versturen van het antwoord –Het bericht is niet correct aangekomen bij de ontvanger en werd niet verwerkt … voor de afzender is er geen zekerheid of de berichten werden verwerkt –Vraagrefertes die bij de originele vragen werden gebruikt, MOETEN opnieuw als vraagreferte opgegeven worden –Het is niet noodzakelijk om de vragen in een identiek bericht te sturen Gegarandeerde Aflevering
p. 3 Niet Gesplitst Gesplitst VerwerktNiet Verwerkt Gegarandeerde aflevering
CRUD Patronen
p. 5 Object: Een object bestaat steeds uit volgende elementen. ObjectID: Deze referentie is uniek voor elk object en wordt aangemaakt door O&V. Objectelementen: Dit zijn de elementen die een bepaald object beschrijven. Referenties: Referenties die naar andere objecten verwijzen CRUD Terminologie
p. 6 Het aanmaken van een object vereist steeds het versturen van het aan te maken object: Verplicht op te nemen: Objectelementen, Referenties Mag niet opgenomen worden: ObjectID Het antwoord bevat de referentie (ObjectID) die werd aangemaakt voor het object. De instelling dient deze referentie te bewaren zodat bij latere vragen in verband met dit object deze referentie kunnen gebruiken. Indien de aanmaak niet kon verwerkt worden, wordt dit aangegeven door een Uitzondering en zal er geen Inhoudelement zijn. CRUD Patronen : Aanmaak
p. 7 Als een instelling een object, dat eerder werd aangemaakt, wil raadplegen, dient het de door O&V aangemaakte referentie (ObjectID) te versturen via het vraagelement. O&V stuurt de volledige inhoud van het object via het antwoord terug. Indien het object niet gevonden wordt, zal enkel een uitzondering worden meegegeven CRUD Patronen : Raadpleeg
p. 8 Bijna identiek met Aanmaken, op ObjectID na Voor het wijzigen van een object dient men het object dat men wil wijzigen in zijn volledigheid te versturen: de ObjectID, alle objectelementen (zowel de gewijzigde als de niet gewijzigde) en alle referenties. In het antwoord staat het ObjectID, puur ter bevestiging van de succesvolle verwerking. Indien de wijziging niet kon verwerkt worden, wordt dit aangegeven door een Uitzondering en zal er geen Inhoudelement zijn. CRUD Patronen : Wijzig
p. 9 Voor het verwijderen dient enkel het ObjectID meegegeven te worden. Het antwoord bevat het ObjectID ter bevestiging van de verwerking terug. Ook hier zal bij een fout een uitzondering verstuurd worden in plaats van de inhoud. CRUD Patronen : Verwijder
Volgende stappen
p. 11 Uitklaren veranderingen t.o.v. DHO Afstemming met MAGDA binnen Vlaamse overheid Communiceren Certificaten Besprekingen aan de gang om af te stappen van commerciële certificaten Testomgeving Hergebruik of nieuwe … Volgende stappen
Vragen ? Dirk Vanderlooven