Uitwisseling Leerlinggegevens en Resultaten 2.3

Beschrijving

Scholen maken gebruik van methodeapplicaties (bijvoorbeeld van een uitgever) waarbij leerlingen/studenten worden ondersteund bij het leren en aan het einde of tussendoor worden getoetst. Ook worden leerlingen/studenten middels speciale toetsapplicaties of assessments getoetst. Belangrijk is dat de resultaten van deze toetsen overgedragen kunnen worden van een educatieve applicatie naar het leerlingadministratiesysteem cq studentinformatiesysteem of leerlingvolgsysteem van een school. En, voordat de leerling/student aan de gang kan, moeten bepaalde leerling-/studentgegevens van de school naar deze applicaties worden overgedragen om de toetsomgeving voor de leerlingen/studenten in te richten. De afspraak Uitwisseling Leerlinggegevens en Resultaten (UWLR) is bedoeld om de uitwisseling van leerling/student-gegevens en resultaten te faciliteren.

In deze versie 2.3 van de afspraak UWLR wordt het ECK-iD als primaire identifier (uitwisselsleutel) van de leerling gebruikt, alleen onder de voorwaarde dat het ECK-iD niet beschikbaar voor de leerling is mag het LAS-key worden gebruikt. Daartoe zijn de profielen “Smalle set” en “LVS-set” overeenkomstig aangepast met enkele kleinere aanpassingen aan de gegevens over leerlingen. In 2022 is hier een nieuw profiel “Smalle set voor VO” aan toegevoegd, rekening houdend met de specifieke informatiebehoefte in het vo.

UWLR wordt als overkoepelende afspraak niet meer verder ontwikkeld. De redenen hiervoor zijn te lezen in dit nieuwsbericht uit 2019. Zie verder het kopje Ontwikkelingen.

Samenhang

EDEXML wordt gebruikt als uitwisselingsformaat voor de leerling-/studentgegevens. UWLR 2.3 veronderstelt EDEXML 2.1; alleen de mogelijkheid dat het ECK-iD zonder LAS-key zou kunnen voorkomen is een kleine afwijking van EDEXML 2.1 waarbij het LAS-key altijd verplicht aanwezig is.

Meerwaarde

Door het gebruik van UWLR kunnen leerresultaten geautomatiseerd worden overgezet van bijvoorbeeld de methodewebsite of een landelijk toetssysteem naar het leerlingvolgsysteem (LVS) of leerlingadministratiesysteem (LAS) cq studentinformatiesysteem (SIS). Dat scheelt docenten veel tijd, en bovendien voorkomt het fouten bij het overtypen van gegevens. Het overzicht in het LAS/SIS zal meer up-to-date zijn. Het voordeel van UWLR voor onderwijsinstellingen is dat zij de resultaten makkelijker en dus vaker kunnen verwerken. Voordeel voor marktpartijen is dat ze minder koppelingen voor de uitwisseling van leerling-/studentgegevens en leerresultaten hoeven te ontwikkelen en onderhouden.

De verplichting van het LAS-key in voorgaande versies van UWLR stond op gespannen voet met de voltooiing van de implementatie van het ECK-iD omdat dat moment het startsein is om een gewenste dataminimalisatie te gaan doorvoeren. Dat houdt onder andere in dat de ketenafhankelijke identifiers als het LAS-key moeten verdwijnen voor die leerlingen die een ECK iD hebben c.q. zouden kunnen hebben. Deze verplichting van het LAS-key is in deze laatste versie van UWLR beperkt tot onder de voorwaarde dat dit alleen geldt wanneer de leerling geen ECK-iD heeft.

Gebruik

Deze versie 2.3 van de afspraak Uitwisseling Leerlinggegevens en Resultaten is ontwikkeld en wordt gebruikt door verschillende uitgeverijen, toetsaanbieders en leveranciers van leerlingadministratiesystemen in het po. Deze ketenpartijen werken samen in de projectgroep Ketenimplementaties PO binnen Edu-K.

Implementatie

Deze bronnen helpen bij de implementatie van de afspraak UWLR (Uitwisseling Leerlinggegevens en Resultaten):

De technische onderdelen in de UWLR-viewer 2.2.1, zoals de hoofdonderdelen Protocollen, Berichten, Profielen en Systemen. Let op, dat de verplichting van het LAS-key daarbij is vervallen en dat op beide velden “Leerling id” voor LAS-key en “ECK-iD” de volgende werkingsregel van toepassing is:
“Als een leerling een ECK-iD heeft dan moet dit als identifier van de leerling worden gebruikt, eventueel tijdelijk aangevuld met het LAS-key. Alleen als een leerling geen ECK-iD heeft, mag het LAS-key worden gebruikt.”

