Versions Compared

Key

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

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.

Excerpt
hiddentrue

Wijzigingshistoriek

DatumAanpassingen

 

Eerste versie van de handleiding

Situering

Verwante diensten

Gegevensbronnen

Het opvragen van het aantal halve dagen problematische afwezigheid van een persoon op basis van diens INSZ en het schooljaar. Voor de afnemer is het enkel mogelijk zich te authentiseren door middel van een certificaat.

Situering

Dit document beschrijft het gebruik en de werking van de webservice GeefAantalProblematischeAfwezigheden 02.00 zoals deze door Agentschap Digitaal Vlaanderen op het MAGDA platform aangeboden wordt.

Verwante diensten

RegistreerInschrijving en RegistreerUitschrijving

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.

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.

Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.

title
Note

Opmerking:

Agentschap Informatie 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

Image Added

Pad

Opmerking

Begindatum

/Inhoud/Schooljaar

“01/09/” + Schooljaar

Einddatum

/Inhoud/Schooljaar

“31/08/” + (Schooljaar + 1)

Gebruiksvoorwaarden

Afnemers moeten aan volgende voorwaarden voldoen om deze dienst te mogen gebruiken:

  • Toelating tot het MAGDA platform

  • Toelating tot de webservice GeefAantalProblematischeAfwezigheden 02.00

Infotitle
  • Machtiging van het VTC (Vlaamse Toezichtscommissie)

Info

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.

Prefix voor de batchbestanden: GPAD (GeefAantalProblematischeAfwezighedenDienst)

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.

Prefix

XXX

Onderwijs.GPAD

Voorbeeld

XXX

Onderwijs.GPAD _20131103115553530

.

Functionaliteiten

Vraag

Antwoord

Werking

Aandachtspunten

Opties

Volgende configuratieparameters kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer:

  • Configuratieparameters op het MAGDA platform zijn voor deze dienst niet van toepassing
AnchoropvragingopvragingOpvraging

Responsetijden & Beschikbaarheid

Notetitle

De dienst GeefAantalProblematischeAfwezigheden laat de afnemer toe het aantal halve dagen problematische afwezigheid van een persoon op te vragen. Dit op basis van diens INSZ en het schooljaar.

Voor de afnemer is het enkel mogelijk zich te authentiseren door middel van een certificaat.

De GeefAantalProblematischeAfwezigheden -Gateway zal in grote lijnen instaan voor:

  • de authenticatie (enkel via certificaat)

  • logging van de berichten en sleutelwaardes

  • inschrijvingscontrole op basis van het INSZ in de vraag

  • het aanroepen van de businessdienst bij Onderwijs

Image Added

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 inRepertorium . Deze inschrijvingscontrole wordt niet uitgevoerd indien de machtiging dit toelaat.

Responsetijden & Beschikbaarheid

De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar. De beschikbaarheid is afhankelijk van de beschikbaarheid bij de bron. Bij geplande onbeschikbaarheden worden de afnemers op de hoogte gebracht.

Note

Opmerking:

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. 

Logging

De opvragingen die gebeuren via deze webservice gegevens in de vraag en het antwoord van deze dienst worden bewaard zoals beschreven op de pagina "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 isin het document “MAGDA logging”.

Op deze pagina

Table of Contents
maxLevel2

Binnen deze handleiding Page Treeroot@self

Child pages (Children Display)

Omgevingsinformatie

Functioneel

Domein

Onderwijs

Classificatie

Create from Template
templateName494699588
templateId494699588
titleBeschrijving Vraag (DIENSTNAAM-VERSIE)
buttonLabelMaak "Beschrijving Vraag"-pagina

Create from Template
templateName494568993
templateId494568993
titleBeschrijving Antwoord (DIENSTNAAM-VERSIE)
buttonLabelMaak "Beschrijving Antwoord"-pagina

Create from Template
templateName496599113
templateId496599113
titleUitzonderingen (DIENSTNAAM-VERSIE)
buttonLabelMaak "Uitzonderingen"-pagina

Create from Template
templateName494699935
templateId494699935
titleTestgegevens & Voorbeelden (DIENSTNAAM-VERSIE)
buttonLabelMaak "Testgegevens & Voorbeelden"-pagina

Create from Template
templateName494667241
templateId494667241
titleVeelgestelde vragen (DIENSTNAAM-VERSIE)
buttonLabelMaak "Veelgestelde Vragen"-pagina

Create from Template
templateName494470620
templateId494470620
titleGekende problemen (DIENSTNAAM-VERSIE)
buttonLabelMaak "Gekende Problemen"-pagina

Create from TemplatetemplateName496664661templateId496664661titleVerschillen tegenover vorige versie (DIENSTNAAM-VERSIE)buttonLabelMaak "Verschillen tegenover vorige versie"-pagina

Persoonsgegevens


Verwante diensten

Child pages (Children Display)
pageOnderwijs

Info

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