Results API

Titel

Results API

Status

In ontwikkeling ROSA-Architectuurscan BEsluitvorming implementatie in beheer

Versie

Documentatie: 2.0.0

schemaVersion: 2.0.0

Datum

21 Maart 2025

Auteur

Werkgroep Toetsen en examineren

Acties

Gegevensdienst

• Leerresultaten

Scopes

• eduv.result

Entiteiten

• object AssessmentScoresAndResults

• object Assessment

• object ScoreScale

• object StudentScoresAndResults

  • object ScoreEntry

  • object ResultEntry

Verzender

• Digitaal toetssysteem

• Gebruiksomgeving digitale leermiddelen

Ontvanger

• Administratiesysteem leerresultaten

• Leermiddelendashboard

Endpoints

Administratiesysteem leerresultaten

• POST /results: Process assessment scores and/or results

Leermiddelendashboard

• POST /results: Process assessment scores and/or results

OperatieID

postResults

Samenvatting

Het verzoek om bij het ontvangende systeem de toetsscores & -resultaten te verwerken voor een individuele onderwijsdeelnemer of groep van onderwijsdeelnemers.

Beschrijving

Lijst van score & resultaat items per onderwijsdeelnemer, met het verzoek nieuwe scores/resultaten te creëren of bestaande scores/resultaten te wijzigen. Het bericht is ingericht op groepsgewijze aanlevering of aanlevering van individuele onderwijsdeelnemer. Bij de lijst is algemene informatie gevoegd zoals toets/examen, afnamemoment en opmerkingen.

Tags

Administratiesysteem leerresultaten
Leermiddelendashboard

Parameters bij request

-

Object in request body

Object AssessmentScoresAndResults, met onderliggende objecten StudentScoresAndResults, Assessment en ScoreScale.

Antwoorden (statuscodes)

201 (Created): “Het verzoek is geaccepteerd de verwerking heeft plaatsgevonden; dit heeft tot de creatie van een resource geleid.“
In dit geval gaat het om volledige ontvangst, acceptatie en verwerking van het gehele bericht. Is er afwijzing op basis van een onderdeel van het bericht dan wordt het hele bericht afgewezen. Bij grote berichten kan een afwijzing lastig zijn voor de verzender; mogelijke oplossing is het bericht dan in stukken te verzenden.

202 (Accepted): “Het verzoek is geaccepteerd voor verwerking, maar de verwerking heeft nog niet plaatsgevonden; in feite zou de verwerkingen nog niet gestart kunnen zijn. De verwerking zal later wel of niet plaatsvinden, waarbij het verzoek bij de verwerking eventueel zou kunnen worden afgewezen.“
Ontvanger heeft nog geen mechanisme om fouten die bij de verwerking naar voren komen terug te melden aan verzender (bijvoorbeeld een bericht met het verwerkingsresultaat sturen naar verzender). Verzender heeft nog geen mechanisme om de verwerking te controleren (bijvoorbeeld een specifiek onderdeel uit het bericht opvragen bij ontvanger).

In deze eerste versie kunnen ontvangende systemen alleen terugkoppeling geven op bericht niveau. Ofwel, een bericht is volledig geaccepteerd (202 of 201), of een bericht is volledig geweigerd (400). Fouten die door middel van HTTP-resultaatcodes 400, 401 en 403 kunnen worden teruggeven, hebben dus alleen betrekking op het bericht. Niet op de individuele resultaten.

Antwoorden (foutcodes)

400 (Bad request)

401 (Unauthorized)

403 (Forbidden)

Veld

Type

Format

Omschrijving

Voorbeeld

O/V

Vullingsregel

id

string

uuid

Unieke identifier voor dit object .

ad80f160- cd06-48dd-af15-84263e173082

V

Indien de status van dit object wijzigt wordt hetzelfde id gehanteerd.

additionalInfo

string

string

Additionele informatie of opmerking over de afname

HAVO-normering

Betrapt op spieken

Internet viel uit

O

