Onderwijs.GeefHistoriekInschrijving-02.01
Informatie:
Voor de ontsluiting van een MAGDA 2.0 webservice, alsook het generieke proces binnen een 2.0 webservice, wordt verwezen naar Werking en gebruik MAGDA 2.0 Webservices.
Situering
Dit document beschrijft het gebruik en de werking van de dienst GeefHistoriekInschrijvingen 2.01 zoals deze door het MAGDA platform aangeboden wordt.
Deze dienst zal de gemachtigde afnemer van het MAGDA platform in staat stellen om gegevens op te vragen met betrekking tot de inschrijvingshistoriek van een persoon in het onderwijs.
Het betreft hier een lijst van reële inschrijvingen, dus geen zaken die geannuleerd zijn of gegevens die nadien nog gecorrigeerd geweest zijn.
De gegevens die door deze webservice beschikbaar gesteld zullen worden zijn afkomstig van het departement Onderwijs en Vorming, meer bepaald uit de bronnen Leerplicht Onderwijs (Discimus), Volwassenen Onderwijs (Davinci) en Hoger Onderwijs (DHO).
Deze dienst gaat via een Magda Gateway rechtstreeks naar O&V (Onderwijs & Vorming), dit zonder verdere Magda business dienst. De service bij O&V is een dienst die voldoet aan de Magda standaarden. De Magda Gateway zal de service van O&V ontsluiten, authenticatie en autorisatie mogelijk maken, inschrijvingscontrole uitvoeren, filtering, logging, … .
Verwante diensten
Om deze dienst te kunnen gebruiken moet er eerst een inschrijving in het MAGDA inschrijvingsrepertorium voor personen aangemaakt worden. Deze inschrijvingen kunnen toegevoegd worden via de webservice RegistreerInschrijving 2.0.
Voor het verwijderen van een inschrijving kan de RegistreerUitschrijving 2.0 webservice gebruikt worden.
De informatie met betrekking tot deze webservices is terug te vinden op de sharepoint omgeving.
Voorgaande versie :
Verschillen ten opzichte van de voorgaande versie:
in de vorige versie konden enkel inschrijvingsgegevens van leerplicht onderwijs bevraagd worden; deze versie laat toe om ook inschrijvingsgegevens van hoger onderwijs en volwassenen onderwijs te ontsluiten; dit brengt met zich mee dat de structuur en naamgeving van vraag en antwoord gewijzigd werd
vanaf deze versie moet de periode steeds zowel een begin- als einddatum hebben om geldig te zijn
in tegenstelling tot de vorige versie wordt deze versie eveneens beschikbaar gesteld als batchdienst
Gegevensbronnen
Het Agentschap voor Onderwijsdiensten (AgODi) verzamelt gegevens van uit het Vlaams leerplichtonderwijs. De scholen werken met een leerlingenadministratiepakket, waarin zij de gegevens van hun leerlingen bijhouden. Discimus voorziet hierbij een interface waarmee informatie automatisch wordt doorgestuurd vanuit de leerlingenadministratiepakketten naar AgODi.
Het Agentschap voor Hoger Onderwijs, Volwassenenonderwijs, Kwalificaties en Studietoelagen (AHOVOKS) verzamelt en beheert o.a. gegevens over studenten, cursisten, inschrijvingen, opleidingen en resultaten uit het Hoger en Volwassenenonderwijs (Davinci).
Via de webservice GeefHistoriekInschrijving 2.01 worden de inschrijvingsgegevens van het Vlaams leerplichtonderwijs, het hoger onderwijs en het volwassenen onderwijs ontsloten.
Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.
Opmerking:
Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens.
Overlap inschrijvingscontrole
Naast de standaard actieve inschrijving is deze dienst ook beschikbaar met overlap inschrijvingscontrole. Hierbij wordt een periode uit de vraag vergeleken met de periode die gebruikt is bij de Repertorium.RegistreerInschrijving-02.00 dienst. Er moet minimaal 1 dag overlap zijn tussen beide periodes. Bij een actieve inschrijvingscontrole dient het INSZ actief te zijn in het inschrijvingsrepertorium op het moment van verwerking van de vraag.
Begin- en eindatum van de periode uit de vraag
Volgend element wordt gebruikt als begin- en einddatum
| Pad | Opmerking |
---|---|---|
Begindatum | /Inhoud/Criteria/Periode/Begin |
|
Einddatum | /Inhoud/Criteria/Periode/Einde |
|
Gebruiksvoorwaarden
Afnemers moeten aan volgende voorwaarden voldoen om deze dienst te mogen gebruiken:
Toelating tot MAGDA
Toelating tot de webservice GeefHistoriekInschrijving 02.01
Dit via een machtiging van VTC (Vlaamse toezichtscommissie) of een protocol met de bron.Voor inschrijvingen in leerplicht onderwijs: AGODI
Voor inschrijvingen in hoger en volwassen onderwijs: AHOVOKS
Opgelet: Deze dienst kent 3 bronnen. Per bron dient er een machtiging of protocol te zijn om toegang te krijgen tot de gegevens. M.a.w. indien er gegevens uit de 3 bronnen nodig zijn dient er een protocol met AGODI en twee protocollen met AHOVOKS (kan samen genomen worden maar zowel Davinci als DHO dienen vermeld te worden) te zijn.
Informatie:
Meer informatie over deze voorwaarden is terug te vinden op de pagina “Machtigingen en toelatingen”.
Meer informatie over het aansluitingsproces is terug te vinden op deze webpagina.
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. Deze folder wordt tijdens het aansluitingsproces toegekend. Als prefix voor de batchbestanden wordt GHID gebruikt.
Prefix | GHID |
---|---|
Voorbeeld | GHID_20131103115553530 |
Functionaliteiten
De webservice GeefHistoriekInschrijving 2.01 laat een afnemer toe om inschrijvingen voor een gespecifieerde zoekperiode op te vragen bij O&V. Dit gebeurt op basis van het INSZ van deze persoon.
Deze dienst kan op volgende manieren aangesproken worden:
De afnemer specifieert in het verzoek één of meer bronnen die bevraagd moeten worden door de dienst
De afnemer specifieert in het verzoek geen bronnen; in dat geval worden alle bronnen waarvoor de afnemer gemachtigd is bevraagd door de dienst
Als antwoord geeft de webservice een lijst van inschrijvingen terug die voldoen aan de opgegeven zoekcriteria.
Deze webservice volgt volledig de MAGDA 2.0 standaarden.
Deze functionaliteiten kunnen door middel van een webservice of door aanlevering van een bestand aangesproken worden. Prefix bestandsnaam: GHID (GeefHistoriekInschrijvingDienst).
Werking
Aandachtspunten
Alvorens deze dienst te kunnen gebruiken dient de persoon die het onderwerp vormt van de vraag ingeschreven te zijn in het MAGDA inschrijvingsrepertorium voor personen. Meer informatie over inschrijvingen kan gevonden worden op Repertorium . Deze inschrijvingscontrole wordt niet uitgevoerd indien de machtiging dit toelaat.
Opvraging
De beschikbaarheid van de diensten kan gecontroleerd worden zoals beschreven op de pagina Gebruik MAGDA Webservices 2.0.
Responsetijden & Beschikbaarheid
De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar. Deze webservice is afhankelijk van O&V als bron.
Bij geplande onbeschikbaarheden worden de afnemers op de hoogte gebracht.
Logging
De gegevens in de vraag en het antwoord van deze dienst worden bewaard zoals beschreven in het document “MAGDA logging”.
Ondersteunde talen
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.
Op deze pagina
Binnen deze handleiding
Omgevingsinformatie
Domein | Onderwijs |
---|---|
Classificatie | Persoonsgegevens |
Verwante diensten
Related pages
Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren
De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid
uitgegeven door Digitaal Vlaanderen