Page Comparison

...

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.

...

• 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)

    • 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, Zowel toets als toetsonderdeel omvat de gegevens Toetsid en Toetsnaam. Binnen de toets is eventueel ook informatie over betreffende Vakgebieden en Leerjaar 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.

...

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 6.Image Removed

...

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 gepsecificeerdgespecificeerd. Voor het verwijderen van het object moet Status de waarde “Overbodig/vervallen” (Canceled) krijgen.

...