Dit veld kan bijvoorbeeld gebruikt worden om onderscheid te maken in toetsresultaten van dezelfde onderwijsdeelnemer met een normering op HAVO en VWO niveau.

Ook kan het veld gebruikt worden om een reden op te geven waarom de afname is afgebroken.

assessment-
DateTime

string

datetime

Tijdstempel van moment waarop de toetsafname gestart of afgesloten is.

2017-07-21T17:32:28Z

V

assessment-Definition

object

Assessment

Definitie van toets en eventuele toetsonderdelen bestaande uit identifier en naam van toets en toetsonderdelen.

V

Deze toetsdefinitie is gespecificeerd in het object Assessment.

De toetsdefinitie hoeft niet bekend te zijn bij de ontvanger.

Vanuit individuele score of resultaat kan worden verwezen naar de toets of een toetsonderdeel uit deze toetsdefinitie.

employees

array

object EmployeeReference

Lijst van verwijzingen naar onderwijsmedewerkers die het Toetsresultaat van de onderwijsdeelnemers mogen administreren in het ontvangende systeem.

[{ “userMasterIdentifier”: “ABC456”, “userIds”: [ { “userId”: “XYZ456”, “userIdType”: “ASI” } ] }]

V*

In vo is voor uitwisseling naar Administratiesysteem leerresultaten (zoals Magister of Somtoday) minimaal 1 onderwijsmedewerker verplicht om de resultaten in het ontvangende systeem te kunnen doorzetten.
Voor uitwisseling naar Leermiddelendashboard geldt de verplichting niet. In po is dit veld niet verplicht.

Een verwijzing naar een onderwijsmedewerker is gespecificeerd in een object EmployeeReference met de attributenuserMasterIdentifier en userIds. Element userIds is een array van de velden userId en userIdType, zie Object: referentie eindgebruiker.

Waarde van userIdType is conform de secundaire identifiers voor een Onderwijsmedewerker, zie pagina Identiteiten.

reviewUrl

string

url

Een URL naar de details over alle scores en resultaten van dit object in het Digitaal toetssysteem.

Door het volgen van deze URL kan aanvullende informatie over de resultaten worden ingezien.

https://toetssysteem.nl/review123abc

O

Het moet een complete en geldige URL zijn.

In andere (internationale) standaarden wordt dit veld ook wel deeplink of submission review url genoemd.

school

object

object SchoolReference

Verwijzing naar de onderwijsorganisatie waar de onderwijsdeelnemers de opleiding volgen waarvoor ze deelnemen aan de toetsafname.

[{ “organisationMasterIdentifier”: “ABC123”, “organisationIds”: [ { “organisationId”: “XYZ123”, “organisationIdType”: “AS_ID” } ] }]

V

Deze verplichte verwijzing naar de school/organisatie is gespecificeerd in een object SchoolReference met de attributen organisationMasterIdentifier en organisationIds. Element organisationIds is een array van de velden organisationId en organisationIdType, zie Object: referentie onderwijsorganisatie.

Waarde van organisationIdType is conform de secundaire identifiers voor een Onderwijsorganisatie, zie pagina Identiteiten.

schoolPeriod

string

string

Een referentie naar een Schoolperiode (SchoolPeriod) waarop de scores en resultaten betrekking hebben.

2024-2025

V

Binnen po en vo wordt hier alleen het bekende, vaste formaat “eejj-eejj“ voor schooljaar gebruikt (e staat voor eeuw, j staat voor jaar).​

scoreScale-Definitions

array

ScoreScale

Definitie van de scoreschalen die van toepassing zijn op de scores en resultaten.

O

Deze scoreschaal is gespecificeerd in het object ScoreScale.

Vanuit individuele score kan worden verwezen naar een of meer scoreschalen.

studentScores-AndResults

array

StudentScoresAndResults

De scores en resultaten van een individuele onderwijsdeelnemer.

O

Deze lijst van objecten StudentScoresAndResults bevat per object de scores en -resultaten van een onderwijsdeelnemer.

