Informatie:
De XML en CSV bestanden die via FTP gepubliceerd worden dienen te voldoen aan de MAGDA richtlijnen. Voor meer informatie over hoe een Publicatie-dienst algemeen gebruikt dient te worden, bekijk Werking en gebruik MAGDA 2.0 Publicaties.
De gegevens zijn beschikbaar in XML en opgebouwd volgens de MAGDA richtlijnen.
Algemeen
In deze sectie bespreken we de praktische werking van deze publicatiedienst met eventuele specifieke opmerkingen. Voor meer algemene informatie in verband met het gebruik van MAGDA publicatiediensten neemt u best de algemene handleiding Werking en gebruik MAGDA 2.0 Publicaties door.
Bestandsnaam
Opmerking:
De exacte bestandsnaam wordt pas meegedeeld tijdens het aansluitingsproces. De gegevens die u hier vindt kunnen dus mogelijk wijzigen.
De bestandsnaam is van de vorm prefix_publicatienaam_timestamp.extensie.
Voorbeeld | onderwijs.publiceerinschrijving-0200_20221103115553530.xml |
|---|
Publicatie in XML
Algemeen
Informatie:
De publicatie in XML bevat een standaard context zoals de andere MAGDA publicaties. Dit naar analogie met de contextbeschrijving voor webservices, bekijk hiervoor eens de handleiding Werking en gebruik MAGDA 2.0 Webservices.
XSD
De bestanden die worden aangeboden op de outputfolder zijn gevalideerd volgens de xsd horende bij deze dienst. De actuele xsd is ter beschikking op https://vlaamseoverheid.atlassian.net/wiki/spaces/MG/pages/487620609/Overzicht+testdata+endpoints+en+XSD+s
Elementen
Informatie:
Voor een overzicht van alle elementen die in de gevraagde XML staan en eventuele beperkingen wordt er verwezen naar de XSD.
Visueel
Detail
Element | Beschrijving | ||
|---|---|---|---|
Metadata | Wordt niet gebruikt in deze dienst | ||
Attest | Identificatiegegevens van het inschrijvingsattest | ||
DatumCreatie | Datum van creatie van het attest. | ||
IdentificatieNummer | Unieke ID van het attest. | ||
INSZ | Identificatie van de ingeschreven persoon. | ||
Status | Duidt de status van het attest aan | ||
Code | Code die de status van het attest aangeeft. | ||
Omschrijving | Omschrijving van de status code. | ||
TypeAttest | Definieert het type attest. | ||
Code | Code die het type attest aangeeft. | ||
Omschrijving | Omschrijving van de code voor de aanduiding van het type attest. | ||
Schooljaar | Beginjaar van het schooljaar/academiejaar. | ||
Volgnummer | Nummering attesten van eenzelfde persoon per schooljaar. | ||
School | Gegevens van de school waarin de persoon is ingeschreven | ||
NummerInstelling | Identificatie van de onderwijsinstelling. | ||
Hoofdstructuur | Definieert de hoofdstructuur van een school, bestaat uit 3 elementen die samen de hoofdstructuur van een school bepalen nl. het niveau van onderwijs, het soort onderwijs, het soort programma. | ||
Code | Code die de hoofdstructuur van een school bepaalt. | ||
Omschrijving | Omschrijving van de code voor de aanduiding van de hoofdstructuur van de school. | ||
VolgnummerVestigingsplaats | Nummering van de vestiging binnen de instelling. | ||
NummerAdministratieveGroep | Geeft het nummer van de administratieve groep weer, dit is niet aanwezig bij hoofdstructuur 999. | ||
Ondernemingsnummer | Dit identificatienummer is een uniek nummer dat toegekend wordt aan een onderneming. | ||
Vestigingsnummer | Dit identificatienummer is een uniek nummer dat toegekend wordt aan een onderneming. | ||
SecundairOnderwijs | Gegevens m.b.t. secundair onderwijs indien het een inschrijving in het secundair onderwijs betreft | ||
DatumGeldigheid | Datum van de inschrijving of de uitschrijving, enkel voor een attest van het secundair onderwijs. | ||
SoortOnderwijs | Geeft het soort onderwijs weer, enkel voor een attest van het secundair onderwijs. | ||
Code | Code van het soort onderwijs | ||
Omschrijving | Omschrijving van de code voor de aanduiding van het soort (secundair) onderwijs. | ||
Onderwijsvorm | Geeft de (secundaire) onderwijsvorm aan. | ||
Code | Type: 1 numerieke positie | ||
Omschrijving | Omschrijving van de code voor de aanduiding van de (secundaire) onderwijsvorm. | ||
Voltijds | Code die weergeeft of een persoon al dan niet voltijds onderwijs volgt. | ||
TypeBuitengewoon | Geeft het type buitengewoon (secundair) onderwijs weer. | ||
Code | Type: 1 numerieke positie | ||
Omschrijving | Omschrijving van de code voor de aanduiding van het type buitengewoon (secundair) onderwijs. | ||
Graad | Geeft het niveau van (secundair) onderwijs weer, enkel voor een attest van het Secundair Onderwijs. | ||
Jaar | Geeft het jaar binnen de graad van het (secundair) onderwijs weer, enkel voor een attest van het Secundair Onderwijs. | ||
HogerOnderwijs | Gegevens m.b.t. hoger onderwijs indien het een inschrijving in het secundair onderwijs betreft | ||
DatumGeldigheid | |||
DatumInschrijving | |||
DatumUitschrijving | |||
AantalStudiepunten | |||
KanDiplomaBehalen | |||
@Beschijving | |||
TypeInschrijving | |||
Code | |||
Omschrijving | |||
TypeContact | |||
Code | |||
Omschrijving | |||
Opmerkingen
Voorbeelden
Uitzonderingen
Indien er gekozen werd om een uitzonderingsbestand te onvangen, komt er een Uitzondering terug met als foutcode 15015 – geen gegevens te publiceren.
Publicatie in CSV
Algemeen
De CSV bestanden voldoen aan de MAGDA richtlijnen voor publicatie diensten.
Voor de inhoudelijke beschrijving wordt bijgevolg verwezen naar de vorige sectie over publicatie in XML.
Al de elementen binnen de XSD zijn opgenomen in de CSV.
In geval dat er een uitzonderingsbestand gevraagd werd zal het CSV-bestand leeg zijn.
Elk Onderwerp-element in een XML resulteert in feite in één CSV-record.
Elementen
Kolomnummer in CSV | Overeenkomstig element in XML (Te beginnen bij XXX) |
|---|---|
Opmerkingen
Codetabellen
Op deze pagina
Binnen deze handleiding
