...
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.
Maximum score (scoreMaximum) = De door de toetsdeelnemer te behalen score in Scoregetal.
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 een Maximum score en verwijzing naar het betreffende Toets of Toetsonderdeel (Toets/onderdeel) 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, Zowel toets als toetsonderdeel omvat de gegevens Toetsid en Toetsnaam. Binnen de toets is eventueel ook informatie over betreffende Vakgebied Vakgebieden en Leerjaar van de toets beschikbaar en binnen een toetsonderdeel is er ook het Volgnummer beschikbaar om de volgorde van de onderdelen in de toets te specificeren. Voor landelijk genormeerde toetsen wordt voor Toetsid een centrale waardenlijst aanbevolen, zoals de OSO toetscodelijst in het po en vo,
Systeemnaam (toolName) = De naam van tool/systeem als verzender van de scores en resultaten.
...
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, 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
Volgnummer aan Toetsonderdeel toegevoegd
Interacties uitgebreid met beschrijving hoe een wijziging of verwijdering van deelnemerscores en -resultaten moet worden uitgevoerd.
Maximum score (scoreMaximum) toegevoegd aan object Score.
0.0.10: Leermiddelendashboard als Ontvanger van leerresultaten.
0.9.0: Het Bestuurlijk Overleg heeft tijdens de bijeenkomst van 27 juni 2024 het Afsprakenstelsel Edu-V als versie 0.9.0 goedgekeurd voor implementatie.
0.9.1: Na goedkeuring door werkgroep en CAB van oplossing voor RFC zijn de gegevens Vakgebied Vakgebieden en Leerjaar toegevoegd aan Toetsdefinitie in deze specificatie.