Deze lijst mag ontbreken als alle scores en resultaten van alle onderwijsdeelnemers ontbreken, bijvoorbeeld door calamiteit.

timestamp

string

datetime

Tijdstempel waarop het bericht is samengesteld.

2017-07-21T17:32:28Z

V

toolName

string

string

De naam van het systeem (de tool) waaruit de scores en resultaten zijn verzonden.

Toetssysteem A

O

Veld

Type

Format

Omschrijving

Voorbeeld

O/V

Vullingsregel

id

string

string

Unieke identifier voor de toets

6c92d082- 0d03-4194-b352-988b2e6f9ae6

TV_GRA-01

V

Dit id hoeft niet bekend te zijn bij de ontvanger.

Dit id van maximaal 36 karakters kan een toetscode zijn uit de OSO toetscodelijst of een leverancier-eigen uuid.

name

string

string

Naam van de toets die bij de score of het resultaat kan worden getoond, bijvoorbeeld in de administratie om de toetsresultaten aan een resultaatkolom toe te wijzen

Schoolexamen
Kijk- en Luistertoetsen HAVO5

V

De naam van de toets is herkenbaar voor de medewerkers.

version

string

string

Versie van de toets

2

O

Voor verwijzing naar de versie van de toets, met name bedoeld voor methodetoetsen.

Bij kleine wijzigingen in de normering blijft het id van de methodetoets gelijk en is er een nieuwe versie; die versie wordt geduid in dit veld.
Oude toetsresultaten moeten dus genormeerd blijven worden tegen de vorige versie van de toets.

subjects

array

[ subjectPrefix, subjectName ]

Vakken of leergebieden van de toets

[
{“PO/spe”, “Spelling”}, {“PO/verk”, “Verkeer”}
]

O

Deze optionele lijst van vakken/leergebieden van objecten Subject met per object de verplichte attributen afkorting (subjectPrefix) en naam (subjectName), zoals in Catalogue API.

Dit object Subject moet worden gevuld conform de waardelijst afspraken voor vakken, zie Waardenlijst vakken: subjectPrefix uit kolom “Prefix” en subjectName uit kolom “Vaknaam” van dit Excel-bestand.

studyLevelId

string

uuid

Code als verwijzing naar het onderwijsniveau van de toets

82ca4442-246c-44b3-a562-7b101793feb4

O

Waarde is de referentie naar het betreffende onderwijsniveau in Object StudyLevel (zoals in Education API) en gevuld met waarden uit Waardelijst Onderwijsniveaus, gebaseerd op de niveaus van SLO (deze is hier te vinden).

Binnen po worden alleen de enkelvoudige onderwijsniveaus gebruikt, zoals referentie naar “Groep 1” of “Groep 8”.

parts

array

[ id, name, index ]

De onderdelen van de toets voor duiding van een score of resultaat

[
{ “part1”, “Module 1”, 1},
{ “part2”, “Module 2”, 2 }
]

O

Deze lijst bestaat uit objecten AssessmentPart met de velden id, name en index, zie de volgende tabelregels voor specificatie.

Een toets hoeft geen onderdelen te hebben, dus deze lijst is optioneel.

• id

string

string

Unieke identifier voor het toetsonderdeel

part3

V

Het id van maximaal 36 karakters kan een toetscode zijn uit de OSO toetscodelijst of een leverancier-eigen uuid.

• name

string

string

Naam van het toetsonderdeel die bij de score of het resultaat kan worden getoond, bijvoorbeeld in de administratie om de toetsresultaten aan een resultaatkolom toe te wijzen

Module 3

V

De naam van het toetsonderdeel is herkenbaar binnen de toets.

• index

integer

integer

Het volgnummer van het toetsonderdeel om toetsonderdelen in volgorde van voorkeur te kunnen tonen

3

V

Getal groter gelijk aan 1. Er mogen geen
dubbele volgnummers voorkomen.

Veld

Type

Format

Omschrijving

Voorbeeld

O/V

Vullingsregel

id

