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 bevat volgende elementen:

Wat betreft de Uitzonderingen wordt dezelfde werking gevolgd als de overige MAGDA-webservices.

Elementen

Element	Omschrijving
Identificatie	Verplicht. Maxlengte 10. De uitzonderingscode.
Oorsprong	Minlengte 1, maxlengte 5. Duidt de bron aan van de uitzondering (MAGDA of LED)
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 RegistreerBewijs 02.00 niet gebruikt.

Deze uitzonderingen zijn steeds dienst specifiek en op niveau 3.

Identificatie	Type	Toelichting	Oorsprong