Versions Compared

Old Version 17

changes.mady.by.user Cedric Van Assche

Saved on

compared with

New Version Current

changes.mady.by.user Kurt Janssen

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
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

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

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
titleVoorbeeld: Context
Code Block
languagexml
<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.

Note

Opmerking:

Het volledige bewijs is niet in onderstaand voorbeeld opgenomen.

Expand
titleVoorbeeld 1: Publicatie
Code Block
languagexml
<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

View file
namePBWD_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 RemovedImage Added

Element

Omschrijving

Identificatie

Verplicht. Maxlengte 10. De uitzonderingscode.

Oorsprong

Minlente 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
titleVoorbeeld: Geen gegevens te publiceren
Code Block
languagexml
<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
titleVoorbeeld: Alle gegevens gefilterd
Code Block
languagexml
<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
maxLevel2
minLevel1

Binnen deze handleiding

Child pages (Children Display)
pageLED.PubliceerBewijs-02.00
Info

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