string

uuid

Unieke identifier voor de scoreschaal.

6c92d082- 0d03-4194-b352-988b2e6f9ae7

V

Deze identifier hoeft niet bekend te zijn bij de ontvanger.

name

string

string

Naam van de scoreschaal die wordt/is gebruikt om scores in resultaten om te zetten.

OVG-schaal

V

De naam van de scoreschaal is herkenbaar voor de medewerkers.

scoreScaleEntries

array

[ LHS , RHS ]

De items van scoreschaal in combi LHS en RHS die de scoreschaal definiëren.

Een item uit de lijst geeft voor een waarde of interval van waarden (LHS) aan welke resultaatwaarde (RHS) daarvoor geldt.

[{ “0.0-5.4”, “Onvoldoende”},{“5.5-10.0”, “Voldoende”}]

[{“0-54”, “5”}, {“55-64”, “6”}, {“65-74”, “7”}, {“75-84”, “8”}, {“85-99”, “9”}, {“100”, “10”}]

V

Deze lijst is verplicht binnen dit object.

Een item uit de lijst bestaat uit het object scoreScaleEntries met de velden LHS en RHS, zie volgende tabelregels voor specificatie.

• LHS

string

string

Waarde of interval van waarden voor score levert de resultaatwaarde zoals in RHS.

100

0.0-5.4

75-84

V

De waarde is een enkele getalswaarde ('x') of een bereik van twee getallen ('y-z'). In geval van enkelvoudige is de waarde x de ondergrens van het interval. Bij het bereik zijn de getallen y en z de onder- respectievelijk bovengrens van het interval. Intervallen zijn inclusief de grenswaarden.

Let op, deze waarde en de beide getallen van het interval moeten voldoen aan het betreffende scoretype (van de toe te passen scorewaarde).

• RHS

string

string

De resultaatwaarde die voor waarde/interval in LHS geldt.

10

Onvoldoende

8

V

Veld

Type

Format

Omschrijving

Voorbeeld

O/V

Vullingsregel

id

string

uuid

Unieke identifier voor dit item met individuele scores en resultaten

14d807e9-8684-4a84-bc08-d48cd20eb733

V

Indien de status of het resultaat wijzigt wordt hetzelfde id gehanteerd.

additionalInfo

string

string

Additionele informatie of opmerking over deze scores en resultaten van deze deelnemer

HAVO-normering

Betrapt op spieken

Fraude

Niet aanwezig

O

Dit veld kan bijvoorbeeld gebruikt worden om onderscheid te maken in toetsresultaten van dezelfde onderwijsdeelnemer met een normering op HAVO en VWO niveau.

Ook kan het veld gebruikt worden om een reden op te geven waarom er een resultaat ontbreekt.

missing

boolean

{True,False}

Geeft aan of scores en resultaten ontbreken

True, False

V*

Verplicht als scores en results leeg zijn

results

array

object

Een of meerdere resultaat-items die zijn behaald door een individuele deelnemer bij deze afname.

zie object ResultEntry

O

reviewUrl

string

url

Een URL naar de details over deze scores en resultaten van deze deelnemer in het Digitaal toetssysteem.

Door het volgen van deze URL kan aanvullende informatie over de resultaten worden ingezien.

https://toetssysteem.nl/deelnemer123abc/review123abc

O

Het moet een complete en geldige URL zijn.

In andere (internationale) standaarden wordt dit veld ook wel deeplink of submission review url genoemd.

scores

array

object

Een of meerdere score-items die zijn behaald door een individuele deelnemer bij deze afname.

zie object ScoreEntry

O

status

string

ENUM

De status van dit deelnemer scores/resultaten item

in progress
final
canceled

O

Dit veld is additioneel toegevoegd en kan gebruikt worden om toetsresultaten in verschillende stadia door te sturen.

Defaultwaarde is final

student

object

StudentReference

Verwijzing naar de onderwijsdeelnemer die de scores en resultaten heeft behaald bij de betreffende toetsafname.

