...
Een Toetsscore of Score is een individuele score, d.w.z. een score behaald door een individuele toetsdeelnemer. Een toetsscore is meestal eenvoudig (bijvoorbeeld het behaalde aantal scorepunten of de benodigde tijdsduur) maar is soms complex (bijvoorbeeld bij een vaardigheidsscore). Scores kunnen wijzigen door wijziging van de inhoud (bijvoorbeeld aanpassing van gewicht van deelscores of neutralisatie van een item). In deze uitwisseling betreft de Toetsscore het behaalde aantal scorepunten; andere soorten scores zijn bijvoorbeeld ‘Percentage goed-gemaakte opgaven', ‘Benodigde tijd’, Vaardigheidsscore en Onderdeelscore.
Een Toetsresultaat of Resultaat is een volgens een specifieke schaal bepaald resultaat na omzetting/berekening met behulp van de score(s) van de toetsdeelnemer. Resultaten in hetzelfde domein zijn vaak onderling vergelijkbaar. Deze omzetting is soms eenvoudig en soms complex, maar ook soms openbaar en soms niet openbaar. Als een omzetting niet openbaar is dan wordt meestal alleen het resultaat geleverd. Resultaten kunnen wijzigen n.a.v. aanpassingen in de omzetting; normering is een onderdeel van de omzetting. In deze uitwisseling worden verschillende soorten resultaten ondersteund: Eindcijfer/Schoolcijfer; Goed/Voldoende/Onvoldoende en Referentieniveau. Het Toetsresultaat is niet altijd direct te berekenen vanuit de behaalde Toetsscore.
Een Scoreschaal definieert de omzetting van score naar resultaat. Er bestaan verschillende soorten scoreschalen; het meest eenvoudig is de tweepuntsschaal met cesuur die bepaalt of de score wel of niet voldoende was. Complexere scoreschalen bevatten ingewikkelde formules, soms met behulp van verschillende scores. In deze uitwisseling is gekozen voor de scoreschaal zoals 1EdTech OneRoster Gradebook Services de ‘ScoreScale’ definieert en toepast. Deze ‘ScoreScale’ komt overeen met de Matchingschaal in het ROSA Toetsdefinitie gegevensmodel.
Deze ‘ScoreScale’ gaat uit van een omzettingstabel met regels in de vorm van: aan de linkerkant (Left Hand Side, LHS) een bepaalde score-interval, bijvoorbeeld “0-30“ en “31-65“, en aan de rechterkant (Right Hand Side, RHS) een bepaalde tekstuele waarde als resultaatwaarde, bijvoorbeeld “Onvoldoende“ respectievelijk “Voldoende“. Een Scoreschaal kan eventueel ook worden gebruikt om het aantal behaalde punten om te zetten naar een schoolcijfer of een behaald cijfer te kwalificeren door LHS is “7.1-10.0“ en RHS is “Goed“. Als de waarde aan de linkerkant (LHS) een enkel getal is dan specificeert dit de inclusieve laagste waarde van het interval (zonder hoogste waarde).
De informatie-elementen in het berichten zijn in onderstaande opsomming gedefinieerd, met tussen haakjes de naam van het gegeven in de Results API:
Afnamemoment (assessmentDateTime) = het moment (datum met tijdstip) van afname.
Berichtid (id) = Unieke identificatie van het bericht; belangrijk om bij update of verwijdering of foutopsporing eenduidig naar dit bericht te kunnen verwijzen.
Deelnemerscores en -resultaten (lijst) = lijst van items Deelnemerscores en -resultaten (object StudentScoresAndResults) met per item de scores en resultaten van een specifieke onderwijsdeelnemer behaald bij de toetsafname. Per item de volgende informatie-elementen:
Dsenrid (id) = Unieke identificatie van deelnemerscores en -resultaten (afgekort dsenr); belangrijk om bij update of verwijdering eenduidig naar dit item te kunnen verwijzen.
Onderwijsdeelnemer (verwijzing) = Verwijzing naar de onderwijsdeelnemer (in object StudentReference) die de scores/resultaten heeft behaald.
Ontbrekend (missing) = Indicatie of scores en resultaten voor de deelnemer wel of niet ontbreken.
Opmerking (deelnemer) (additionalInfo) = Aanvullende informatie over scores en resultaten van de onderwijsdeelnemer, bedoeld voor de medewerker die het resultaat doorzet in de administratie. Dit kan informatie bevatten over de toegepaste normering of reden van ontbrekend resultaat (bijvoorbeeld “Niet komen opdagen”, “Niet ingeleverd“ of “Ziek weggegaan”).
Resultaat (lijst) (results) = lijst van objecten Resultaat (object Result) met per object een resultaat of toetsresultaat door de onderwijsdeelnemer behaald bij toetsafname; resultaat omvat de combinatie Resultaatwaarde en Resultaattype, eventueel vergezeld door verwijzing naar het betreffende Toets of Toetsonderdeel.
Resultaattype (resultType) = Het type/soort resultaat. Waarde uit waardenlijst:
DLE = Didactische Leeftijd Equivalent
Beheersing = Aanduiding of beheersing voldoende of onvoldoende is (PassOrFail)
OVG = 1 letter uit {G, V, O} for Goed, Voldoende of Onvoldoende (OVG)
RnERK = Referentieniveau Europees Referentiekader voor talen; waarden A1 t/m C2.
RnTR = Referentieniveau Taal & Rekenen; waarden zijn Op weg naar 1F (Lager dan 1F), 1F t/m 4S.
Schoolcijfer 0-10 = geheel getal vanaf 0 t/m 10 (Grade0-10)
Schoolcijfer 0.0-10.0 = getal met 1 decimaal vanaf 0.0 t/m 10.0 (Grade0.0-10.0)
Resultaatwaarde (resultValue) = Het door de onderwijsdeelnemer behaalde resultaat; waarde voldoen aan Resultaattype.
Review-url (deelnemer) (reviewUrl)= Een URL naar de details over over scores en resultaten van de onderwijsdeelnemer in het Digitaal toetssysteem, soms ook wel 'deeplink' of 'submission review url' genoemd.
Score (lijst) (scores) = lijst van items van object Score (Score). Het object Score (Score) bevat een score of toetsscore van een specifieke onderwijsdeelnemer behaald bij de toetsafname in de combinatie Scoregetal en Scoretype, eventueel vergezeld door verwijzing naar het betreffende Toets of Toetsonderdeel en/of de Scoreschaal waarmee de omzetting van score naar resultaat wordt uitgevoerd.
Scoregetal (scoreValue) = De door de toetsdeelnemer behaalde score; waarde voldoen aan de richtlijnen voor de omzetting naar resultaat binnen Scoreschaaldefinitie.
Scoreschaal (verwijzing) (assessmentId) = Verwijzing naar de scoreschaal in scoreschaaldefinities dat voor betreffende score van toepassing is.
Scoretype (scoreType) = Het type/soort score. Waarde uit waardenlijst:
Aantal fout = score is het aantal fout gemaakte opgaven/toetsitems (NumberIncorrect)
Aantal goed = score is het aantal goed gemaakte opgaven/toetsitems (NumberCorrect)
Aantal opgaven = score is het aantal gemaakte opgaven/toetsitems (NumberItems)
Percentage goed = score is het percentage goed gemaakte opgaven/toetsitems (PercentageCorrect)
Scorepunten = score is het aantal behaalde scorepunten, veelal een getal in interval vanaf 0 tot en met maxscore/maximumscore (ScorePoints)
Tijdsduur = score is de tijdsduur van de toetsafname in seconden (DurationInSeconds)
Vaardigheidsscore = score is de vaardigheidsscore of ontwikkelscore (SkillScore)
Status (status) = Status van score/resultaat. Waarde uit waardenlijst:
Voorlopig (InProgress)
Definitief (Final),
Overbodig/vervallen (Canceled).
Toets (verwijzing) (assessmentId) = Verwijzing naar toets of toetsonderdeel dat score/resultaat betreft. Onderlinge relaties binnen de toets worden in toetsdefinities gedefinieerd.
Medewerkers (verwijzing) = Lijst van verwijzingen naar schoolmedewerkers (in object EmployeeReference). Verwezen medewerkers zijn, indien nodig, in staat om dit resultaat door te zetten in de administratie.
Opmerking (afname) (additionalInfo) = Algemene informatie over scores/resultaten in het bericht, bedoeld voor de medewerker die het resultaat doorzet in de administratie. Dit kan informatie bevatten over de toegepaste normering of over onregelmatigheden tijdens afname, bijvoorbeeld “Vogel in lokaal” of “Internetstoring”).
Review-url (afname) (reviewUrl)= Een algemene URL naar de details over scores/resultaten in het Digitaal toetssysteem, soms ook wel 'deeplink' of 'submission review url' genoemd.
School (school) = Verwijzing naar de onderwijsorganisatie of organisatie-eenheid (in object SchoolReference), die de opleiding aanbiedt waarbinnen de toetsafname heeft plaatsgevonden.
Schoolperiode (schoolPeriod) = de periode waarin het onderwijs is ingedeeld (bijvoorbeeld schooljaar of semester) wat deze scores en resultaten betreft.
Scoreschaaldefinitie (lijst) (scoreScaleDefinitions) = lijst van items met één scoreschaaldefinitie per item. De definitie van de verschillende toepasbare scoreschalen, met per scoreschaal de omzetting van score naar resultaat door de lijst van combinaties LHS en RHS. LHS (Left Hand Side) definieert het score-interval met beginwaarde en eindwaarde gescheiden door streepje, bijvoorbeeld “0-5“; RHS (Right Hand Side) definieert de resultaatwaarde als scoregetal binnen bijbehorende score-interval valt, bijvoorbeeld “Onvoldoende“.
Timestamp (timstamp) = het moment (datum met tijdstip) van samenstellen van het bericht.
Toetsdefinitie (assessmentDefinition) = De definitie van de betreffende toets en toetsonderdelen, elk met Toetsid en Toetsnaam. Voor landelijk genormeerde toetsen wordt voor Toetsid een centrale waardenlijst aanbevolen, zoals de OSO toetscodelijst in het po en vo,
Systeemnaam (systemName) = De naam van het systeem waaruit de scores en resultaten zijn verzonden.
De gegevens betreffende Berichtid, Afnamemoment, Toetsdefinitie, Medewerkerids, School, Schoolperiode en Timestamp zijn verplicht; de gegevens ToetssysteemSysteemnaam, Scoreschaaldefinities en Deelnemerscores en -resultaten zijn aanbevolen; gegevens Review-url en Opmerking zijn optioneel. Per Deelnemerscores en resultaten zijn de gegevens Dsenrid en Onderwijsdeelnemerid verplicht; Resultatenlijst, Ontbrekend, Scorelijst en Status zijn aanbevolen; gegevens Review-url en Opmerking zijn optioneel.
...
De toetsafname is afgerond en de toetsscores worden direct overgedragen (groepsgewijs of eventueel individueel).
De resultaten van de toetsafname zijn beoordeeld en genormeerd zodat de toetsresultaten worden vrijgegeven.
Een schoolmedewerker geeft opdracht de toetsresultaten over te dragen.
...
Deze uitwerking is gebaseerd op basis van de volgende stappen:
0.0.1: Draft uitwerking.
0.0.2: Uitwerking scenario, toetsdeelnemersresultaat en interactie.
0.0.3: Randvoorwaarden en Results API toegevoegd.
0.0.4: Feedback uit de bijeenkomst van de Werkgroep Summatieve toetsresultaten van 30 mei 2023 is verwerkt.
0.0.5: Reviewcommentaren van de werkgroep Summatieve toetsresultaten (t/m 9 juni 2023) zijn verwerkt.
0.0.6: De omschrijvingen van de randvoorwaarden zijn verduidelijkt en er is een link gelegd naar de relevante pagina’s uit de architectuur.
0.0.7: De opmerkingen en afspraken van de werkgroep in het overleg van 17 juli 2023 verwerkt. Er is een nieuw bericht Toetsscore toegevoegd. Daarnaast zijn voor het Toetsresultaat en de Toetsscore ook gebundelde berichten toegevoegd waar meerdere Toetsresultaten of Toetsscores kunnen worden verstuurd.
0.0.8: De omschrijvingen aangepast aan het gewijzigde Architectuurkader Edu-V (Referentiecomponenten zonder Business rollen, Gegevensmodel en -definities) en reviewopmerkingen van werkgroep (één gecombineerd bericht in plaats van vier aparte berichten voor score/resultaat en enkelvoudig/gebundeld).
0.0.9: Correcties en verduidelijkingen aangebracht n.a.v. reviewcommentaren van de werkgroep. Naar aanleiding van bespreking de volgende wijzigingen aangebracht:
de Leraar uit het interacties gehaald.
Het object AssessmentScoresAndResults uitgebreid met Schoolperiode, Toetssysteem Systeemnaam en School; Toetsdefinitie uitgebreid met toetsonderdelen en scoreschaal vervangen door definitie van meerdere scoreschalen.
Individuele score uitgebreid met verwijzing naar toets/toetsonderdeel en scoreschaal.
Individueel resultaat uitgebreid met verwijzing naar betreffende toets/toetsonderdeel.
Resultaattypen uitgebreid met DLE