| 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 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. |
Overzicht mogelijke annotaties
Identificatie | Niveau | Omschrijving |
10001 | 1 | Fout formaat in de vraag (XML validatie) + reden · De doorgestuurde xml is niet geldig tegenover het afgesproken xsd schema |
13001 | 2 | Geen machtiging van de afzender in deze hoedanigheid voor de gevraagde dienst · Controleer dienstnaam, dienstversie, afzender identificatie en hoedanigheid |
13101 | 2 | Combinatie van vraagelementen niet toegelaten of bepaald element niet aanwezig |
13202 | 3 | Gegevens niet opvraagbaar, geen persoonsdossier geregistreerd · Maak een inschrijving aan voor de persoon in kwestie (dienst BeheerInschrijving) |
99993 | 3 | Fout formaat in de vraag naar businessdienst toe (XML validatie) · Neem contact op met de toepassingsmanager van Corve |
99994 | 2 | Onverwachte fout bij de bron · Neem contact op met de toepassingsmanager van Corve |
99995 | 2 | Te veel gelijktijdige bevragingen · Verminder het aantal gelijktijdige bevragingen |
99996 | 2 | Bron is tijdelijk niet beschikbaar · Probeer na enige tijd opnieuw, indien de fout zich blijft voordoen neem dan contact op met de toepassingsmanager van Corve |
99997 | 2 | Kan antwoord van bron niet interpreteren · Neem contact op met de toepassingsmanager van Corve |
99998 | 2 | Fout bij XML validatie antwoord · Neem contact op met de toepassingsmanager van Corve |
99999 | 2 | Onverwachte fout, contacteer VIP · Neem contact op met de toepassingsmanager van Corve |
[1] Soap Fault
Voorbeeld
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 | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
uOp deze pagina
| Table of Contents | ||
|---|---|---|
|
Binnen deze handleiding
| Page Tree | ||
|---|---|---|
|