[{ “userMasterIdentifier”: “ABC123”, “userIds”: [ { “userId”: “XYZ123”, “userIdType”: “ASI” } ] }]

V

De verplichte verwijzing naar een onderwijsdeelnemer is gespecificeerd in een object StudentReference met de attributen userMasterIdentifier en userIds. Het attribuut userIds is een array van de velden userId en userIdType, zie Object: referentie eindgebruiker.
Waarde van userIdType is conform de secundaire identifiers voor een Onderwijsdeelnemer, zie pagina identiteiten.

dateCreated

string

datetime

Datum en tijdstip waarop de entiteit (dit object StudentScoresAndResults) is aangemaakt.

2024-07-21T17:32:28Z

V

Let op, dit is dus niet datumtijdstip van afname!

dateLastModified

string

datetime

Datum en tijdstip waarop één of meerdere van de hierboven genoemde attributen het laatst zijn gewijzigd

2024-08-11T15:31:12Z

V

Veld

Type

Format

Omschrijving

Voorbeeld

O/V

Vullingsregel

resultValue

string

string

De resultaatwaarde zoals behaald door de toetsdeelnemer.

Onvoldoende

5.1

V

Bevat de waarde van het scoregetal en deze waarde moet voldoen aan de typering in resultType.

resultType

string

string

Type van resultaatwaarde (In veld resultValue)

OVG

Grade0.0-10.0

V

De waarde komt uit waardelijst ResultTypes.

assessmentId

string

string

Verwijzing naar betreffende toets in toetsdefinitie (assessment) waartoe het resultaat behoort.

d262b545-12b1-4383-baa5-0fc825e133ac

V

Let op, verwijst naar de toets die is gespecificeerd in de toetsdefinitie in AssessmentDefinition (in object AssessmentScoresAndResults).

assessmentPartId

string

string

Verwijzing naar betreffende toetsonderdeel in toetsdefinitie (assessment) waartoe het resultaat behoort.

part3

O

Let op, verwijst naar een bestaand toetsonderdeel binnen de toets zoals geïdentificeerd in veld assessmentId hierboven.

AE

AE

Niveauaanduiding volgens schaal A tot en met E, waarbij de vaardigheid van de leerling wordt vergeleken met alle leerlingen (van hetzelfde leerjaar) in Nederland.​

Toelichting
De betekenis van deze niveaus A tot en met E is:
A – 25% – hoogst scorende leerlingen
B – 25% – ruim boven tot net boven het landelijk gemiddelde
C – 25% – net tot ruim onder het landelijk gemiddelde
D – 15% – ruim onder het landelijk gemiddelde
E – 10% – laagst scorende leerlingen

Niveau A+ betekent dat de leerling tot de 10% hoogst scorende leerlingen behoort.

{A+,A,B,C,D,E}​

PO​

AVI

AVI

Niveauaanduiding voor leesvaardigheid.

Toelichting
Het AVI-niveau AVI-Mx (resp. AVI-Ex) betekent dat het kind op niveau van ‘medio groep x’ (resp. ‘eind groep x’) zit.
Voor de twee afwijkende niveaus geldt: AVI-Start is voor beginnende lezers, nog voorafgaand aan groep 3 en AVI-Plus volgt op AVI-E7, oftewel kinderen die nog beter lezen dan kinderen van eind groep 7.

Voorbeeld AVI-E6 betekent leesvaardigheid van 'eind groep 6’.

{AVI-Start,
AVI-M3, AVI-E3, AVI-M4, AVI-E4, AVI-M5, AVI-E5, AVI-M6, AVI-E6, AVI-M7, AVI-E7, AVI-Plus}​

PO​

CAE

Gecorrigeerde AE

Gecorrigeerd niveauaanduiding volgens schaal A tot en met E, wanneer de afgenomen toets van een ander leerjaar is dan de leerling, en/of als de afnamedatum in een andere afnameperiode valt dan die bij de toets hoort. ​

Toelichting
Voor de betekenis van de waarden zie resultaattype AE.

