Versions Compared

Old Version 4

changes.mady.by.user Jasper Missinne

Saved on

compared with

New Version Current

changes.mady.by.user Bert Van Kets

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Info

Informatie:

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:Image Removed

Image Added

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

.

xmllinenumberstrue
Code Block
language
Expand
titleFout tegen xsd (ongeldig INSZ)
Code Block
language
xml
<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

.

languagelinenumberstrue
Code Block
Expand
xmltitleTe veel bevragingen
Code Block
language
xml
<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

.

xmllinenumberstrue
Code Block
language
Expand
titleUitzonderingen: Inschrijvingscontrole
Code Block
language
xml
<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
languagexml
titleFout XXXXX
linenumberstrue
collapsetrue
uOp

Op deze pagina

Table of Contents
maxLevel2
minLevel1

Binnen deze handleiding

Page Treeroot@parent

Child pages (Children Display)
pageLED.RegistreerMutatieBewijs-02.00
Info

Met vragen kunt u steeds terecht bij de MAGDA Service Desk.