Protocollen

Bij de alles-in-één-overdracht worden altijd de gegevens van alle ingeschreven leerlingen van een hele school volledig opgehaald. Het sturen van kleinere deelverzamelingen (afdeling, groep, klas) wordt niet ondersteund.

Bij de getrapte overdracht zijn er 3 request- en bijbehorende responseberichten gedefinieerd die de gegevens van alle ingeschreven leerlingen getrapt ophalen. Via herhaling kunnen alle leerlinggegevens en leerkrachtgegevens in blokjes (per groep of setje van groepen) opgehaald worden. De volgorde is:

1. Eerst de organisatorische gegevens van school en groepen (de structuur),
2. Dan de leerlinggegevens (eventueel in delen per groep of verzameling groepen) en
3. Tenslotte de leerkrachtgegevens (eventueel in delen per groep of verzameling groepen).

Het initiatief voor de overdracht ligt bij de EA. Er zijn diverse triggers voor de overdracht mogelijk:

• De EA stuurt automatisch na de afname van een toets direct de leerresultaten naar het LAS. Dit kan zowel per toets zijn als per leerling-toetsafname (druppelsysteem).
• Degene die verantwoordelijk is voor de toetsafname (meestal de leerkracht) geeft expliciet opdracht aan de EA om de gegevens door te sturen. De instelling hiervan en de mate waarop de gebruiker hierover controle heeft, is een belangrijk punt: gebruikers van EA’s zijn de eigenaars van de resultaatgegevens en zullen daarom controle moeten houden over deze overdracht. Een EA moet dit correct implementeren en presenteren aan de gebruiker.

De EA voert de authenticatie van de leerling uit. Hiervoor zullen de interne accounts met de LAS-leerlinggegevens moeten matchen. Voor het terugsturen van leerresultaten aan het LAS is de LAS-identifier namelijk noodzakelijk. Hoe de matching precies plaatsvindt, valt buiten de scope van deze afspraak.

Voor het identificeren en authenticeren van leerlingen en medewerkers in het LAS en de EA voor de uitwisseling van de resultaten wordt verwezen naar de ECK-standaard Distributie en toegang. Binnen ECK Distributie en toegang wordt onder andere beschreven hoe een leerling (en leerkracht) in de contentketen geïdentificeerd wordt. Dit is belangrijk voor deze afspraak, omdat leerresultaten uiteraard aan de goede leerling gekoppeld moeten worden.

Een systeem zal geauthenticeerd en geautoriseerd moeten worden om een webservice te mogen aanroepen. Uitwisselingen in het kader van UWLR spelen zich af binnen de ‘zeggenschap’ van de school. De gegenereerde gegevens in dit protocol worden opgenomen in een autorisatiestructuur.

In dit scenario hebben we te maken met systemen die (nog) niet automatisch gekoppeld zijn. Aan de LAS-kant moeten toetsresultaten worden ingevoerd en daarbij is het efficiënter als de toetsdefinities in een standaard formaat aan een LAS worden aangeleverd. Het invoeren van de gegevens kan zo vereenvoudigd worden door het presenteren van lijsten, controleren van waarden etc.

Voor een aantal elementen binnen deze afspraak is het mogelijk dat er vocabulaires zijn of in de toekomst komen. De identificatie van de vocabulaire wordt aan het element toegevoegd. De waarde van het veld moet dan voldoen aan de vocabulaire.