{A+,A,B,C,D,E}​

PO​

CIV

Gecorrigeerde IV

Gecorrigeerd niveauaanduiding volgens schaal I tot en met V, wanneer de afgenomen toets van een ander leerjaar is dan de leerling, en/of als de afnamedatum in een andere afnameperiode valt dan die bij de toets hoort .

Toelichting
Voor de betekenis van de waarden zie resultaattype IV.

{I+,I,II,III,IV,V,V-}​

PO​

DLE​

DLE​

Geeft aan hoeveel maanden onderwijs een gemiddelde leerling nodig heeft om hetzelfde niveau te bereiken. DLE is de afkorting van Didactische Leeftijd Equivalent. ​

Toelichting
Gerelateerde DL (Didactische Leeftijd) geeft het aantal maanden aan dat een leerling onderwijs heeft gevolgd vanaf groep 3. Dus, op moment van toetsafname is DL van de leerling bekend en a.h.v. de behaalde score wordt DLE bepaald.
Is DLE lager dan DL dan loopt leerling achter op gemiddelde; is DLE hoger dan DL dan loopt leerling voor op gemiddelde.

Voorbeeld Eind groep drie heeft een leerling tien maanden onderwijs gevolgd en is de DL 10. Heeft de leerling DLE 12 behaald dan loopt het twee maanden voor op het gemiddelde.

DLE “<x” (resp. “>y“ ) geeft aan dat niveau lager dan x (resp. hoger dan y) is getoetst maar omdat de doelgroep van de toets vanaf DL x (tot en met DL y) is, is geen exactere duiding van het niveau mogelijk.

Geheel getal uit [0,100], eventueel voorafgegaan door < of >​

PO​

Education-Level

Onderwijs-niveau

Onderwijsniveau​

Toelichting
Dit type is gelijk aan OSO-referentiescore ON.

{PrO, VMBO-BB, VMBO-KB, VMBO-GL/TL, HAVO, VWO}​

PO en VO​

Functioning-Level

Functionerings-niveau

Het functioneringsniveau (FN) geeft aan met welke gemiddelde leerling in het reguliere basisonderwijs de vaardigheid van de getoetste leerling te vergelijken is.

Toelichting
Voor Cito toetsen geeft dit aan dat de behaalde vaardigheidsscore correspondeert met het niveau midden (M) of einde (E) van een bepaald leerjaar, of daartussen MxEx (of ExMx+1). Het resultaat “<Mx” ( of “>Ey“ ) geeft aan dat niveau lager dan Mx (hoger dan Ey) is getoetst maar omdat de doelgroep van de toets vanaf groep x (tot en met groep y) is, is geen exactere duiding van het niveau mogelijk.

Voor IEP LVS toetsen geeft dit aan dat op basis van de behaalde ontwikkelscore de leerling de leerdoelen van een bepaald niveau beheerst (SLO-leerdoelen en Referentiekader); bij a spreken we over de leerdoelen van het eerste helft van het schooljaar en bij b spreken we over de leerdoelen van de tweede helft), De ontwikkelscore is gelijk of hoger dan de drempelwaarde.

Voorbeeld 1 FN “M4” is dus te vergelijken met het landelijk gemiddelde niveau van ‘midden groep 4’.

Voorbeeld 2 FN “M4E4” betekent dat het vaardigheidsniveau van de getoetste leerling tussen het landelijk gemiddelde niveau voor medio groep 4 en eind groep 4 ligt.

Voorbeeld 3 FN “>E5” geeft aan dat het resultaat hoger dan de E5 is maar er is geen exactere duiding van het niveau mogelijk.

Voorbeeld 4 FN “4a” geeft aan de de leerling de leerdoelen van dat niveau beheerst en kan hij/zij gaan werken aan de leerdoelen van het volgende niveau (4b).

Dit type is gelijk aan OSO-referentiescore FN.

Voor Cito toetsen: {<M3, M3, M3E3, E3, E3M4, M4 tot en met E7, E7M8, M8, >M8}​ en eventueel Mx of Ex voorafgegaan door < of >.

