DIGITAAL VLAANDEREN

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 17 Next »

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

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

 Voorbeeld: Context
<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.

Opmerking:

Het volledige bewijs is niet in onderstaand voorbeeld opgenomen.

 Voorbeeld 1: Publicatie
<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

 Click here to expand...
<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

Minlente 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

 Voorbeeld: Geen gegevens te publiceren
<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>
 Voorbeeld: Alle gegevens gefilterd
<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

Binnen deze handleiding

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

  • No labels

Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren

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

uitgegeven door Digitaal Vlaanderen