DIGITAAL VLAANDEREN
Beschrijving Antwoord - GeefMutatiesNotificaties-02.01
- Bert Van Kets
- Pedro Devogelaere (Deactivated)
- Paulin Van Biesen
XSD Visueel
Detail
Opmerking:
Het antwoord bestaat standaard uit Context, Referte en Antwoord zoals beschreven in het document Gebruik Magda Webservices 02.00. Verder zal enkel aandacht besteed worden aan het specifieke Antwoord element.
Antwoord in detail
Element Notificatie/ | Opmerkingen | |
|---|---|---|
Referte | Unieke referte per notificatie | |
Subject | Het subject dat gewijzigd is | |
Type | Aanduiding welk soort sleutel vb OND, PERS, …. Zie bron specifieke bijlage | |
Sleutel | De feitelijke sleutel. Zie bron specifieke bijdrage | |
Soort | De soort van mutatie vb “annulatie”, “nieuw”, “wijziging”. Zie bron specifieke bijlage | |
Tijdstip | Datum en tijdstip van mutatie | |
Datum | Datum van mutatie. Formaat: jjjj-mm-dd | |
Tijd | Tijdstip van mutatie. Formaat: HH:MM:SS.sss | |
Bron | Bron die de mutatie registreert. Zie bron specifieke bijlage | |
Informaties | Oplijsting van de gegevens die gewijzigd zijn | |
Informatie | De feitelijke gegevens van de notificatie. Zie bron specifieke bijlage | |
Voorbeeld
Voorbeeld
Opvraging cases
Initiële opvraging
Op het moment dat de afnemer beslist om de voor hem beschikbare mutatienotificaties op te halen moet bij de eerste keer dat de webservice wordt aangeroepen, de opvraging gebeuren zonder ontvangstreferte. Dit is logisch daar er nog geen ontvangstreferte gekend is. In het antwoord worden de eerste beschikbare mutatienotificaties teruggegeven alsook een ontvangstreferte.
Voorbeeld op Testgegevens & Voorbeelden - GeefPublicatieNotificatie-02.01
Opvraging bij gegevens in antwoord
Bevinden zich in het antwoord gegevens (dus minstens één MutatieNotificatie), dan moet de volgende opvraging met de in dat antwoord ontvangen ontvangstreferte uitgevoerd worden. Door het opgeven van de ontvangstreferte bevestigt men de goede ontvangst en verwerking van de gegevens en verkrijgt men de volgende set van gegevens.
De ontvangstreferte in het antwoord dient gebruikt te worden in de volgende vraag.
Voorbeeld op Testgegevens & Voorbeelden - GeefPublicatieNotificatie-02.01
Opvraging na ‘geen verdere gegevens beschikbaar’ (30016)
Bevat het antwoord uitzondering 30016 ‘geen verdere gegevens beschikbaar’, dan zijn alle op dat moment te verdelen mutatienotificaties doorgegeven. De volgende keer dat er dan mutatienotificaties worden opgevraagd, dient de vraag gesteld te worden zonder ontvangstreferte. Er kan immers geen ontvangstreferte opgegeven worden daar er geen ontvangst van gegevens te bevestigen is. Er bevonden zich namelijk geen gegevens in het vorige antwoord, noch een ontvangstreferte.
Voorbeeld op Testgegevens & Voorbeelden - GeefPublicatieNotificatie-02.01
Zie ook de uitzonderingen op Uitzonderingen - GeefMutatieNotificatie-02.01
Opvraging na foutieve verwerking of niet correcte ontvangst
Er kunnen zich in dit proces een drietal probleemscenario’s voordoen :
De afnemer heeft een probleem gekend met de verwerking van de mutatienotificaties en heeft MAGDA geen ontvangstbevestiging kunnen bezorgen.
De ontvangstbevestiging van de afnemer is niet toegekomen bij MAGDA. Bijgevolg heeft MAGDA de ontvangstbevestiging niet kunnen verwerken en heeft de afnemer dus ook geen antwoord gekregen.
De ontvangstbevestiging werd goed ontvangen, maar het daaropvolgende antwoord van MAGDA is niet toegekomen bij de afnemer.
Was er tijdens de verwerking van de gegevens of de ontvangst ervan een probleem, dan kan men de gegevens opnieuw opvragen. In dat geval wordt er een nieuwe vraag gesteld zonder ontvangstreferte.
In deze gevallen zal het antwoord bestaan uit de reeds doorgestuurde mutatienotificaties tezamen met de melding dat deze al reeds doorgegeven werden maar nog niet bevestigd. Een ontvangstreferte is eveneens ook aanwezig
In de volgende vraag dient de verkregen ontvangstreferte dan terug opgenomen te worden.
Voorbeeld op Testgegevens & Voorbeelden - GeefPublicatieNotificatie-02.01
Opvraging na archivering
Digitaal Vlaanderen is in de mogelijkheid gearchiveerde mutaties terug beschikbaar te stellen. Dit natuurlijk enkel indien de gevraagde mutaties nog beschikbaar zijn op het MAGDA platform. Na enige tijd worden deze namelijk verwijderd. Om mutaties terug beschikbaar te maken moet er contact opgenomen worden met de MAGDA helpdesk. Zie Contact opnemen met de MAGDA helpdesk
Van zodra Digitaal Vlaanderen bevestigd heeft dat de gevraagde mutaties terug beschikbaar zijn, kunnen deze als volgt opgehaald worden:
voer een vraag uit zonder Als antwoord worden de oudst beschikbare mutaties verkregen, dit zijn de terug beschikbaar gestelde gearchiveerde mutaties. Het antwoord bevat een ontvangstreferte en de melding dat deze gegevens al opgehaald werden maar nog niet bevestigd (Uitzondering 30017).
volg het proces zoals beschreven in ‘Opvraging bij gegevens in antwoord’. Zolang het antwoord de beschikbaar gestelde gearchiveerde mutaties bevat, blijft de melding komen dat deze gegevens reeds opgehaald waren maar nog niet bevestigd.
Voorbeeld op Testgegevens & Voorbeelden - GeefPublicatieNotificatie-02.01
Opvraging met foutieve ontvangstreferte
Wordt er een opvraging uitgevoerd met een foutieve ontvangstreferte, dan bevat het antwoord een uitzondering 30014. Het antwoord bevat geen ontvangstreferte. Bijgevolg, de volgende vraag gebeurt zonder ontvangstreferte. Het antwoord zal dan de vorige opgevraagde mutaties bevatten, met een ontvangstreferte en met de melding dat deze mutaties al opgevraagd waren. De volgende vraag gebeurt dan terug met de ontvangen ontvangstreferte.
Voorbeeld op Testgegevens & Voorbeelden - GeefPublicatieNotificatie-02.01
Zie ook de uitzonderingen op Uitzonderingen - GeefMutatieNotificatie-02.01
Op deze pagina
Binnen deze handleiding
Met vragen kunt u steeds terecht bij de MAGDA Service Desk.
Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren
De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid
uitgegeven door Digitaal Vlaanderen