Voor meer informatie rond de werking van Uitzonderingen in MAGDA 2.0 diensten, zie Werking en overzicht uitzonderingen
Algemeen
In bepaalde omstandigheden kan het zijn dat de dienst een uitzondering (of meerdere uitzonderingen) teruggeeft.
In het kort kunnen er binnen deze dienst uitzonderingen terugkomen op drie niveaus
- Niveau 1: typisch zal dit voorkomen bij een fout tegenover de xsd
- Niveau 2: voornamelijk op het niveau van autorisatie (context)
- Niveau 3: voornamelijk uitzonderingen door de achterliggende dienst, voorbeeld “geen gegevens gevonden”, “onverwachte fout”, … of door specifieke controle op de vraaggegevens.
Een uitzondering omvat:
Wat betreft de Uitzonderingen wordt dezelfde werking gevolgd als de overige MAGDA-webservices.
De generieke foutcode zijn te vinden op Werking en overzicht uitzonderingen MAGDA 2.0 Webservices
Elementen
Element | Omschrijving |
|---|---|
Identificatie | Verplicht. Maxlengte 10. De uitzonderingscode. |
Oorsprong | Minlengte 1, maxlengte 5. Duidt de bron aan van de uitzondering (Altijd MAGDA) |
Type | Mogelijke waardes: · FOUT · WAARSCHUWING · INFORMATIE |
Tijdstip | Optioneel, indien aanwezig zijn Datum en Tijd beide aanwezig. · Datum: formaat jjjj-mm-dd · Tijdstip: formaat uu:mm:ss.sss |
Diagnose | Verplicht. De tekstuele omschrijving van de opgetreden uitzondering. |
Omstandigheid | Optioneel. Wordt veelal gebruikt om de foutcode van de bron door te geven of voor meer informatie te geven met betrekking tot de uitzondering. |
Annotatie | Optioneel, meerdere mogelijk. Is opgebouwd uit een naam/waarde-paar. Wordt in de RegistreerMutatiebewijs 02.00 niet gebruikt. |
Voorbeelden
Uitzondering op niveau 1.
<soap:Fault> <faultcode>Server</faultcode> <faultstring>10001 Fout formaat in de vraag (XSD validatie). Fout: error: cvc-datatype-valid.1.1: string value 'xxxxxxxxxxx' does not match pattern for INSZType in namespace http://generiek-01_02.vip.vlaanderen.be</faultstring> <detail> <ns1:VIPDienstException xmlns:ns1=" http://webservice.registreermutatiebewijsdienst-02_00.led-02_00.vip.vlaanderen.be " /> </detail> </soap:Fault>
Uitzondering op niveau 2.
<Uitzonderingen> <Uitzondering> <Identificatie>99995</Identificatie> <Oorsprong>MAGDA</Oorsprong> <Type>FOUT</Type> <Tijdstip> <Datum>2011-03-10</Datum> <Tijd>09:32:39.570</Tijd> </Tijdstip> <Diagnose>Te veel gelijktijdige bevragingen</Diagnose> </Uitzondering> </Uitzonderingen>
Uitzondering op niveau 3.
<Uitzonderingen> <Uitzondering> <Identificatie>13202</Identificatie> <Oorsprong>MAGDA</Oorsprong> <Type>FOUT</Type> <Tijdstip> <Datum>2011-03-10</Datum> <Tijd>09:32:39.570</Tijd> </Tijdstip> <Diagnose>Gegevens niet opvraagbaar, geen persoonsdossier geregistreerd</Diagnose> </Uitzondering> </Uitzonderingen>
Overzicht mogelijke annotaties
uOp deze pagina
Binnen deze handleiding
