FDE-set voor Fijndistributie 1.2

Beschrijving

Voor het transport van deelnemergegevens tussen LAS en toetssystemen is voor het ECK-iD een profiel “Smalle set” en een profiel “LVS-set” met attributen gedefinieerd gebaseerd op de EDEXML-standaard. De gegevens binnen deze profielen betreffen leerlingen en leerkrachten (docenten). Echter binnen het domein ECK-D&T is vastgesteld dat deze leerlinggegevens ook nodig zijn binnen het distributie/leveringsproces ten behoeve van fijndistributie (FDE). Vanuit de leveranciers is er een sterke behoefte om ook hiervoor een profiel op EDEXML te maken omdat dit goed aansluit bij hun huidige inrichting.

Deze uitwisseling is gericht op een andere context dan de context van toetsen waarvoor nu de standaarden die vallen onder UWLR (waaronder de EDEXML-profielen) worden toegepast. Dat is op zich geen probleem, EDEXML wordt ook nu al als gegevensstandaard breder toegepast.

Profielen zijn extra eisen bovenop de gegevensstructuur (datamodel) van EDEXML ten behoeve van een bepaald proces of een bepaalde toepassing. Deze eisen kunnen inhouden dat bepaalde velden verboden of verplicht zijn, of dat op bepaalde gereserveerde plaatsen extra gegevens worden geplaatst. Vanuit technisch implementatie- en beheerperspectief is het werken met profielen op één gegevensverzameling voor een leverancier zeer wenselijk, men is enerzijds hiermee al vertrouwd en anderzijds omdat vanuit het oogpunt van veiligheid dan eenduidig per service die voor een profiel wordt gerealiseerd bepaald kan worden welke partij de data mag krijgen. Dit neemt niet weg dat de implementatie niet altijd eenvoudig is, zeker omdat EDEXML een standaard is die qua begrippen niet perfect aansluit bij het VO en MBO.

Deze afspraak is ten behoeve van de fijndistributie zoals bijvoorbeeld wordt toegepast bij een Gefaciliteerd Leermiddelen Fonds (GLF). Deze specificaties zijn bedoeld voor informatie en implementatie deskundigen. In de specificaties van dit profiel zal op een aantal plaatsen naar de betreffende paragraaf in de documentatie van EDEXML 2.1 worden verwezen. Dit om herhalingen van definities en beschrijvingen op verschillende plaatsen te voorkomen.

Voor de communicatielaag is de wens om het transport van de gegevens te baseren op de onderwijsstandaard die in het onderwijsdomein voor de beveiligde uitwisseling van privacy-gevoelige gegevens is vastgesteld, namelijk het uitwisselen conform de beveiliging en webservice-patronen die nu ook in het kader van UWLR versie 2.3 worden gehanteerd of als dat gewenst is, volgens andere patronen.

In deze afspraak zijn om praktische redenen de ontwikkelingen rondom RIO en AMIGO buiten de specificaties gelaten.

Deze versie 1.2 van de afspraak betreft het EDEXML-profiel “FDE-set voor VO”. Dit profiel omvat grofweg de volgende eisen:

Dit profiel omvat per leerling naast de persoonlijke gegevens als LAS-key, ECK-iD, Naam, Geboortedatum en E-mailadres tevens informatie over Opleiding, Vakkenpakket en Bezorgadres (noodzakelijk voor m.n. identificatie van de leerling van de producten en diensten van de leverancier, communicatie rondom levering en aflevering bij bezorgadres).
Het waardebereik van gegevensvelden m.b.t. opleiding en vak is beperkt tot vastgestelde codelijsten.
Het profiel wordt toepast op de UWLR heenweg van leerlinggegevens, zonder resultaatbericht (terugweg) .
Getrapt ophalen van leerlinggegevens in de stappen: eerst structuur (vestigingen en groepen) en dan leerlingen voor specifieke groepen, is voorzien.
Dit profiel wordt toegepast op versie 2.3 van UWLR (nieuw in versie 1.1).
De leerlinggegevens is uitgebreid met e-mailadres van ouder/verzorger (nieuw in versie 1.1).
Dit profiel is toegespitst op toepassing in het VO, en om dit duidelijk te maken is de naam gewijzigd in “FDE-set voor VO” (nieuw in versie 1.2).
De gegevens voldoen aan de aanvullende informatiebehoefte in het VO waarvan de belangrijkste aangevulde gegevens zijn (nieuw in versie 1.2):
- DigideliveryID als Edu-iX identificatie van de organisatorische eenheid bij School en/of FDE-vestigingen,
- Leerling-/studentnummer als extra identificatie binnen de school van de leerling/student,
- E-mailadres (privé) bij Leerling, en
- Plaatsingen bij Leerling, voor actuele en/of toekomstige plaatsingen.
In dit profiel zijn enkele verhelderingen toegevoegd over zeggenschap van de gegevenssoorten, IBP en governance van de afspraak conform de adviezen uit de ROSA-scan (nieuw in versie 1.2).

De laatste drie vetgedrukte eisen zijn in versie 1.2 toegevoegd aan versie 1.1. Door deze toevoegingen is de afwijking van EDEXML 2.1 iets groter geworden maar nog steeds beperkt: gegevens DigideliveryID, GegevenssetID en Leerling-/studentnummer zijn op logische plaatsen in de gegevensstructuur buiten de beschikbare toevoegingsblokken toegevoegd en het gegeven Jaargroep is verboden in dit profiel (en is verplicht in EDEXML).

Implementatie

Deze bronnen helpen bij de implementatie van de afspraak EDEXML-profiel “FDE-set voor VO”:

Documentatie van de afspraak EDEXML-profiel “FDE-set voor VO” (versie 1.2, 3 oktober 2022)

Dit document bevat de beschrijving en details van de afspraak.
Let op, in deze correctieversie van 3 oktober 2022 is het veld DigideliveryID verduidelijkt met werkingsregel en is code “N” toegevoegd aan codewaardelijst van veld Jaargroep. In de lijst van documenten onder Documentatie staat ook hetzelfde document inclusief kleurmarkering van de laatste correcties.

Technische bestanden bij EDEXML-profiel “FDE-set voor VO” (versie 1.2, 3 oktober 2022).
Deze technische bundel met WSDL, XSDs en Voorbeeld-XML bestanden zijn conform de inhoudelijke afspraak in de documentatie ontwikkeld. De vocabulaires behorende bij de gegevensvelden “Opleidingscode” en “Vakcode” o.b.v. Elementcodetabel en Vakcodetabel zijn beschreven in het bijgevoegd Excel-bestand.
Let op, in deze correctieversie van 3 oktober 2022 is code “N” toegevoegd aan codewaardelijst van veld Jaargroep.