Doel: Met dit sjabloon kan u eenvoudig een nieuwe diensthandleiding aanmaken in Confluence. Gebruik de onderstaande knoppen om nieuwe componenten binnen de handleiding aan te maken. To do: - Vul de onderstaande handleidingsparagrafen in - Maak o.b.v. de specificaties van de dienst relevante subpagina's aan - Verwijder lege of niet-gebruikte paragrafen & pagina's - Let op: Gebruik de volledige naam van de dienst (Domein.DienstNaam-Versie).

De Excerpt bevat de tekst die wordt weergegeven in de overzichtspagina op domein niveau. De tekst die in dit kader staat wordt niet weergegeven in de handleiding zelf (deze pagina) en dient een korte omschrijving van de dienst te bevatten.

Situering

Deze dienst maakt deel uit van een set LED diensten die via het MAGDA platform beschikbaar zijn. Het betreft hier een pure MAGDA Gateway op een bij LED beschikbare MAGDA 2.0 compliant businessdienst.

Het doel van het LED project is het bouwen van een authentieke gegevensdatabank met informatie over leer- en ervaringsbewijzen. Deze databank zal gevoed kunnen worden door (al dan niet) authentieke bronnen die op de centrale databank zijn aangesloten en kunnen worden bevraagd door gemachtigde belanghebbenden. De nood aan een dergelijke databank kwam onder meer naar boven in het beleidsdomein O&V in het kader van de financiering van het leerplichtonderwijs.

Verwante diensten

RegistreerBewijs: Dienst enkel beschikbaar voor de instanties die een LED bewijs uitreiken. Deze dienst laat deze instanties toe een bewijs te registreren in de LED.

GeefBewijs: Dienst voor het opvragen van een LED Bewijs, dit op basis van het actuele INSZ van de persoon.

RegistreerMutatieBewijs: Dienst enkel beschikbaar voor de LED zelf. Deze dienst laat LED toe een gemuteerd LED bewijs te registreren op het MAGDA platform voor verder verdeling naar de gemachtigde afnemers.

PubliceerBewijs: Dienst voor het verkrijgen van de gemuteerde bewijzen.

Gegevensbronnen

De gegevens worden verwijderd bij volgende (authentieke) gegevensbron(nen):

• LED – Leer- en Ervaringsdatabank

Gebruiksvoorwaarden

Om gebruik te kunnen maken van deze dienst dient men een machtiging te hebben die toegang geeft tot deze gegevens en een aansluitingsprocedure te doorlopen.

Batch

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML).

Hiervoor moet men de Service-XSD gebruiken en niet de Webservice. Door de Service-XSD te gebruiken zijn er meerdere vragen mogelijk in één bestand. De vraag-bestanden worden op de MAGDA FTP geplaatst in een afnemer specifieke folder. De exacte bestandsnamen en de naam van de folder worden meegedeeld tijdens het aansluitingsproces. Deze is steeds onder de vorm LED.AnnuleerBewijs-0200_timestamp.xml.

Voorbeeld: LED.AnnuleerBewijs-0200_20131103115553530.xml

Voor meer informatie: Webservice In Batch bevragen.

Functionaliteiten

Ruimte voor een korte beschrijving van de functionaliteiten van deze dienst voor zover die relevant zijn?

Vraag

Zie Beschrijving Vraag (AnnuleerBewijs-02.00).

Antwoord

Indien de annulering van het bewijs is geslaagd, zult u in het antwoord “OK” ontvangen bij het element “Melding”. Zie Beschrijving Antwoord (AnnuleerBewijs-02.00).

Indien de annulering niet is geslaagd, zult u een uitzondering ontvangen, zie Uitzonderingen (AnnuleerBewijs-02.00).

Werking

Opvraging

Hoe bouwt deze dienst haar antwoord op?

Responsetijden & Beschikbaarheid

De beschikbaarheid van de dienst staat beschreven in het MAGDA richtlijnen document.

De MAGDA response tijden zijn heel sterk afhankelijk van de response tijden van de bron. Als de brongegevens heel traag worden aangeleverd kan het MAGDA antwoord niet snel worden aangeleverd. Responsetijden tussen de 500ms en 10 seconden worden als normaal beschouwd.

Logging

De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".

Ondersteunde talen

De afnemer verwacht vanuit een MAGDA-dienst een Nederlanstalig antwoord. Wanneer een antwoord mogelijk anderstalige informatie bevat is het relevant om dit hier mee te geven.

MAGDA ondersteunt de Nederlandse taal.

Indien in de brongegevens de Nederlandse tekst niet beschikbaar is voor een bepaald element zal de eerste vertaling van de tekst in de brongegevens gebruikt worden, onafhankelijk van de taal waarin dit gegeven beschikbaar is.