Voor IEP LVS toetsen: {3a, 3b, 4a, 4b, 5a, 5b, 6a, 6b, 7a, 7b, 8a, 8b}

PO​

Grade0-10​

Schoolcijfer 0-10​

Resultaat is een schoolcijfer (geheel getal van 0 tot en met 10)​.

Geheel getal uit [0,10]​

PO en VO​

Grade0.0-10.0​

Schoolcijfer 0.0-10.0​

Resultaat is een schoolcijfer (decimaal getal van 0.0 tot en met 10.0)​.

Getal (1 decimaal) uit [0.0,10.0]​

PO en VO​

IV

IV

Niveauaanduiding volgens schaal I tot en met V, waarbij de vaardigheid van de leerling wordt vergeleken met alle leerlingen (van hetzelfde leerjaar) in Nederland.​

Toelichting
Bij deze indeling met de Romeinse cijfers I t/m V wordt uitgegaan van 5 groepen van 20%:
I – 20% – ver boven het gemiddelde
II – 20% – boven het gemiddelde
III – 20% – de gemiddelde groep leerlingen
IV – 20% – onder het gemiddelde
V – 20% – ver onder het gemiddelde

Niveau I+ betekent dat de leerling tot de 10% hoogst scorende leerlingen behoort; Niveau V- betekent dat de leerling tot de 10% laagst scorende leerlingen behoort.

{I+,I,II,III,IV,V,V-}​

PO​

LA

Leer-achterstand

Het gegeven dat met behulp van de waarde van DL en van DLE volgens de formule ‘LA = 1- (DLE/DL)’ kan worden uitgerekend.​

Toelichting
Voor de betekenis van DL en DLE zie resultaattype DLE.

Voorbeeld Het DL van een kind is 22. Als de behaalde DLE 18 is, dan is de leerachterstand 1 - (18 / 22) = 0,18 (afgerond).

Decimaal getal uit [-1.00,1.00]​

PO​

LGH

Laag-Gemiddeld-Hoog

Geeft aan of leerling “lager dan gemiddeld”, “gemiddeld” of “hoger dan gemiddeld” heeft gepresteerd.​

{Laag,Gemiddeld,Hoog}​

PO en VO​

OVG​

Onvoldoende-Voldoende-Goed

Geeft aan in welke mate de leerling de leerstof of vaardigheid beheerst: onvoldoende, voldoende of goed.​

{Onvoldoende, Voldoende, Goed}​

PO en VO​

PassOrFail​

Geslaagd/Gezakt​

Geeft aan of leerling geslaagd of gezakt is (PassOrFail).

{Geslaagd, Gezakt}​

VO​

Percentiel​

Percentiel-score​

Score volgens de indeling in gelijke percentielen; het is de maat die aangeeft hoe een score zich verhoudt tot de scores van een groep.​

Getal uit [0,100]​

PO en VO​

RnERK​

Referentie-niveau ERK​

Het Referentieniveau Europees ReferentieKader (ERK) is de indeling door de Raad van Europa voor de beheersing van diverse taalvaardigheden: spreken, schrijven, luisteren & lezen.

Toelichting
Er zijn 3 niveaus (A, B, C) en deze zijn onderverdeeld in 2 subniveaus (1, 2):
A Basisgebruiker (A1/A2: beginner)
B Zelfstandige gebruiker (B1/B2: gevorderd)
C Vaardige gebruiker (C1/C2: vergevorderd)

Het niveau “<A1” betekent ‘Lager dan A1' of 'Op weg naar A1’.

Dit type is gelijk aan OSO-referentiescore ERK. ​​

{<A1,A1,A2, B1,B2, C1,C2}​

PO en VO​

RnTR​

Referentie-niveau Taal en Rekenen​​

De referentieniveaus Taal en Rekenen (volgens Meijerink) zijn landelijke standaarden die beschrijven welk niveau leerlingen op specifieke momenten in hun onderwijsloopbaan moeten behalen op het gebied van taal en rekenen.

