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 Bestandsuitwisseling (Publicaties/batchverwerking).

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.

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	PBWD_20140224155516000.xml

Op deze pagina

1 Algemeen
2 Bestandsnaam
3 Publicatie in XML
- 3.1 Algemeen
4 Onderwerp
- 4.1 Voorbeeld van response
- 4.2 Uitzonderingen

Binnen deze handleiding

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

Publicatie in XML

Algemeen

Onderwerp

De publicatie bevat

één of meerdere onderwerp-elementen met per onderwerp-element een bewijs en een metadata-element
een oiptioneel uitzondering-element

Voor meer informatie met betrekking tot de uitzonderingen, zie de kop uitzonderingen onderaan op deze pagina. De inhoud van de publicatie bevat volgende elementen:

Elementen

Element		Omschrijving

Element		Omschrijving
Metadata
	Referte	De unieke mutatiereferte van het bewijs. Maximum lengte van 36 lang.
	Type	Type van mutatie. Mogelijke waardes: · 00 (Onbekend) · 01 (Nieuw) · 02 (Wijziging) · 03 (Annulatie) · 04 (Verwijdering) · 09 (Andere) Enkel waarde 01 en 03 worden op dit moment gebruikt door LED. Andere waardes komen (nog) niet voor in de databank.
	Datum	Datum en tijdstip van mutatie. Is van het type xs:dateTime. Voorbeeld: 2001-12-17T09:30:47Z
Bewijs		Bevat alle informatie met betrekking tot een bepaald bewijs: · de refertes waarmee het bewijs kan geïdentificeerd worden, · de status waarin het zich bevindt, · de leverancier (bron), · aan wie het werd uitgereikt, · de eigenlijke basisdata en de door LED afgeleide bewijsdata. De validatie gebeurt door de LED Dienstenimplementatie en niet o.b.v. schemagebaseerde enumeraties. De toegelaten waarden van de dimensies (bv. Categorie, Graad, ...) van een Bewijs, van haar basisattributen (bv. Leverancier, Land, Taal, ...), en van de toegelaten dimensiecombinaties (bv. een bepaalde Categorie-Graad combinatie), worden beheerd door AHOVOKS d.m.v. de zogenaamde Taxonomiebeheer applicatie. De lijst van toegelaten waarden en combinaties wordt door AHOVOKS in samenwerking met de verschillende partijen op afgesproken tijdstippen gepubliceerd. Zie de gebruikersdocumentatie van de dienst GeefBewijs en, voor meer toelichting, de LED Taxonomie.

<Onderwerpen>
	<Onderwerp>
		<Referte>4888a645-94d4-4e64-b08e-4d2e85b42d10</Referte>
		<Inhoud>
			<Metadata>
				<Referte>12155</Referte>
				<Type Beschrijving="Verwijdering">04</Type>
				<Datum>2001-12-17T00:00:00</Datum>
			</Metadata>
			<Bewijs>
				<BewijsrefertesLed>
					<Bewijsreferte>4888a645-94d4-4e64-b08e-4d2e85b42d10</Bewijsreferte>
					<Bewijsmutatiereferte>3f853ccf-7878-43ee-a8c5-a66f0e7692e1</Bewijsmutatiereferte>
				</BewijsrefertesLed>
				<BewijsstatusLed>
					<Code>1</Code>
					<DatumModificatie>
						<Datum>2011-05-16</Datum>
						<Tijd>14:31:59.123</Tijd>
					</DatumModificatie>
				</BewijsstatusLed>
				<Leverancier>
					<Naam>VDAB</Naam>
					<Bewijsreferte>test20110504-456</Bewijsreferte>
				</Leverancier>
			</Bewijs>
		</Inhoud>
	</Onderwerp>
	<Onderwerp>
		<Referte>48597645-94d4-4e64-b08e-4d2e85b42d10</Referte>
		<Inhoud>
			<Metadata>
				<Referte>qqqqqq</Referte>
				<Type Beschrijving="Nieuw">01</Type>
				<Datum>2001-12-17T00:00:00</Datum>
			</Metadata>
			<Bewijs>
				<BewijsrefertesLed>
					<Bewijsreferte>4888a645-94d4-4e64-b08e-4d2e85b42d10</Bewijsreferte>
					<Bewijsmutatiereferte>3f853ccf-7878-43ee-a8c5-a66f0e7692e1</Bewijsmutatiereferte>
				</BewijsrefertesLed>
				<BewijsstatusLed>
					<Code>10</Code>
					<DatumModificatie>
						<Datum>2011-05-13</Datum>
						<Tijd>14:31:59.123</Tijd>
					</DatumModificatie>
				</BewijsstatusLed>
				<Leverancier>
					<Naam>VDAB</Naam>
					<Bewijsreferte>20110516-253</Bewijsreferte>
				</Leverancier>
				<Basis>
					<Authenticiteit>
						<Naam>Op eer</Naam>
					</Authenticiteit>
					<Schooltype>
						<Naam>Hoge School</Naam>
					</Schooltype>
				</Basis>
				<Afgeleid>
					<ISCEDStudiegebied>
						<Code>142</Code>
					</ISCEDStudiegebied>
				</Afgeleid>
			</Bewijs>
		</Inhoud>
	</Onderwerp>
