Info

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

Note

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

Table of Contents

maxLevel	2
minLevel	1

Binnen deze handleiding

Child pages (Children Display)

page	LED.PubliceerBewijs-02.00

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

Publicatie in XML

Algemeen

Info

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:

Image Removed

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

Info

Informatie:

Voor een overzicht van alle elementen die in de gevraagde XML staan en eventuele beperkingen wordt er verwezen naar de XSD.

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

Expand

title	Voorbeeld: Context

Code Block

language	xml

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

Image Removed

Image Added

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.

Zie de gebruikersdocumentatie van de dienst GeefBewijs en, voor meer toelichting, de LED Taxonomie.

Note

Opmerking:

Het volledige bewijs is niet in onderstaand voorbeeld opgenomen.

Expand

title	Voorbeeld 1: Publicatie

Code Block

language	xml

<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

response

View file

name	PBWD_20151230111011518.txt

Expand

Code Block

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

Image Modified

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

Expand

title	Voorbeeld: Geen gegevens te publiceren

Code Block

language	xml

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

Expand

title	Voorbeeld: Alle gegevens gefilterd

Code Block

language	xml

<Uitzonderingen>
	<Uitzondering>
		<Identificatie>15022</Identificatie>
<Oorsprong>MAGDA</Oorsprong>
		<Type>FOUT</Type>
		<Tijdstip>
			<Datum>2011-03-14</Datum>
			<Tijd>14:41</Tijd>
		</Tijdstip>
		<Diagnose>Geen gegevens in publicatie wegens filtering van al de gegevens</Diagnose>
	</Uitzondering>
</Uitzonderingen>

Op deze pagina

Table of Contents

maxLevel	2
minLevel	1

Binnen deze handleiding

Child pages (Children Display)

page	LED.PubliceerBewijs-02.00

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

Versions Compared

Old Version 18

New Version Current

Key

Informatie:

Algemeen

Bestandsnaam

Opmerking:

Publicatie in XML

Algemeen

Informatie:

XSD

Elementen

Informatie:

Context

Referte

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

Voorbeeld

Onderwerp

Elementen

Opmerking:

Voorbeeld van

response

Uitzonderingen

Overzicht uitzonderingen

Voorbeelden

Page Comparison

Versions Compared

Old Version 18

New Version Current

Key

Informatie:

Algemeen

Bestandsnaam

Opmerking:

Publicatie in XML

Algemeen

Informatie:

XSD

Elementen

Informatie:

Context

Referte

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

Voorbeeld

Onderwerp

Elementen

Opmerking:

Voorbeeld van

response

Uitzonderingen

Overzicht uitzonderingen

Voorbeelden