| Info |
|---|
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 Overzicht uitzonderingen MAGDA 2.0 Webserviceswebservices
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.
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<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.
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<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.
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<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
| Code Block | |
|---|---|
| language | xml |
| title | Fout XXXXX |
| linenumbers | true | collapse | true
uOp deze pagina
| Table of Contents | ||
|---|---|---|
|
Binnen deze handleiding
| Page Tree | ||
|---|---|---|
|