EKOC — Onderwijscatalogus
Doel & introductie
EKOC (Eduarte Koppeling Onderwijscatalogus) ontsluit en beheert de onderwijscatalogus van Eduarte: de opbouw van de onderwijs- en examenprogramma’s. Denk aan opleidingen, onderwijsproducten, toetsen en resultaatstructuren.
Het doel is dat een partner de catalogus zowel kan uitlezen als kan onderhouden — zodat het onderwijs- en examenprogramma in Eduarte actueel blijft en als basis kan dienen voor andere processen (zoals examinering en resultaatverwerking).
Domein & context
EKOC valt binnen het domein Catalogus van Eduarte Connect en is een E-koppeling (Eduarte-specifiek, Nederlandstalig). Het is een partnerkoppeling die in twee richtingen werkt (lezen én schrijven).
De onderwijscatalogus is een fundament binnen Connect: andere koppelingen en processen bouwen voort op de hier gedefinieerde opleidingen, onderwijsproducten en toetsen. Wijzigingen in de catalogus worden (in de toekomst) via de notificatiekoppeling EKN gesignaleerd.
Doelgroep & use cases
EKOC is bedoeld voor partners die het onderwijs- en examenprogramma beheren of gebruiken (bijvoorbeeld systemen voor curriculum-, toets- of examenbeheer) en voor de school.
Typische use cases:
- Catalogus uitlezen — opleidingen, onderwijsproducten, toetsen en resultaatstructuren ophalen als basis voor andere systemen.
- Catalogus onderhouden — onderwijsproducten, opleidingen, toetsen en resultaatstructuren aanmaken, bijwerken en verwijderen.
- Cohorten beheren — cohorten van een opleiding opvragen en bijwerken.
Granulariteit & reikwijdte
EKOC biedt lees- en schrijfoperaties (CRUD) op de kern van de catalogus, en alleen lezen op de referentiegegevens.
| Onderdeel | Bewerkingen |
|---|---|
| Resultaatstructuren | Lezen, aanmaken, bijwerken, verwijderen |
| Toetsen | Lezen, aanmaken, bijwerken, verwijderen |
| Onderwijsproducten | Lezen, aanmaken, bijwerken, verwijderen |
| Opleidingen (incl. cohorten) | Lezen, aanmaken, bijwerken, verwijderen |
| Onderwijsproductsoorten | Alleen lezen (referentie) |
| Productregelsoorten | Alleen lezen (referentie) |
Functionele flows
De catalogus kent een duidelijke opbouw; bij het inrichten houd je deze samenhang aan:
- Opleiding vastleggen, met de bijbehorende cohorten.
- Onderwijsproducten definiëren (van een bepaalde onderwijsproductsoort).
- Resultaatstructuren vastleggen. Een resultaatstructuur hoort bij een combinatie van code, cohort en onderwijsproduct; die combinatie is uniek.
- Toetsen koppelen aan de resultaatstructuur.
Bij wijzigen en verwijderen gelden afhankelijkheden (zo hoort een toets bij een resultaatstructuur). De technische specificatie beschrijft de validatie- en verwijderregels.
Gegevens op hoofdlijnen
| Object | Functionele omschrijving |
|---|---|
| Opleiding | Een opleiding in de catalogus; bevat cohorten. |
| Cohort | Jaargang/startgroep binnen een opleiding. |
| Onderwijsproduct | Een onderwijs- of examenonderdeel binnen de catalogus. |
| Onderwijsproductsoort | Typering van een onderwijsproduct (referentie). |
| Resultaatstructuur | De structuur van te behalen resultaten (uniek per code + cohort + onderwijsproduct). |
| Toets | Een toets die bij een resultaatstructuur hoort. |
| Productregelsoort | Typering van productregels (referentie). |
Randvoorwaarden & afspraken
- Toegang & consent — gebruik van EKOC verloopt via Connect; zie de technische specificatie voor authenticatie en scope.
- Samenhang & integriteit — de catalogus kent onderlinge afhankelijkheden (uniciteit van resultaatstructuren; toetsen horen bij een resultaatstructuur). Houd hier rekening mee bij aanmaken, bijwerken en verwijderen.
- AVG — de catalogus bevat hoofdzakelijk onderwijsinhoudelijke gegevens en geen of beperkt persoonsgegevens; dataminimalisatie blijft het uitgangspunt.
Verwijzingen
- Technische specificatie: EKOC — Technische specificatie (PDF).