EKS — Stamdata
Doel & introductie
EKS (Eduarte Koppeling Stamdata) ontsluit de algemene stamdata uit Eduarte voor afnemende systemen en partners. Stamdata zijn de referentiegegevens die in veel processen terugkomen — denk aan fases, onderwijsperiodes, locaties en organisatie-eenheden.
Het doel van EKS is één betrouwbare bron te bieden voor deze referentiegegevens, zodat aangesloten systemen niet langer afhankelijk zijn van handmatige exports of directe databasetoegang. EKS is bewust alleen-lezen: het ontsluit gegevens, het wijzigt ze niet.
Domein & context
EKS valt binnen het domein Stamdata van Eduarte Connect. Het is een E-koppeling (Eduarte-specifiek, Nederlandstalig): de inhoud is afgestemd op het Eduarte-product en niet op een sectorbrede standaard.
Binnen Connect vormt EKS vaak het vertrekpunt voor een integratie: andere koppelingen verwijzen naar dezelfde referentiegegevens (bijvoorbeeld een onderwijsperiode of een organisatie-eenheid). Door EKS als gedeelde stamdatabron te gebruiken, blijven gegevens consistent over koppelingen heen.
Doelgroep & use cases
EKS is bedoeld voor integratiepartners en schoolsystemen die referentiegegevens uit Eduarte nodig hebben.
Typische use cases:
- Het voeden van een eigen of extern systeem met actuele referentiegegevens (fases, periodes, locaties, teams).
- Het periodiek synchroniseren van stamdata zodat lokale gegevens overeenkomen met Eduarte.
- Het opzoeken van een specifiek stamdata-object op basis van zijn identificatie.
Granulariteit & reikwijdte
EKS biedt uitsluitend leesoperaties (ophalen). Er worden geen gegevens aangemaakt, gewijzigd of verwijderd via EKS.
De koppeling ontsluit de volgende stamdata-objecten:
- Aggregatieniveau
- Taxonomie(element)
- Fase
- Onderwijsperiode
- Organisatie-eenheid
- Locatie
- Team
- Roosterstructuur
- Cohort
- Schaal en Schaalwaarde
Buiten scope: mutaties, deelnemer- of resultaatgegevens, en gegevens die tot andere domeinen behoren (die via de betreffende connectoren worden ontsloten).
Functionele flows
De interactie met EKS volgt twee eenvoudige patronen:
- Lijst ophalen — een afnemer vraagt een lijst van een stamdata-soort op (bijvoorbeeld alle fases). Bij grote lijsten wordt het resultaat in pagina’s geleverd; de afnemer doorloopt de pagina’s tot alle items zijn opgehaald.
- Detail ophalen — met de identificatie
(
id) van een object vraagt de afnemer de details van één specifiek stamdata-object op.
Een gangbare synchronisatie combineert beide: eerst de lijst doorlopen, vervolgens waar nodig de details per object ophalen.
Gegevens op hoofdlijnen
| Object | Functionele omschrijving |
|---|---|
| Aggregatieniveau | Niveau waarop gegevens worden samengevat binnen de organisatiestructuur. |
| Taxonomie(element) | Indeling/classificatie die binnen Eduarte wordt gehanteerd. |
| Fase | Fase binnen de onderwijsstructuur. |
| Onderwijsperiode | Periode waarin onderwijs wordt aangeboden (bijv. een schooljaar of blok). |
| Organisatie-eenheid | Onderdeel van de organisatiestructuur van de school. |
| Locatie | Fysieke locatie van de instelling. |
| Team | Samenwerkingsverband van medewerkers binnen de organisatie. |
| Roosterstructuur | Structuur die ten grondslag ligt aan de roostering. |
| Cohort | Groep deelnemers die in dezelfde periode start. |
| Schaal / Schaalwaarde | Beoordelings- of waarderingsschaal en de bijbehorende waarden. |
Randvoorwaarden & afspraken
- Toegang & consent — gebruik van EKS vereist een afspraak met de school (consent) en toegang via Connect (zie de technische specificatie voor authenticatie).
- AVG — EKS ontsluit hoofdzakelijk referentiegegevens met beperkte of geen persoonsgegevens; dataminimalisatie blijft het uitgangspunt.
- Actualiteit — afnemers houden hun lokale kopie actueel door periodiek te synchroniseren; EKS is de leidende bron.
Verwijzingen
- Technische specificatie: EKS — Technische specificatie (PDF).
- Canonieke, interactieve referentie: API-referentie van EKS