Page Comparison

Op deze pagina is de functionele, operationele en technische specificatie te vinden voor het administreren van de toetsresultaten van een lokaal geplande toets.

...

Scenario

...

Scenario

Nadat de resultaten van een toetsafname zijn vastgesteld en beschikbaar zijn gekomen in het referentiecomponent Digitaal toetssysteem heeft de leraar (leerkracht/docent/instructeur) de mogelijkheid de resultaten van de toetsdeelnemers (Toetsresultaten) over te dragen aan het referentiecomponent Administratiesysteem leerresultaten. Eventueel gebeurt de overdracht automatisch na vrijgave van de resultaten. Toetsresultaten zijn specifieke leerresultaten zoals gedefinieerd als informatieobject Leerresultaat in het domein Evaluatie onderwijs. De leraar logt vervolgens in dit schooladministratiesysteem in en zet de toetsresultaten door naar de juiste plek bij de betreffende onderwijsdeelnemers.

...

Voorwaardelijk voor deze informatieoverdracht is dat de informatie over schoolperiodes en vakken (Schoolinfo) en over onderwijsdeelnemers en medewerkers (Schoolorganisatie) bij het Digitaal toetssysteem bekend is. Dit wordt ondersteund door de uitwisseling van “Schoolinfo & Schoolorganisatie“ van het Administratiesysteem onderwijsdeelnemer naar het Digitaal toetssysteem.

...

Image Added

De informatie over de toetsresultaten van individuele onderwijsdeelnemers (toetsdeelnemers) wordt overgedragen in het bericht “Toetsresultaten” aan het Administratiesysteem leerresultaten. Dit bericht kan het enkelvoudige resultaat van een individuele toetsdeelnemer bevatten of een verzameling samenhangende toetsresultaten van een groep toetsdeelnemers. Voor de overdracht van een verzameling samenhangende toetsresultaten (bijvoorbeeld de resultaten van alle toetsdeelnemers van een afnamegroep) kan de informatie per toetsdeelnemer in een reeks berichten achterelkaar worden aangeleverd, of kunnen deze toetsresultaten gebundeld in één bericht worden aangeleverd. Het is de verzender, in dit geval het Digitaal toetssysteem, die dit bepaalt.
In aanvulling op de resultaten van een toetsafname is mogelijk in het bericht Toetsresultaten de toetsscore(s) van de individuele toetsdeelnemer bij te voegen, eventueel vergezeld door het betreffende Toetsonderdeel en/of de Scoreschaal definitie waarmee de omzetting van score naar resultaat is uitgevoerd.

Het bericht “Toetsresultaten” “Toetsresultaten” omvat het informatieobject “Toetsscores en -resultaten” en dit betreft de gebundelde resultaten van een groep van toetsdeelnemers om te kunnen worden doorgezet in het Administratiesysteem leerresultaten. Belangrijk in dit bericht is dat algemene informatie slechts één keer in het bericht hoeft en dat specifieke informatie zich in de lijst van objecten “Deelnemerscores en -resultaten” bevindt (zie onderstaand Figuur 3).

...

De definitie van de verschillende informatie-elementen in dit bericht “Toetsresultaten“ wordt in navolgende paragraaf “Toetsresultaten informatie“ beschreven en de objecten het object “Toetsscores en -resultaten” (AssessmentScoresAndResults) en met object “Deelnemerscores en -resultaten” (StudentScoresAndResults) is uitgewerkt in de Results API.

...

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.

  • 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

    • Percentiel = Percentielscore is het getal van 0 t/m 100 dat aangeeft hoeveel procent van de kandidaten de toetsscore van de student of een lagere toetsscore heeft behaald.

  • 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, elk met Zowel toets als toetsonderdeel omvat de gegevens Toetsid en Toetsnaam. Voor landelijk genormeerde toetsen Binnen de toets is eventueel ook informatie over betreffende Vakgebieden en Niveau 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.

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.

...

Bovenstaande interactiemodel gaat uit van één gegevensbericht per individuele onderwijsdeelnemerscores en/of -resultaten. Het interactiemodel ziet er voor het gebundelde bericht uit als in onderstaande Figuur 56.

Image Removed

Voorafgaande aan deze uitwisseling, voordat de toets wordt afgenomen, vindt de uitwisseling van de schoolgegevens plaats, inclusief betreffende Onderwijsdeelnemers en Medewerkers.

Randvoorwaarde: Onderwijsinrichting, Onderwijsdeelnemers en Onderwijsmedewerkers informatie

...

Middels bovenstaande interactie is het mogelijk om nieuwe scores en resultaten over te dragen. En het is ook mogelijk om een eerder verstuurde object van “Deelnemerscores en -resultaten” (StudentScoresAndResults) te wijzigen of te verwijderen. Belangrijk hierbij is het betreffende id van dit eerdere object in het object met de wijziging/verwijdering te specificeren. Verder moet ook de wijzigingsdatum (dateLastModified) worden gespecificeerd. Voor het verwijderen van het object moet Status de waarde “Overbodig/vervallen” (Canceled) krijgen.

Voorafgaande aan deze uitwisseling, voordat de toets wordt afgenomen, vindt de uitwisseling van de schoolgegevens plaats, inclusief betreffende Onderwijsdeelnemers en Medewerkers.

Randvoorwaarde: Onderwijsinrichting, Onderwijsdeelnemers en Onderwijsmedewerkers informatie

Randvoorwaardelijk voor het kunnen uitwisselen van het Toetsresultaat is dat de informatie over schoolperiodes, inschrijvingen, toewijzingen en de persoonsgegevens van onderwijsdeelnemers (leerlingen/studenten) en onderwijsmedewerkers (leraar/administrateur) worden uitgewisseld. Deze uitwisseling is van referentiecomponent Administratiesysteem onderwijsdeelnemer en Administratiesysteem onderwijsmedewerker naar de referentiecomponent Digitaal toetssysteem.

...

Voor dit proces betreft het de volgende eisen:

• Een aantal gegevensdiensten zijn vertrouwelijk en vereisen een Verwerkersovereenkomst tussen de Onderwijsorganisatie en de Leverancier.

  • Het betreft de gegevensdiensten:

    • Onderwijsinrichting

    • Onderwijsdeelnemers

    • Onderwijsmedewerkers

    • Leerresultaten

  • De Onderwijsorganisatie heeft derhalve een Verwerkersovereenkomst gesloten met de Leveranciers met de referentiecomponenten:

    • Administratiesysteem onderwijsdeelnemer

    • Administratiesysteem onderwijsmedewerker

    • Administratiesysteem leerresultaten

    • Digitaal toetssysteem

    • Leermiddelendashboard

• De Onderwijsorganisatie heeft de uitwisseling van gegevens geactiveerd conform bovenstaande tabel. Voor meer informatie zie de sectie Regie op gegevens voor de implementatievarianten met een Verzender en Ontvanger.

...

Voor dit proces is de volgende technische interfacedefinitie relevant:

...

• Students API

• Employees API

• Education API

• Association API

De technische interfacedefinitie van het bovenstaande is vastgelegd in:

...