Technische bestanden bij UWLR 2.3 (13 december 2024).
Dit is de bundel van technische bestanden met WSDL webservicedefinities, XSD schemadefinities en XML voorbeelden, inclusief de XSD schemadefinities van de profielen “Smalle set” en “LVS-set”. In deze nieuwste versie (20241213) is type EDEXSchooljaarType gewijzigd van enumeratie naar tekstveld met toekomstbestendig patroon EEJJ-EEJJ.

Technische bestanden bij Profiel “Smalle set voor VO” bij UWLR 2.3 (13 december 2024). In deze nieuwste versie (20241213) is type EDEXSchooljaarType gewijzigd van enumeratie naar tekstveld met toekomstbestendig patroon EEJJ-EEJJ.
Dit is de bundel van technische bestanden met WSDL webservicedefinities, XSD schemadefinities en XML voorbeelden, specifiek voor dit profiel. In de correctieversie van 3 oktober 2022 is code “N” toegevoegd aan codewaardelijst van veld Jaargroep.

Ontwikkelingen

In deze versie 2.3 van de afspraak UWLR worden de volgende aanpassingen t.o.v. versie 2.2.1 gerealiseerd:

In de heenweg (uitwisselen van deelnemergegevens dat wil zeggen leerling-/studentgegevens) is het ECK-iD de primaire identifier (uitwisselsleutel) van de leerling; eerder was het LAS-key altijd verplicht. Het LAS-key is alleen verplicht als de leerling geen ECK-iD heeft.
Bovenstaande werkingsregel heeft geleid tot analoge aanpassingen voor de beide profielen “Smalle set” en “LVS-set” op de leerlinggegevens. In het profiel “Smalle set” is tevens het veld Geboortedatum van Leerling verwijderd (conform attributenbeleid) en in profiel “LVS-set” zijn de velden Voorletters en BSN-4 binnen Leerling verwijderd en is het veld “E-mail adres van leerkracht” toegevoegd.
In de terugweg van resultaatgegevens is het ECK-iD eveneens de primaire identifier van de leerling in navolging van de heenweg.

Tijdens Programma Start Schooljaar 2021 – 2022 is besloten om het DigideliveryID toe te gaan passen binnen de toegangscall in het vo. Dit om een beter aansluiting te krijgen tussen gespecificeerde tegoeden en het activeren van licenties waardoor (mogelijke) toegangsissues en het gebruik van servicetegoeden verder afnemen. In voorbereiding op schooljaar 2021 – 2022 hebben de LASsen in het vo (waaronder Magister en Somtoday) wijzigingen doorgevoerd om het DigideliveryID beschikbaar te krijgen in het LAS. Vervolgens hebben betrokken partijen ingestemd met de implementatie voor schooljaar 2022 – 2023.

Een LAS stelt het DigideliveryID beschikbaar via één of meer binnen de afsprakenset (vo) afgesproken koppelvlakken, waaronder de UWLR Smalle set. Voor de toevoeging van het digideliveryID aan de UWLR smalle set is, in overleg met Edustandaard, het UWLR-profiel “Smalle set voor VO” gedefinieerd. Dit profiel “Smalle set voor VO” is toegevoegd aan het document “Profielen bij afspraak UWLR 2.3”.
Ten behoeve van implementatie van dit profiel is de bijbehorende technische bestandenbundel “Technische bestanden bij profiel Smalle set voor VO” beschikbaar.

Door de complexiteit van de UWLR afspraak (het bevat afspraken over gegevens en beveiliging en betreft informatie over toetsdeelnemers en toetsresultaten in veel verschillende contexten), wordt deze afspraak niet verder ontwikkeld. Slechts beperkte aanpassingen aan de profielen worden nog uitgevoerd. Zie ook het nieuwsbericht hierover uit 2019. Implementatie en gebruik van UWLR zal afgebouwd worden en vervangen door nieuwe afspraken die een actuele oplossing bieden voor een specifieke context. Deze afspraken zijn al beschikbaar (waaronder Summatieve toetsresultaten VO , Logistiek proces Eindtoets po, Niet-methodegebonden toetsen PO) of zullen nog beschikbaar gaan komen.

In het kader van het programma Edu-V wordt ook gewerkt aan nieuwe afspraken voor de uitwisselingen die nu nog met UWLR worden ondersteund.