Op deze pagina kan meer uitleg worden gegeven in verband met uitzonderingen die de dienst kan teruggeven aan de afnemer. Het sjabloon voorziet een tabel voor foutcodes en ruimte voor algemene informatie i.v.m. uitzonderingen. Algemene opmerking: Om het doorzoeken van de Wiki te bevorderen is het good practice om de foutcodes als label toe te voegen.
Informatie:Voor meer informatie rond de werking van Uitzonderingen in MAGDA 2.0 diensten, zie Werking en overzicht uitzonderingen. |
Algemeen
De Uitzonderingen-node is een generieke node die ook op andere niveau’s kan voorkomen (zie algemene MAGDA 2.0 documentatie). In dit hoofdstuk worden alleen de uitzonderingen toegelicht die op ANTWOORD niveau kunnen voorkomen en voortspruiten uit de validering en de (poging tot) verwerking van de VRAAG.
De MAGDA Uitzonderingen node heeft steeds dezelfde structuur:
Uitzonderingen node | Omschrijving | |||||
|---|---|---|---|---|---|---|
Uitzonderingen | Dit element komt enkel terug wanneer de verwerking niet geslaagd is vanwege validatiefouten in het Verzoek of de Vraag | |||||
Uitzondering | ||||||
Identificatie | Code die de uitzondering op unieke wijze identificeert | |||||
Oorsprong | Geeft aan wie de fout detecteerde (MAGDA, DOSIS, …) | |||||
Type | Code die aangeeft hoe ernstig de uitzondering is (FOUT, WAARSCHUWING of INFO) | |||||
Tijdstip | Tijdstip dat aangeeft wanneer de uitzondering is opgetreden | |||||
Datum | Datum identificatie in YYYY-MM-DD formaat | |||||
Tijd | Tijdsindicatie in HH:MM:SS.sss formaat | |||||
Diagnose | Bevat de tekstuele omschrijving van de uitzondering | |||||
Omstandigheid | Beschrijving van het deel van de VRAAG waar de uitzondering is opgetreden | |||||
Annotaties | Annotaties zijn dienst-specifiek en bevatten bijkomende informatie in de vorm van een <Naam> en een <Waarde> element. Deze dienst maakt geen gebruik van annotaties | |||||
Annotatie | ||||||
Naam | ||||||
Waarde | ||||||
Aangezien de GeefEPC-dienst geen inhoudelijke validaties uitvoert, is de lijst van mogelijke uitzonderingen die hieronder worden opgelijst beperkt. De echte inhoudelijke validaties worden teruggekoppeld vanuit VEA.
Wat betreft de Uitzonderingen wordt dezelfde werking gevolgd als de overige MAGDA-webservices.
De generieke foutcode zijn te vinden op Overzicht uitzonderingen MAGDA 2.0 webservices.
Overzicht dienst-specifieke uitzonderingen
Deze uitzonderingen zijn steeds dienst specifiek en op niveau 3.
Identificatie | Diagnose | Oorsprong |
|---|---|---|
10501 | Fout formaat in de vraag (XSD validatie) | VEA |
30001 | Geen gegevens gevonden voor de vraag | VEA |
60008 | Fout bij validatie antwoord (XSD validatie) | VEA |
60009 | Er heeft zich een interne fout voorgedaan | VEA |