OKE — Examens
Doel & introductie
OKE (Onderwijs Koppeling Examinering — “MBO-toetsafname”) standaardiseert de gegevensuitwisseling in het MBO-examenproces: het uitwisselen van student- en planningsgegevens naar de toets-/examenleveranciers, en het terugleveren van resultaatgegevens.
OKE is een toepassingsprofiel op de Open Onderwijs API (OOAPI) en daarmee een O-koppeling: de afspraken zijn sectorbreed vastgelegd en worden landelijk beheerd. De gezaghebbende specificatie staat op:
https://github.com/NetwerkExamineringDigitalisering/NED-OOAPI
Dit document beschrijft OKE zoals geïmplementeerd in Eduarte Connect en verwijst voor de volledige afsprakenset naar bovenstaande bron.
Aanleiding & context
In het MBO worden toetsen en examens vaak afgenomen door gespecialiseerde toets- en examenleveranciers. Daarvoor moeten studentgegevens en planningsgegevens naar die leveranciers worden gestuurd, en moeten resultaten weer terugkomen in het studentinformatiesysteem. Zonder standaard vraagt elke leverancierskoppeling maatwerk. OKE legt deze uitwisseling vast als één open standaard binnen de keten Toetsafname in het MBO-examenproces.
De ketensamenwerking & rollen
De afsprakenset onderscheidt drie functionele rollen in de keten:
- Deelnemerregistratie (DR/SIS) — het studentinformatiesysteem waarin studenten en hun inschrijvingen voor toetsen zijn geregistreerd.
- Toetsplanning & logistiek (TPL) — plant de zitting (toetsafname) op basis van de deelnemers (vanuit DR) en de resultaten (vanuit TA).
- Toetsafname (TA) — waar de toets wordt afgenomen en de resultaten ontstaan.
Eduarte’s dubbelrol
Binnen OKE vervult Eduarte twee rollen tegelijk: zowel Deelnemerregistratie (SIS) als Toetsplanning (TPL). OKE is daarmee in Eduarte Connect een dubbele koppeling. Per rol worden andere informatiestromen ondersteund:
| Rol | Ondersteunde informatiestromen |
|---|---|
| OKE als SIS (Deelnemerregistratie) | 0 Toetscatalogus · 1 Toetsdeelnemers · 5 Studentresultaat · 6 Analyse-informatie |
| OKE als TPL (Toetsplanning) | 0 Toetscatalogus · 2 Zittingsplan · 3 Toetsdeelnemerresultaat · 4 Zittingsverslag |
De informatiestromen
De keten kent zeven informatiestromen (0 t/m 6):
| Stroom | Naam | Richting | Toelichting |
|---|---|---|---|
| 0 | Toetscatalogus | DR/SIS → TPL en TA | Detailinformatie over de toetsen (dagen/uren, toegestane hulpmiddelen) |
| 1 | Toetsdeelnemers | DR/SIS → TPL | Welke studenten doen mee aan welke toets |
| 2 | Zittingsplan | TPL → TA | De geplande zitting, inclusief studenten en medewerkers |
| 3 | Toetsdeelnemerresultaat | TA → TPL | Aanwezigheid en beoordeling/resultaat per deelnemer |
| 4 | Zittingsverslag | TA → TPL | Proces-verbaal/verslag van de zitting |
| 5 | Studentresultaat | TPL → DR/SIS | Het vastgestelde resultaat met bewijslastdocumenten |
| 6 | Analyse-informatie | (nader te bepalen) | Analyse van toetsresultaten — nog in ontwikkeling |
Het examenproces
De rollen voeren samen de processen van het examenproces uit:
- Inrichten van opleiding en toetsing
- Inschrijven voor opleiding
- Aanmelden voor toets
- Maken en beschikbaar stellen van de toetsplanning
- Afnemen van de toets
- Beoordelen van de toetsafname
- Vaststellen, vastleggen en publiceren van het resultaat
- Reclameren door de student
Scope
OKE dekt de uitwisseling voor:
- Examens én toetsen, zowel summatief als formatief;
- Kennistoetsen én praktijktoetsen (zoals proeve van bekwaamheid, werkstuk of praktijkopdracht);
- Online (digitale) én offline toetsen.
Buiten scope: toetsen/examens in het voortgezet onderwijs (VO). De analyse van toetsresultaten (stroom 6) is nog in ontwikkeling.
Doelgroep & use cases
OKE is bedoeld voor toets- en examenleveranciers en toetsplannings-/afnamesystemen die in de MBO-examenketen samenwerken met Eduarte, en voor scholen die deze keten willen standaardiseren.
Granulariteit & reikwijdte
OKE volgt het OOAPI v5-objectmodel. Zoals geïmplementeerd in Eduarte Connect worden onder meer ontsloten: personen, organisaties, componenten en aanbod (offerings), associaties (inschrijvingen/relaties), groepen (met leden) en documenten.
Status. OKE is niet meer in ontwikkeling, met uitzondering van stroom 6 (Analyse-informatie). De huidige versie is 1.0.1 (versie 1.0 inclusief stroom 6).
Gegevens op hoofdlijnen
| Object | Functionele omschrijving |
|---|---|
| Person | Deelnemer of medewerker (OOAPI-persoon). |
| Organization | Organisatorische eenheid binnen de instelling. |
| Component | Onderdeel van het onderwijs-/toetsaanbod. |
| Offering | Aangeboden opleiding, course of component (toets). |
| Association | Inschrijving/relatie tussen persoon en aanbod. |
| Group | Groep (bijvoorbeeld een zitting of toetsgroep), met leden. |
| Document | Bij de toetsafname horend document. |
Randvoorwaarden & afspraken
- Standaardconform — OKE volgt de landelijke OOAPI/NED-afsprakenset; raadpleeg de officiële specificatie voor de exacte definities, flows en schema’s.
- AVG — er worden persoonsgegevens en resultaten uitgewisseld; verwerk volgens dataminimalisatie en de met de school gemaakte afspraken.
- Toegang & consent — toegang verloopt via Connect; zie de technische specificatie.
Verwijzingen
- Officiële OKE/NED-OOAPI-standaard: https://github.com/NetwerkExamineringDigitalisering/NED-OOAPI
- Technische specificatie: OKE — Technische specificatie (PDF).
- OpenAPI-specificatie: meegeleverd als
OKE_v1.0.yml. - Online referentie: API-referentie van OKE