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

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 Webservices 02.00.

De algemene interface van de context bevat volgende elementen:

XSD

De bestanden die worden aangeboden op de outputfolder zijn gevalideerd volgens de service-XSD horende bij deze dienst. De actuele XSD is ter beschikking op aanvraag.

Elementen

Context

De algemene interface van de context bevat volgende elementen:

Enkel de relevante elementen zijn in onderstaande tabel opgenomen.

Element	Omschrijving
Naam	“LED.PubliceerBewijs”
Versie	“02.00.0000”
Type	“PUBLICATIE”
Datum	Datum op moment van publicatie, formaat jjjj-mm-dd
TIjdstip	Tijdstip op moment van publicatie, formaat uu:mm:ss.000
Afzender
Identificatie	Vip.vlaanderen.be (kan variëren)
Naam
Referte	Zie beschrijving element 'Referte'
Ontvanger
Identificatie	Identiek aan deze meegedeeld bij de toelatingsaanvraag
Naam
Hoedanigheid	Identiek aan deze meegedeeld bij de toelatingsaanvraag

Referte

Voor deze FTP-stroom gelden referte-elementen van 36 lang. Elk bestand zal een unieke referte verkrijgen, net als elk gepubliceerd bewijs. Typisch zullen UUID’s[1] gebruikt worden als refertes.

Voorbeeld van een UUID: 550e8400-e29b-41d4-a716-446655440000

[1] http://en.wikipedia.org/wiki/Universally_unique_identifier

Voorbeeld

<Context>
	<Naam>LED.PubliceerBewijs</Naam>
	<Versie>02.00.0000</Versie>
	<Bericht>
		<Type>PUBLICATIE</Type>
		<Tijdstip>
			<Datum>2011-03-08</Datum>
			<Tijd>08:38:12.222</Tijd>
		</Tijdstip>
<Afzender>
			<Identificatie>vip.vlaanderen.be</Identificatie>
			<Referte>550e8400-e29b-41d4-a716-446655440000</Referte>
		</Afzender>
		<Ontvanger>
			<Identificatie>vdab.vlaanderen.be/xxx</Identificatie>
			<Hoedanigheid>111</Hoedanigheid>
		</Ontvanger>
	</Bericht>
</Context>

Onderwerp

De publicatie bevat

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

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

<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 respons

<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
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
15015	2	Geen te publiceren gegevens
15022	2	Geen gegevens in publicatie wegens filtering van al de gegevens

Voorbeelden

Op deze pagina

1 Algemeen
2 Bestandsnaam
3 Publicatie in XML
- 3.1 Algemeen
- 3.2 XSD
- 3.3 Elementen
- 3.4 Voorbeeld van respons
- 3.5 Uitzonderingen

Binnen deze handleiding

MAGDA Gebruikersomgeving

Interface (LED.PubliceerBewijs-02.00)

Informatie:

Algemeen

Bestandsnaam

Opmerking:

Publicatie in XML

Algemeen

Informatie:

XSD

Elementen

Context

Referte

[1] http://en.wikipedia.org/wiki/Universally_unique_identifier

Voorbeeld

Onderwerp

Elementen

Voorbeeld van respons

Uitzonderingen

Overzicht uitzonderingen

Voorbeelden

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