</Onderwerpen>

Voorbeeld van response

<Onderwerp>
	<Referte>4a01fe9f-9ba3-453e-bdb5-db1cd585c00c</Referte>
	<Inhoud>
		<Metadata>
			<Referte>864ccebd-c85f-4260-8636-32046c7eedf9</Referte>
			<Type>03</Type>
			<Datum>2020-01-21T14:49:00</Datum>
		</Metadata>
		<Bewijs>
			<BewijsrefertesLed>
				<Bewijsreferte>2f2c2fdc-77b0-4811-81a3-8daa009d9e24</Bewijsreferte>
				<Bewijsmutatiereferte>e614967c-1596-413c-a548-0e3604045127</Bewijsmutatiereferte>
			</BewijsrefertesLed>
			<BewijsstatusLed>
				<Code>10</Code>
				<DatumModificatie>
					<Datum>21.01.2020</Datum>
					<Tijd>14:49:00.956</Tijd>
				</DatumModificatie>
			</BewijsstatusLed>
			<Leverancier>
				<Naam>Volwassenenonderwijs</Naam>
				<Bewijsreferte>5d2f8f18-e278-4b92-b1a3-8217c0409b01</Bewijsreferte>
			</Leverancier>
			<PersoonUitgereikt>
				<INSZ>xxxxxxxxx</INSZ>
			</PersoonUitgereikt>
			<Basis>
				<Authenticiteit>
					<Naam>Authentiek</Naam>
				</Authenticiteit>
				<Categorie>
					<Naam>Secundair onderwijs</Naam>
				</Categorie>
				<Graad>
					<Naam>Niet van toepassing</Naam>
				</Graad>
				<Onderwijsvorm>
					<Naam>Niet van toepassing</Naam>
				</Onderwijsvorm>
				<Bewijstype>
					<Naam>Deelcertificaat</Naam>
				</Bewijstype>
				<Bewijsstaat>
					<Naam>Tussenbewijs</Naam>
				</Bewijsstaat>
				<Instantie>
					<Naam>Centrum voor Volwassenenonderwijs (CVO)</Naam>
				</Instantie>
				<Onderwerp>
					<Code>222015</Code>
					<Naam>Nederlands voor anderstaligen</Naam>
				</Onderwerp>
				<Uitreikingsdatum>
					<Jaar>2014</Jaar>
					<Maand>08</Maand>
					<Dag>31</Dag>
				</Uitreikingsdatum>
				<VolledigeNaam>Deelcertificaat NT2 threshold 4B</VolledigeNaam>
				<Land>
					<Code>BEL</Code>
				</Land>
				<Taal>
					<Code>nld</Code>
				</Taal>
				<Instelling>
					<Naam>Technische Scholen Mechelen - Centrum voor Volwassenenonderwijs</Naam>
					<Nummer>30619</Nummer>
				</Instelling>
				<Schooltype>
					<Naam>Gewoon</Naam>
				</Schooltype>
				<Studierichting>
					<Naam>NT2 threshold 4B</Naam>
					<Code>00000869</Code>
				</Studierichting>
				<BijkomendeInformaties>
					<BijkomendeInformatie>
						<Naam>Bewijs omschrijving</Naam>
						<Inhoud>Deelcertificaat NT2 threshold 4B</Inhoud>
					</BijkomendeInformatie>
					<BijkomendeInformatie>
						<Naam>Module type</Naam>
						<Inhoud>Standaard</Inhoud>
					</BijkomendeInformatie>
				</BijkomendeInformaties>
			</Basis>
			<Afgeleid>
				<ISCEDStudiegebied>
					<Code>222</Code>
					<Naam>Vreemde talen</Naam>
				</ISCEDStudiegebied>
				<ISCEDNiveau>
					<Code>NBS</Code>
					<Naam>Niet beschikbaar</Naam>
				</ISCEDNiveau>
				<VKSNiveauOnderwijskwalificatie>
					<Code>NBS</Code>
					<Naam>Niet beschikbaar</Naam>
				</VKSNiveauOnderwijskwalificatie>
				<VKSNiveauBeroepskwalificatie>
					<Code>NBS</Code>
					<Naam>Niet beschikbaar</Naam>
				</VKSNiveauBeroepskwalificatie>
			</Afgeleid>
		</Bewijs>
	</Inhoud>