Toelichting
Het niveau “<1F” wordt door toetsaanbieders omschreven als ‘Lager dan 1F' of ook wel 'Op weg naar 1F’.

Dit type is gelijk aan OSO-referentiescore RNTRM. ​

{<1F,1F,<1S,1S, <2F,2F,2S, <3F,3F,3S, 4F,4S}​

PO en VO​

Veld

Type

Format

Omschrijving

Voorbeeld

O/V

Vullingsregel

scoreValue

string

string

De scorewaarde zoals behaald door de toetsdeelnemer.

64
6

V

Bevat de waarde van het scoregetal en deze waarde moet voldoen aan de typering in scoreType.

scoreType

string

string

Type van scorewaarde (In veld scoreValue)

zie Waardelijst ScoreTypes

V

De waarde komt uit waardelijst ScoreTypes.

scoreMaximum

integer

integer

De maximaal te behalen scorewaarde (in veld scoreValue)

100

O

Waarde voldoet aan scoreType en de scoreValue is kleiner of gelijk aan deze waarde.

Waarde is vaak een geheel getal (aantal) groter dan 0.

assessmentId

string

string

Verwijzing naar betreffende toets in toetsdefinitie (assessment) waartoe de score behoort.

d262b545-12b1-4383-baa5-0fc825e133ac

V

Let op, verwijst naar de toets zoals gespecificeerd in de toetsdefinitie in AssessmentDefinition (in object AssessmentScoresAndResults).

assessmentPartId

string

string

Verwijzing naar betreffende toetsonderdeel in toetsdefinitie (assessment) waartoe de score behoort.

part3

O

Let op, verwijst naar een bestaand toetsonderdeel binnen de toets zoals geïdentificeerd in veld assessmentId hierboven.

scoreScaleIds

array

string

De verwijzingen naar de betreffende scoreschalen voor omzettingen van score naar resultaat.

[6c92d082- 0d03-4194-b352-988b2e6f9ae7, 7c92d083- 0d04-4195-b353-988b2e6f9ae8]

O

Iedere verwijzing moet zijn gedefinieerd in scoreScales (in object AssessmentScoresAndResults).

NumberItems​

Aantal gemaakte items​

Aantal door leerling gemaakte opgaven/items.​

Geheel getal uit [0,n]​

PO en VO​

Number-Incorrect​

Aantal fout gemaakt​

Aantal fout gemaakte opgaven/items door leerling.​

Geheel getal uit [0,n]​

PO en VO​

Number-Correct​

Aantal goed gemaakt​

Aantal goed gemaakte opgaven/items door leerling.​

Geheel getal uit [0,n]​

PO en VO​

Percentage-Correct​

Percentage goed​

Percentage goed gemaakte opgaven door leerling​.

Toelichting
Waarde is 100 * ‘Aantal goed gemaakt’ / ‘Aantal opgavenitems’.​

Getal (geheel of decimaal) uit [0,n]​

PO en VO​

DurationIn-Seconds​

Tijdsduur (in seconden)​

Totaal aantal seconden dat de toetsafname voor de leerling heeft geduurd.​

Geheel getal uit [0,n]​

PO en VO​

ScorePoints​

Scorepunten​

Aantal door leerling behaalde punten na nakijk/correctie​.

Toelichting
Merk op, bij opgaven/items met gelijk gewicht is dit Aantal goed gemaakt.​

Geheel getal uit [0,n]​

PO en VO​

SkillScore​

Vaardigheids-score​

Het getal dat aangeeft wat een leerling kan op een leergebied; getal is de gemeten eenheid op de vaardigheidsschaal (ook wel Ontwikkelscore genoemd).

Toelichting
Scores behaald bij dezelfde toets zijn vergelijkbaar met scores van dezelfde leerling of leeftijdsgenoten.

Getal (geheel of decimaal; positief of negatief) uit eenheden van de vaardigheidsschaal​.

PO​ en VO