</Onderwerp>

Uitzonderingen

In twee gevallen kan een uitzondering voorkomen:

er zijn geen gegevens te publiceren (15015)
al de gegevens zijn gefilterd (15022)

Beide zullen voorkomen op niveau 2 van de publicatie xml. In beide gevallen zal de publicatie geen bewijzen bevatten.

Een uitzondering bevat volgende elementen:

Element	Omschrijving

Element	Omschrijving
Identificatie	Verplicht. Maxlengte 10. De uitzonderingscode.
Oorsprong	Minlengte 1, maxlengte 5. Duidt de bron aan van de uitzondering (altijd MAGDA)
Type	Mogelijke waardes: · FOUT · WAARSCHUWING · INFORMATIE
Tijdstip	Optioneel, indien aanwezig zijn Datum en Tijd beide aanwezig. · Datum: formaat jjjj-mm-dd · Tijdstip: formaat uu:mm:ss.sss
Diagnose	Verplicht. De tekstuele omschrijving van de opgetreden uitzondering.
Omstandigheid	Optioneel. Wordt veelal gebruikt om de foutcode van de bron door te geven of voor meer informatie te geven met betrekking tot de uitzondering.
Annotatie	Optioneel, meerdere mogelijk. Is opgebouwd uit een naam/waarde-paar. Wordt in de PubliceerBewijs 02.00 niet gebruikt.

Overzicht uitzonderingen

Identificatie	Niveau	Omschrijving

Identificatie	Niveau	Omschrijving
15015	2	Geen te publiceren gegevens
15022	2	Geen gegevens in publicatie wegens filtering van al de gegevens

Voorbeelden

<Uitzonderingen>
	<Uitzondering>
		<Identificatie>15015</Identificatie>
		<Oorsprong>MAGDA</Oorsprong>
		<Type>FOUT</Type>
		<Tijdstip>
			<Datum>2011-03-10</Datum>
			<Tijd>09:32:39.570</Tijd>
		</Tijdstip>
		<Diagnose>Geen te publiceren gegevens</Diagnose>
	</Uitzondering>
</Uitzonderingen>

MAGDA Gebruikersomgeving

Interface (LED.PubliceerBewijs-02.00)

Informatie:

Algemeen

Bestandsnaam

Opmerking:

Publicatie in XML

Algemeen

Onderwerp

Elementen

Voorbeeld van response

Uitzonderingen

Overzicht uitzonderingen

Voorbeelden

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid