Gegevensmodel en –definities
- Koen Voermans
Titel | Gegevensmodel en –definities |
Status | In ontwikkeling ROSA-Architectuurscan BEsluitvorming in beheer |
Versie | 1.0.0 |
Datum | 27 Mei 2024 |
Auteur | Architectenraad Edu-V |
Acties | Werkgroepen:
|
Wijzigingsverzoeken vanuit de werkgroepen
De gehanteerde definities zijn tot stand gekomen in afstemming met de Adviesgroep Samenhang Onderwijsarchitecturen van Edustandaard. Hiermee is er een basis gelegd voor de werkgroepen om hen een gemeenschappelijk vocabulaire te geven voor het uitwerken van de praktijksituaties.
Indien in de werkgroepen blijkt dat een benaming niet aansluit bij de praktijk dan is het mogelijk om een wijzigingsverzoek te doen. Dit wijzigingsverzoek wordt besproken in de Architectenraad Edu-V en kan eventueel ook leiden tot afstemming met de Adviesgroep Samenhang Onderwijsarchitecturen.
Op deze pagina’s zijn de definities van gegevens gedefinieerd die uitgewisseld worden binnen het Ecosysteem. We starten met een conceptueel model voor leer- en onderwijsmiddelen en activiteitsgegevens. Op basis van dit conceptueel model is het gegevensmodel in detail uitgewerkt. Tot slot zijn per domein de definities uitgewerkt.
- 1 Conceptueel model: Leer- en onderwijsmiddelen
- 2 Conceptueel model: Activiteitsgegevens
- 3 Gegevensmodel
- 4 Definities in Architectuur
- 5 Definities in domein Identiteiten
- 6 Definities in domein Instemming
- 7 Definities in domein Administratie school
- 8 Definities in domein Aanbod leermiddelen
- 9 Definities in domein Inkoop leermiddelen
- 10 Definities in domein Verwerving leermiddelen
- 11 Definities in domein Uitvoering onderwijs
- 12 Definities in domein Evaluatie onderwijs
Conceptueel model: Leer- en onderwijsmiddelen
In het Edu-V Afsprakenstelsel maken we afspraken over het uitwisselen van gegevens over leer- en onderwijsmiddelen. Hierbij zien we Digitale onderwijsmiddelen als alle digitale applicaties die door een onderwijsorganisatie of leverancier gebruikt worden voor de domeinen van het Edu-V afsprakenstelsel. Deze onderwijsmiddelen zijn binnen de architectuur nader uitgewerkt als referentiecomponenten.
Een leermiddel is conform de definitie van de ROSA een product dat is samengesteld uit leermateriaal en dat onder bepaalde condities verkregen en gebruikt kan worden. Onderstaande figuur geeft in een conceptueel model de definities weer die gerelateerd zijn aan een Leermiddel.
We maken onderscheid tussen leermiddelen, leermodules en leermaterialen. Leermiddelen zijn producten die je (al dan niet tegen betaling) kunt verwerven als onderwijsorganisatie of particulier. Een product kan een enkel leermiddel zijn, maar kan ook een set van leermiddelen betreffen. Denk bijvoorbeeld aan een bundel van digitale leermiddelen of een combiproduct bestaande uit een fysiek en een digitaal leermiddel.
Leermaterialen zijn onder meer de opdrachten, instructies, toetsen, werkstukken, praktijkopdrachten, lesbrieven, digibordlessen die toegepast worden in de uitvoering van het onderwijs. Deze leermaterialen kunnen klassikaal, begeleid of zelfstandig voor een individu of voor een groep, met als doel leren, toetsen of examineren benut worden in het onderwijs. Leermaterialen kunnen allerlei verschillende vormen hebben zoals tekst, video, audio of beeld. Het leermateriaal is daarmee de daadwerkelijke content uit het leermiddel. Leermaterialen kunnen gecombineerd worden in een leermodule. De opsommingen uit deze paragraaf zijn ter verduidelijking en hebben niet als doel om volledig te zijn.
Een Leermiddel is een samenstelling van één of meerdere leermodules en/of leermaterialen. De leermiddelstructuur beschrijft deze samenstelling. Zo is het altijd mogelijk om te herleiden uit welke leermodules en/of leermaterialen een leermiddel bestaat.
Conceptueel model: Activiteitsgegevens
In de vorige paragraaf is het conceptueel model van leermiddelen toegelicht. Onderwijsdeelnemers en Onderwijsmedewerkers passen leermiddelen toe in de uitvoering van het onderwijs. Dit resulteert in activiteitsgegevens over leermiddelen. We onderscheiden in het Edu-V Afsprakenstelsel drie varianten van activiteitsgegevens: leermiddelgebruik, leermateriaalgebruik en leerresultaat.
| Leermiddelgebruik | Leermateriaalgebruik | Leerresultaat |
|---|---|---|---|
Context | Geld-goederenstroom | Leren | Leren, Toetsen, Examineren, Verantwoorden |
Proces | Inkoop | Onderwijs | Onderwijs en examinering |
Grootheid | Leermiddel uit Leermiddelencatalogus | Leermodule of Leermateriaal uit Leermaterialencatalogus | Leermodule of Leermateriaal uit leermaterialencatalogus |
Eenheid | Frequentie | Voltooiing | Uitkomst |
Voorbeeld | Onderwijsdeelnemer heeft Leermiddel A voor het eerst gebruikt op 27-1 en voor het laatst op 31-3 | Onderwijsdeelnemer heeft Leermateriaal A gestart of afgerond met optioneel een signalering en een deeplink naar feedback | Onderwijsdeelnemer heeft een 7,4 voor Leermateriaal A dat ingezet is als proefwerk |
De activiteitsgegevens zijn te relateren aan het conceptueel model van een leermiddel. Dit is visueel weergegeven in onderstaande figuur.
Leermiddelgebruik beschrijft de frequentie van gebruik van leermiddelen. Een specifieke variant van een gebruiksgegeven is de leermiddelactivatie. De leermiddelactivatie betreft de eerste keer dat een leermiddel gebruikt wordt door een onderwijsdeelnemer of onderwijsmedewerker. Na de in gebruik name heeft de onderwijsdeelnemer of onderwijsmedewerker een licentie op het product.
Leermateriaalgebruik worden gerapporteerd over leermaterialen. Leermateriaalgebruik ontstaat zodra een onderwijsdeelnemer leermaterialen gebruikt. Via leermateriaalgebruik kunnen onderwijsmedewerkers procesinformatie verkrijgen over de leervoortgang van onderwijsdeelnemers. Leermateriaalgebruik geeft inzicht of een leermateriaal gestart, gestaakt of afgerond is. Tegelijkertijd kan leermateriaalgebruik ook een notificatie bevatten voor de onderwijsmedewerker. Deze notificatie kan bijvoorbeeld een aanbeveling zijn om meer informatie te gaan bekijken binnen de uitgebreide rapportageomgeving van de gebruiksomgeving digitaal leermateriaal.
Leerresultaten bevatten de uitkomst van een afgerond leermateriaal van een Onderwijsdeelnemer. Leerresultaten worden zowel binnen het onderwijs, maar ook binnen de examinering en de verantwoording gebruikt. Daar waar leermateriaalgebruik inzicht geeft in procesinformatie, geven leerresultaten inzicht in de uitkomsten van dit proces. Leerresultaten kunnen worden gebruikt om inzicht te krijgen in de inhoudelijke leervoortgang van een onderwijsdeelnemer. Ook kunnen leerresultaten op bijvoorbeeld toetsen of examens worden geadministreerd in het administratiesysteem leerresultaten.
Gegevensmodel
Edu-V streeft naar een efficiënte, veilige, betrouwbare en toekomstbestendige infrastructuur en ecosysteem van digitale leer– en onderwijsmiddelen. In het architectuurkader is een vertaling gemaakt van deze scope naar de domeinen:
Deze functionele domeinen zijn nader uitgewerkt op de pagina domeinen. Op deze pagina worden de entiteiten uit deze domeinen gedefineerd en de onderlinge relaties en kardinaliteit weergegeven in een gegevensmodel.
Bovenstaande figuur geeft het Entity Relationship Diagram van alle entiteiten en cruciale attributen uit het Edu-V ecosysteem weer. In het restant van deze pagina worden per domein de entiteiten nader toegelicht.
Definities in Architectuur
Het Architectuurkader vertelt ons welke referentiecomponenten verantwoordelijk zijn voor de uitwisseling van gegevens in gegevensdiensten, en aan welke technische en veiligheidseisen iedere uitwisseling moet voldoen.
In het architectuurkader worden onder meer de volgende definities gehanteerd:
Naam | Technical term | Type | Omschrijving | Synoniem of voorbeeld |
|---|---|---|---|---|
Component | Definitie | Een functionele afbakening van een modulair, zelfstandig inzetbaar en vervangbaar (deel van een) systeem. |
| |
Gegevensdienst | Application service | Entiteit | Een verzameling van afspraken voor gegevensaanbieders en gegevensafnemer over het gebruik van informatiestandaarden. | |
– | Entiteit | Een zelfstandige eenheid van informatie die betekenis heeft en daardoor bruikbaar c.q. van belang is binnen een bepaalde context. | Gegevenssoort | |
Gegevensaanbieder | Data provider | Definitie | Een leverancier die gegevens verwerkt namens een gegevenshouder en deze beschikbaar stelt als bron of verzender aan gegevensafnemers. | |
Gegevensafnemer | Data consumer | Definitie | Een leverancier die gegevens verwerkt namens een gegevenshouder en deze afneemt of ontvangt van een gegevensaanbieder. | |
Gegevenshouder | – | Definitie | Een onderwijsorganisatie die gegevens laat verwerken door leveranciers en gegevens na autorisatie laat uitwisselen tussen gegevensaanbieders en gegevensafnemers. |
|
Transactierol | – | Definitie | De rol die een gegevensaanbieder of gegevensaanbieder vervult in een gegevensdienst. |
|
Bron | – | Transactierol | De Bron is een transactierol die een gegevensaanbieder kan vervullen in een gegevensdienst. De gegevensaanbieder biedt een resourceserver aan waar informatieobjecten opgevraagd kunnen worden door gegevensafnemers in de transactierol Afnemer. |
|
Afnemer | – | Transactierol | De Afnemer is een transactierol die de gegevensafnemer kan vervullen in een gegevensdienst. De gegevensafnemer heeft een Client om een bevraging te doen op de resourceserver van een gegevensaanbieder in de transactierol Bron. |
|
Verzender | – | Transactierol | De Verzender is een transactierol die een gegevensaanbieder kan vervullen in een gegevensdienst. De gegevensaanbieder heeft een Client om een melding of terugmelding te doen op de resourceserver van een gegevensafnemer in de transactierol Ontvanger. |
|
Ontvanger | – | Transactierol | De Ontvanger is een transactierol die een gegevensafnemer kan vervullen in een gegevensdienst. De gegevensafnemer biedt een resourceserver aan waar informatieobjecten gemeld of teruggemeld kunnen worden door gegevensaanbieders in de transactierol Verzender. |
|
Client | – | Definitie | Een client is een applicatie of een computersysteem met toegang tot een ander systeem, de server, via een netwerk. |
|
Resourceserver | – | Definitie | Een resourceserver is een applicatie of een computersysteem dat informatieobjecten via een netwerk beschikbaar maakt voor Clients. | API Koppelvlak |
Autorisatieserver | – | Definitie | Een autorisatieserver is een applicatie of computersysteem die de digitale identiteit van een Client vaststelt middels identificatie en authenticatie. |
|
Definities in domein Identiteiten
Het domein Identiteiten bevat alle relevante gegevens over de natuurlijke personen en de organisaties die betrokken zijn in het Edu-V afsprakenstelsel. Ook bevat het domein entiteiten die een rol spelen in de identificatie en authenticatie van natuurlijke personen.
De entiteiten zijn nader uitgewerkt in onderstaand overzicht.
Naam | Technical term | Type | Omschrijving | Synoniem of voorbeeld |
|---|---|---|---|---|
board | Entiteit | De rechtspersoon die formeel verantwoordelijk is voor het onderwijs dat door een onderwijsverzorgende organisatie wordt aangeboden. |
| |
school | Entiteit | Daar waar een onderwijsdeelnemer is ingeschreven en waar het onderwijs wordt uitgevoerd. | School | |
location | Entiteit | Een plek waar onderwijs wordt aangeboden en gevolgd. Dit kan een adres zijn, maar ook een gebouw, sportveld, schip of een andere plaats. |
| |
Eindgebruiker | user | Entiteit | De verzamelnaam voor gebruikers van leer- en onderwijsmiddelen. Een eindgebruiker kan onderwijsdeelnemer, onderwijsmedewerker of betrokkene zijn. |
|
student | Entiteit | Een natuurlijk persoon die deelneemt aan een onderwijsactiviteit om zich kennis, vaardigheden en attitudes eigen te maken. | Student Leerling | |
employee | Entiteit | Een natuurlijk persoon die op grond van een overeenkomst werkzaam is voor een onderwijsorganisatie. |
| |
Betrokkene | N.t.b. | Entiteit | Een natuurlijk persoon die betrokken is bij een onderwijsorganisatie niet zijnde als onderwijsdeelnemer of onderwijsmedwerker. | Wettelijk vertegenwoordiger zoals ouder of voogd |
N.t.b. | Entiteit | Uitkomst van een authenticatie die is uitgevoerd door een onafhankelijke partij. De identiteitsverklaring bevat de attributen waarover de verklaring gaat. |
| |
Accountgegevens | – | Definitie | Minimale set aan gegevens waarmee Diensten hun authenticatie- en autorisatiebeslissing en basisfunctionaliteit mee kunnen uitvoeren. Accountgegevens worden meegeleverd in de ID-verklaring. |
|
Profielgegevens | – | Definitie | Uitgebreide set persoonsgegevens, vaak specifiek samengesteld voor Diensten. Profielgegevens worden geprovisioned, in een apart proces dat los staat van authenticatie. |
|
– | Entiteit | Een afgebakende prestatie van een dienstverlener, die voorziet in een behoefte van haar omgeving (de afnemers). | In het Edu-V afsprakenstelsel wordt de Dienst ingevuld met de term Referentiecomponent. | |
– | Entiteit | De persoon of organisatie die voorziet in het leveren van een afgebakende prestatie (dienst) aan haar omgeving (de afnemers). | Dienstaanbieder Service provider In het Edu-V afsprakenstelsel spreken we van Leverancier. |
Definities in domein Instemming
Het domein Instemming bevat de gegevens die van belang zijn voor Regie op gegevens vanuit een onderwijsorganisatie.
De entiteiten zijn nader uitgewerkt in onderstaand overzicht.
Naam | Technical term | Type | Omschrijving | Synoniem of voorbeeld |
|---|---|---|---|---|
ConsentVerlening | consent | Entiteit | De consentverlening bevat de registratie van een autorisatie verleend door een gegevenshouder bij de gegevensaanbieder voor uitwisseling van gegevens naar een gegevensafnemer. | Toestemming Autorisatie |
ConsentBevestiging | consent | Entiteit | De consentbevestiging bevat de registratie van verwerking van een consentverlening bij een gegevensafnemer. |
|
ConsentVerzoek | consent | Entiteit | Het consentverzoek bevat een verzoek vanuit de gegevensafnemer richting de gegevensaanbieder om een gegevensuitwisseling te laten autoriseren naar de gegevensafnemer. |
|
ConsentIntrekking | consent | Entiteit | De consentintrekking bevat een melding dat de gegevensuitwisseling tussen gegevensaanbieder en gegevensafnemer ten behoeve van een gegevenshouder niet meer geautoriseerd is. |
|
Verwerkers-overeenkomst | agreement | Entiteit | Een verwerkersovereenkomst bevat de afspraken die de verwerkingsverantwoordelijke en de verwerker hebben gemaakt over de verwerkingen die de verwerker mag uitvoeren van en voor de verwerkingsverantwoordelijke. | In het Edu-V afsprakenstelsel is het onderwijsbestuur de verwerkingsverantwoordelijke en is een leverancier een verwerker. |
Definities in domein Administratie school
Het domein Administratie school bevat alle relevante gegevens uit de administratiesystemen van de onderwijsorganisatie. Binnen Edu-V worden deze gegevens geleverd door de referentiecomponenten Administratiesysteem onderwijsdeelnemer en Administratiesysteem onderwijsmedewerker. De centrale entiteiten zijn hierbij de Onderwijsdeelnemer en de Onderwijsmedewerker die respectievelijk onderwijs volgen of geven op een Onderwijsaanbieder in een bepaalde SchoolPeriode.
In een specifieke SchoolPeriode is een Onderwijsdeelnemer ingeschreven op een AangebodenOpleiding en volgt diverse AangebodenVakken en is ingeroosterd in één of meerdere Groepen. Een Onderwijsmedewerker is toegewezen aan een Groep of aan een Onderwijsdeelnemer als klassendocent, vakdocent of begeleider.
De entiteiten zijn nader uitgewerkt in onderstaand overzicht. Het gegevensmodel vanuit de administratiesystemen is nader uitgewerkt op de pagina Administratiesystemen onderwijsdeelnemer en -medewerker.
Naam | Technical term | Type | Omschrijving | Synoniem of voorbeeld |
|---|---|---|---|---|
Onderwijsaanbieder | school | Entiteit | Zie definitie bij identiteiten |
|
Onderwijsdeelnemer | student | Entiteit | Zie definitie bij identiteiten |
|
Onderwijsmedewerker | employee | Entiteit | Zie definitie bij identiteiten |
|
SchoolPeriode | schoolPeriod | Entiteit | Een periode waarin onderwijs wordt gegeven. | Schooljaar, Semester, Trimester, Blok |
AangebodenOpleiding | studyOffering | Entiteit | Een opleiding met optioneel het leerjaar dat aangeboden wordt door een onderwijsaanbieder en waarop een onderwijsdeelnemer kan zijn ingeschreven. | Basisschool leerjaar 1 VWO onderbouw atheneum leerjaar 2
|
Onderwijsniveau | studyLevel | Attribuut | Het onderwijsniveau van een AangebodenOpleiding | VO-PRO, VO-VMBO-BB, VO-VMBO-KB, VO-VMBO-GL, VO-VMBO-TL, VO-HAVO, VO-VWO |
Leerjaar | studyYear | Attribuut | Het leerjaar van een AangebodenOpleiding | Leerjaar 1 |
AangebodenVak | subjectOffering | Entiteit | Een AangebodenVak kan onderdeel zijn van een of meerdere AangebodenOpleidingen. Ook kan een AangebodenVak aanvullend zijn en geen onderdeel zijn van een AangebodenOpleiding. | Wiskunde, VO-HAVO, leerjaar 3 Maatschappijleer, VO-VWO, leerjaar 1, 2 en 3 (hele onderbouw) |
Vak | subject | Attribuut | Een onderdeel van het geheel aan kennis en vaardigheden die via onderwijs aan de onderwijsdeelnemer wordt aangeboden. | Wiskunde |
Inschrijving | enrollment | Entiteit | De inschrijving beschrijft de periode waarin een onderwijsdeelnemer is ingeschreven op een AangebodenOpleiding van een onderwijsaanbieder of een AangebodenVak volgt bij een onderwijsaanbieder. |
|
Groep | group | Entiteit | Een unieke samenstelling van onderwijsdeelnemers die onderwijs volgen. We onderscheiden stamgroepen en lesgroepen. Zie hieronder. | Stamgroep Lesgroep |
Stamgroep | group (type: | Entiteit | Een stamgroep waar één of meerdere Onderwijsdeelnemers zijn ingeroosterd. Dit is de organisatorische groep waartoe een Onderwijsdeelnemer in een bepaalde SchoolPeriode behoort. Een Onderwijsmedewerker kan een toewijzing hebben als klassendocent ( | Stamklas Mentorgroep |
Lesgroep | group (type: | Entiteit | Een lesgroep van één of meerdere Onderwijsdeelnemers die onderwijs krijgen van één of meerdere Onderwijsmedewerkers. Een Onderwijsmedewerker kan een toewijzing hebben als vakdocent ( | VWO-4-Wiskunde-1 Groep 3a |
Toewijzing | assignment | Entiteit | Een toewijzing van een onderwijsmedewerker aan een groep als klassendocent ( |
|
Definities in domein Aanbod leermiddelen
Het domein Aanbod leermiddelen bevat alle relevante gegevens over de publicatie van leermiddelen. In het Edu-V ecosysteem wordt deze gegevens beschreven in de referentiecomponent Leveranciersspecifieke leermiddelencatalogus. De centrale entiteit is hierbij het Leermiddel.
In een ProductBeschrijving is alle metadata over te verwerven Leermiddel(en) terug te vinden. In het Edu-V ecosysteem wordt onderscheid gemaakt tussen de LeermiddelBeschrijving en de SetBeschrijving. Een LeermiddelBeschrijving bevat de metadata van een Product dat bestaat uit één fysiek, digitaal of combi Leermiddel. Een SetBeschrijving bevat de metadata van een te verwerven Product dat bestaat uit meerdere fysieke en/of digitale Leermiddelen.
Alle ProductBeschrijvingen die verwijzen naar een digitaal leermiddel, een combi leermiddel of een set van digitale leermiddelen bevatten het attribuut Toegangslink. De Toegangslink is een uniforme link die door een Onderwijsdeelnemer of Onderwijsmedewerker gebruikt kan worden om naar het Leermiddel te navigeren.
De entiteiten zijn nader uitgewerkt in onderstaand overzicht.
Naam | Technical term | Type | Omschrijving | Synoniem of voorbeeld |
|---|---|---|---|---|
Leermiddel | – | Entiteit | Een samenstelling van Leermaterialen en/of Leermodules. | Getal en Ruimte HAVO 3 Leerwerkboek Getal en Ruimte HAVO 3 online leeromgeving Kijk- en Luistertoetsen HAVO |
Productbeschrijving | product bundledProducts | Entiteit | De ProductBeschrijving is een LeermiddelBeschrijving of een SetBeschrijving. Iedere ProductBeschrijving is een verkoopbare eenheid en heeft een unieke identifier (EAN). In de beschrijving is alle cruciale informatie beschikbaar voor het verwerven en gebruiken, waaronder:
ProductBeschrijvingen van een digitaal leermiddel, een combi leermiddel of een set van digitale leermiddelen bevatten een Toegangslink. | - |
LeermiddelBeschrijving | – | Product-Beschrijving | De LeermiddelBeschrijving is een variant van een ProductBeschrijving en bevat daarmee ook alle info zoals beschreven bij de entiteit ProductBeschrijving. In de LeermiddelBeschrijving wordt de relevante informatie voor een Leermiddel vastgelegd. Een Leermiddel kan fysiek, digitaal of combi zijn. Afhankelijk van de inhoud van het Leermiddel betreft het een verwijzing naar één of meerdere Leermiddelstructuur-Beschrijvingen. | Getal en Ruimte HAVO 3 Leerwerkboek Licentie Getal en Ruimte HAVO 3 Digitale Toetsen Wiskunde HAVO 3 |
SetBeschrijving | – | Product-Beschrijving | De SetBeschrijving is een variant van een ProductBeschrijving en bevat daarmee ook alle info zoals beschreven bij de entiteit ProductBeschrijving. Een Set is een bundel van meerdere Leermiddelen. Dit kunnen fysieke en/of digitale leermiddelen zijn. De SetBeschrijving legt deze samenhang vast in een set van meerdere LeermiddelBeschrijvingen. Een LeermiddelBeschrijving kan onderdeel zijn van meerdere SetBeschrijvingen. | De combinatie van: · Getal en Ruimte HAVO 3 Leerwerkboek · Licentie Getal en Ruimte HAVO 3 online leeromgeving · Digitale Toetsen Wiskunde HAVO 3 |
Toegangslink | accessUrl | Attribuut | De URL die Onderwijsdeelnemers of Onderwijsmedewerkers kunnen gebruiken om te navigeren naar het Leermiddel. De Toegangslink wordt gebruikt door de referentiecomponent Leermiddelenportaal om een overzicht van leermiddelen voor een Onderwijsdeelnemer of Onderwijsmedewerker te tonen. | www.leermiddelenaanbieder.nl/?EAN |
Definities in domein Inkoop leermiddelen
Het domein Inkoop leermiddelen bevat alle relevante gegevens ten behoeve van het B2B inkopen van leermiddelen door een leverancier bij een aanbieder van de leermiddelen. De leveranciers hebben bilaterale afspraken ten behoeve van de verkoop van Leermiddelen aan Onderwijsorganisaties en/of Particulieren. Deze afspraken zijn vastgelegd in een Contract.
Leveranciers kunnen ervoor kiezen om meerdere Contracten te hebben met verschillende afspraken. Door in de berichten te verwijzen naar deze contracten kunnen alle relevante uit het Edu-V ecosysteem worden gerapporteerd en kan de gesloten geld-goederenstroom worden geborgd.
Bij het Inkopen van Leermiddelen plaatst de afnemende Leverancier een OrderVerzoek bij de leverancier die de leermiddelen aanbiedt. De aanbiedende leverancier bevestigt de verwerking van het OrderVerzoek middels een OrderBevestiging. Op een vergelijkbare manier kan een afnemende leverancier ook een CreditorderVerzoek indienen en kan de aanbiedende leverancier na verwerking reageren met een Creditorderbevestiging.
De entiteiten zijn nader uitgewerkt in onderstaand overzicht.
Naam | Technical term | Type | Omschrijving | Synoniem of voorbeeld |
|---|---|---|---|---|
Contract | contract | Entiteit | Een Contract betreft een bilaterale overeenkomst tussen leveranciers waarbinnen (Credit)orderVerzoeken worden geplaatst en Aanspraken worden geregistreerd. Het Contract is bij beide leveranciers bekend en kan bepalingen bevatten omtrent de te hanteren business rules voor het verwerken van annuleringen, wijzigingen, (de)blokkeringen en creditorders. | Raamcontract voor alle combi producten Contract voor een specifieke tender van een onderwijsorganisatie. SalesorderlineId van een onderwijsorganisatie of particulier. |
OrderVerzoek | orderRequest | Entiteit | In een OrderVerzoek plaatst een afnemende leverancier een Order bij aanbiedende leverancier om een Leermiddel in te kopen. | Licentie Getal en Ruimte HAVO 3 100 stuks Inkoopordernummer WO-1234 |
OrderBevestiging | orderConfirmation | Entiteit | In een OrderBevestiging bevestigt de aanbiedende leverancier aan de afnemende leverancier of de Order al dan niet succesvol is geplaatst. | Licentie Getal en Ruimte HAVO 3 100 stuks Inkoopordernummer WO-1234 Verkoopordernummer AO-6789 |
CreditorderVerzoek | creditOrderRequest | Entiteit | In een CreditorderVerzoek annuleert een afnemende leverancier een eerdere Order. | Inkoopordernummer WO-1234 Verkoopordernummer AO-6789 Annuleren |
CreditorderBevestiging | creditOrderConfirmation | Entiteit | In een CreditorderBevestiging bevestigt de aanbiedende leverancier aan de afnemende leverancier of het de oorspronkelijke Order al dan niet succesvol is geannuleerd en of het CreditorderVerzoek wordt geaccepteerd. | Inkoopordernummer WO-1234 Verkoopordernummer AO-6789 Annulering (niet) geaccepteerd |
Definities in domein Verwerving leermiddelen
Het domein Verwerving leermiddelen bevat alle relevante informatie ten behoeve van het verwerven en in gebruik nemen van leermiddelen door een Besteller. In het Edu-V ecosysteem kunnen Leermiddelen worden verworven door een Particulier of een Onderwijsaanbieder. In een Leveringsorder wordt gespecificeerd op basis van welke autorisatieregels de aanspraken op een besteld leermiddel kunnen worden toegekend. Een Aanspraak is het recht om een Leermiddel in een afgesproken Activatieperiode in gebruik te nemen en in een Licentieperiode te mogen gebruiken.
In de leveringsorder wordt in een Autorisatieregel de kenmerken gedefineerd waaraan een Onderwijsdeelnemer of Onderwijsmedewerker dient te voldoen om een Leermiddel in gebruik te mogen nemen. Er wordt onderscheid gemaakt in Open levervarianten en Individuele levervarianten. Open levervarianten gelden voor meerdere Onderwijsdeelnemers. Individuele levervarianten hebben betrekking op specifieke Onderwijsdeelnemer(s) of Onderwijsmedewerkers.
Zodra een Onderwijsdeelnemer of een Onderwijsmedewerker een Leermiddel in gebruik hebben genomen ontstaat er een Leermiddelactivatie moment. Dit moment wordt geregistreerd en markeert de start van de Licentieperiode. De aanspraak wijzigt in status naar gelicenseerd.
De entiteiten en definities zijn nader uitgewerkt in onderstaand overzicht.
Naam | Technical term | Type | Omschrijving | Synoniem of voorbeeld |
|---|---|---|---|---|
Leermiddelenaanbieder | publisher | Definitie | Een leverancier die leermiddelen ontwikkelt en exploiteert. | - |
Leermiddelenverkoper | reseller | Definitie | Een leverancier die leermiddelen van leermiddelenaanbieders verkoopt. |
|
Besteller | buyer | Entiteit | Een Besteller is een Onderwijsaanbieder of een Particulier. | - |
Onderwijsaanbieder | school | Besteller | Zie definitie bij identiteiten |
|
Particulier | customer | Besteller | Een individu die een Leermiddel particulier koopt. | Ouder/Verzorger of student (bijvoorbeeld van toepassing in het mbo) |
Bestelling |
| Definitie | Een besteller plaatst een bestelling voor één of meerdere fysieke, combi of digitale leermiddelen bij een bestelomgeving leermiddelen |
|
Leveringsorder | deliveryOrder | Entiteit | Een opdracht om een digitaal leermiddel uit een bestelling te gaan leveren conform de gedefinieerde levervariant. |
|
Autorisatieregel | – | Definitie | Een autorisatieregel definieert de kenmerken waaraan een Onderwijsdeelnemer of Onderwijsmedewerker dient te voldoen om een Leermiddel in gebruik te mogen nemen. | - |
Activatieperiode | activationPeriod | Definitie | De activatieperiode is gespecificeerd in een Aanspraak en betreft de periode waarbinnen een Onderwijsdeelnemer of Onderwijsmedewerker een Leermiddel in gebruik kan nemen. | - |
Licentieperiode | – | Definitie | De licentieperiode betreft de periode waarbinnen een Onderwijsdeelnemer of Onderwijsmedewerker een Leermiddel kan gebruiken. | - |
Open levervariant | open entitlement | Definitie | Bij een open levervariant geldt een algemene autorisatieregel waaraan meerdere Onderwijsdeelnemers kunnen voldoen. | Levervarianten met onderwijsaanbieder als besteller:
|
Individuele levervariant | individual entitlement | Definitie | Bij een individuele levervariant geldt een specifieke autorisatieregel waaraan een enkele Onderwijsdeelnemer of Onderwijsmedewerker kan voldoen. In een individuele levervariant wordt de Onderwijsdeelnemer of de Onderwijsmedewerker gespecificeerd met zijn ID. Als alternatief kan in een individuele levervariant ook een niet eerder ingewisselde Activatiecode worden gespecificeerd. | Levervarianten met ondrewijsaanbieder als besteller:
Levervarianten met particulier als besteller:
|
Leveringsorder | deliveryOrder
| Leverings-order | Een leveringsorder (open levervariant met onderwijsaanbieder als besteller) met als autorisatieregel dat alle Onderwijsdeelnemers van de onderwijsaanbieder een aanspraak krijgen op het leermiddel. De onderwijsaanbieder is gespecificeerd in de leveringsorder met haar ID. | Het Hooghuis Toetsplatform Woots |
Leveringsorder | deliveryOrder
| Leverings-order | Een leveringsorder (open levervariant met onderwijsaanbieder als besteller) met als autorisatieregel dat alle onderwijsdeelnemers die ingeschreven zijn op één of meerdere gespecificeerde AangebodenOpleidingen een aanspraak krijgen op het leermiddel. De AangebodenOpleidingen zijn gespecificeerd in de leveringsorder met hun IDs. | Het Hooghuis in Oss Licentie Getal en Ruimte AangebodenOpleiding havo-onderbouw-leerjaar-1 vwo-onderbouw-leerjaar-1
|
Leveringsorder | deliveryOrder
| Leverings-order | Een leveringsorder (open levervariant met onderwijsaanbieder als besteller) met als autorisatieregel dat alle onderwijsdeelnemers die ingeschreven zijn op één of meerdere gespecificeerde AangebodenVakken een aanspraak krijgen op het leermiddel. De AangebodenVakken zijn gespecificeerd in de leveringsorder met hun IDs. | Het Hooghuis in Oss Licentie Getal en Ruimte HAVO 3 Wiskunde B
|
Leveringsorder | deliveryOrder
| Leverings-order | Een leveringsorder (open levervariant met onderwijsaanbieder als besteller) met als autorisatieregel dat alle onderwijsdeelnemers die deelnemer zijn van een Groep een aanspraak krijgen op het leermiddel. De Groepen zijn gespecificeerd in de leveringsorder met hun IDs. | Het Hooghuis in Oss vwo3a groep1a
|
Leveringsorder | deliveryOrder
| Leverings-order | Een leveringsorder (individuele levervariant met onderwijsaanbieder als besteller) met als autorisatieregel dat alle gespecificeerde onderwijsdeelnemers een aanspraak krijgen op het leermiddel. De onderwijsdeelnemers zijn gespecificeerd in de leveringsorder met hun IDs. | Het Hooghuis in Oss Licentie Getal en Ruimte HAVO 3 ECK iD’s / userIds Onderwijsdeelnemers |
Leveringsorder | deliveryOrder
| Leverings-order | Een leveringsorder (individuele levervariant met onderwijsaanbieder als besteller) met als autorisatieregel dat alle gespecificeerde onderwijsmedewerkers een aanspraak krijgen op het leermiddel. De onderwijsmedewerkers zijn gespecificeerd in de leveringsorder met hun IDs. | Het Hooghuis in Oss Docentmateriaal licentie Getal en Ruimte HAVO 3 userIds Onderwijsmedewerkers |
Leveringsorder | deliveryOrder
| Leverings-order | Een leveringsorder (individuele levervariant met onderwijsaanbieder als besteller) met als autorisatieregel dat alle eindgebruikers die beschikken over een geldige activatiecode het leermiddel in gebruik mogen nemen. De activatiecodes zijn gespecificeerd in de leveringsorder. | Het Hooghuis in Oss Docentmateriaal licentie Getal en Ruimte HAVO 3 Activatiecodes |
Leveringsorder | deliveryOrder
| Leverings-order | Een leveringsorder (individuele levervariant met particulier als besteller) met als autorisatieregel dat de gespecificeerde onderwijsdeelnemer een aanspraak krijgt op het leermiddel. De onderwijsdeelnemer is gespecificeerd in de leveringsorder met een ID. | Licentie Getal en Ruimte HAVO 3 ECK iD / userIds Onderwijsdeelnemer |
Leveringsorder Particulier met activatiecode | deliveryOrder
| Leverings-order | Een leveringsorder (individuele levervariant met particulier als besteller) met als autorisatieregel dat de eindgebruiker die beschikt over de geldige activatiecode het leermiddel in gebruik mag nemen De activatiecode is gespecificeerd in de leveringsorder. | Licentie Getal en Ruimte HAVO 3 Activatiecode |
Aanspraak | entitlement | Entiteit | Een Aanspraak is het recht om een leermiddel in een afgesproken Activatieperiode in gebruik te nemen en in een Licentieperiode te mogen gebruiken. | Het Hooghuis in Oss Licentie Getal en Ruimte HAVO 3 Voor: Onderwijsdeelnemer met ID 123456789 Activatieperiode 1-8-2022 tot 31-7-2023 Licentieperiode: één jaar na in gebruik name of één schooljaar |
Leermiddelactivatie | initialActivation | Entiteit | De Leermiddelactivatie ontstaat zodra een Onderwijsdeelnemer of Onderwijsmedewerker een Leermiddel binnen de Activatieperiode in gebruik heeft genomen. Het tijdstip van in gebruik name wordt vastgelegd. | Licentie Getal en Ruimte HAVO 3 ECK iD 31-08-2022 10:45:33 |
Activatiecode | activationCode | Entiteit | Een Activatiecode is een unieke door een Leermiddelenaanbieder gegenereerde code die door een Onderwijsdeelnnemer of Onderwijsmedewerker gebruikt kan worden om één Leermiddel eenmalig en persoonlijk in gebruik te nemen. | XXXXX voor het Leermiddel |
Activatiecode- | activationCode-Request | Entiteit | In een ActivatiecodeVerzoek vraagt een afnemende leverancier een Activatiecode aan bij een leverancier die leermiddelen aanbiedt. | - |
Activatiecode-Bevestiging | activationCode-Confirmation | Entiteit | In een ActivatiecodeBevestiging verstrekt de aanbiedende leverancier aan de afnemende leverancier een Activatiecode. | - |
Activatiecode-IntrekkingVerzoek | activationCode-RevokeRequest | Entiteit | Via een ActivatiecodeIntrekking-Verzoek vraagt een afnemende leverancier aan een leverancier die leermiddelen aanbiedt om een activatiecode in te trekken. | - |
Activatiecode-IntrekkingBevestiging | activationCode-RevokeConfirmation | Entiteit | In een ActivatiecodeIntrekking-Bevestiging bevestigt de aanbiedende leverancier aan de afnemende leverancier dat de activatiecode is ingetrokken | - |
Definities in domein Uitvoering onderwijs
Het domein Uitvoering onderwijs bevat alle relevante informatie ten behoeve van het combineren, arrangeren, plannen en gebruiken van Leermaterialen en/of Leermodules. De Leermaterialen zijn de educatieve content en/of applicaties die door Onderwijsdeelnemers of Onderwijsmedewerkers gebruikt kunnen worden. De gegevens over Leermaterialen worden in het Edu-V ecosysteem gedeeld door de referentiecomponent Leermaterialencatalogus.
In de Beschrijving van deze Leermaterialen en Leermodules wordt alle relevante metadata opgenomen ten behoeve van de uitvoering van het onderwijs. Denk onder meer aan vak, onderwijsniveau en leerdoelen. Een LeermaterialBeschrijving en LeermoduleBeschjrijving bevat tevens een Deeplink, welke door een Onderwijsdeelnemer kan worden gebruikt om direct naar het betreffende Leermateriaal te navigeren.
Leermaterialen zijn te bundelen in een Leermiddelstructuur bestaande uit Leermodules en/of Leermaterialen. Leermodules bestaan weer uit één of meerdere Leermaterialen. Deze hiërarchie geeft leveranciers de vrijheid om Leermaterialen eenmalig te beschrijven in de leermaterialencatalogus maar wel op verschillende manieren te benutten in leermodules en/of leermiddelen.
De entiteiten zijn nader uitgewerkt in onderstaand overzicht.
Naam | Technical term | Type | Omschrijving | Synoniem of voorbeeld |
|---|---|---|---|---|
Leermateriaal | aus (assignable unit) | Entiteit | Theorie, een opdracht, oefenprogramma, diagnostische toets of andere leertaak die in één of meerdere Leermodules en of Leermiddelen kan zitten. | Instructie Oefeningen Kwadratische problemen Diagnostische toets Kwadratische problemen Kijk- en luistertoets Engels VWO ‘20/’21 |
Leermateriaal-Beschrijving | course | Entiteit | Titel van, omschrijving van, afbeelding van, leerdoelen van, metadata over en Deeplink naar het Leermateriaal. | Oefeningen Kwadratische problemen OF Schoolexamen Kijk- en luistertoets Engels taal VWO Schooljaar ‘20/’21 |
Deeplink | url | Attribuut | Een Deeplink is een directe link naar het Leermateriaal of de Leermodule. Deze Deeplink kan in de referentiecomponent Onderwijsleeromgeving worden gebruikt in Studiewijzers voor Onderwijsdeelnemers. | www.leermiddelaanbieder.nl/leermateriaal |
Leermodule-Beschrijving | block | Entiteit | Een Leermodule bestaat uit één of meerdere met elkaar samenhangende Leermaterialen. De LeermoduleBeschrijving legt deze samenhang vast in een module van één of meerdere LeermateriaalBeschrijvingen. LeermateriaalBeschrijvingen kunnen onderdeel zijn van meerdere LeermoduleBeschrijvingen. | Module/Hoofdstuk Kwadratische problemen bestaat uit:
Leerlingvolgsysteem Rekenen bestaande uit vier deeltoetsen. |
Leermiddel-Structuur-Beschrijving | CourseStructure | Entiteit | De entiteiten Leermateriaal en Leermodule geven de mogelijkheid om de inhoud van een Leermiddel structureel en als een boomstructuur te beschrijven. De LeermiddelStructuurBeschrijving legt deze samenhang vast in een set van één of meerdere LeermoduleBeschrijvingen en/of LeermateriaalBeschrijvingen. LeermoduleBeschrijvingen en LeermateriaalBeschrijvingen kunnen onderdeel zijn van meerdere LeermiddelStructuurBeschrijvingen. | Educatieve applicaite/
Educatieve applicatie bestaat uit:
Kijk- en luistertoetsen Engels (alle niveaus en schooljaren) |
Definities in domein Evaluatie onderwijs
Het domein Uitvoering onderwijs bevat alle relevante informatie ten behoeve van het evalueren van activiteitsgegevens. Deze gegevens ontstaan in de referentiecomponenten Gebruiksomgeving digitaal leermateriaal of het Digitaal toetssysteem. In het Edu-V ecosysteem maken we onderscheid in Leermiddelgebruik over Leermiddelen, Leermateriaalgebruik en Leerresultaten over Leermaterialen of Leermodules.
De entiteiten zijn nader uitgewerkt in onderstaand overzicht.
Naam | Technical term | Type | Omschrijving | Synoniem of voorbeeld |
|---|---|---|---|---|
Leermiddelgebruik | usage | Entiteit | Het gebruik van een Leermiddel door een Onderwijsdeelnemer of Onderwijsmedewerker. Leermiddelgebruik kan in de vorm van een tijdstip, een hoeveelheid maar ook een frequentie. | Laatst gebruikt op 10 actieve licenties 80 toetsen afgenomen 5 maandelijkse actieve gebruikers |
Leermateriaalgebruik | progress | Entiteit | Een bericht waarin melding wordt gemaakt van starten of afronden vanLeermateriaal door een Onderwijsdeelnemer. Leermateriaalgebruik kan worden gedeeld op het niveau van een enkel Leermateriaal en/of op het niveau van een Leermodule. | Instructie Instructie |
Leerresultaat | result | Entiteit | Een bericht met het resultaat op Leermateriaal van een Onderwijsdeelnemer. Dit Leerresultaat mag worden geadministreerd door één of meerdere Onderwijsmedewerkers. Een Leerresultaat kan worden gedeeld op het niveau van een enkel Leermateriaal en/of op het niveau van Leermodule. | Kijk- en luistertoets Engels VWO ‘20/’21 |
Release notes
Deze uitwerking is gebaseerd op basis van de volgende stappen:
0.0.1: Het gegevensmodel van het SEM Ecosysteem is als eerste basis genomen.
0.0.2: De gegevensdefinities zijn (nog) meer in lijn gebracht met de termen van de ROSA: Leerling → Onderwijsdeelnemer en Leraar → Onderwijsmedewerker.
0.0.3: De gegevens zijn onderverdeeld in de domeinen die reeds bepaald zijn. Dit heeft ertoe geleid dat er één extra domein is toegevoegd: Inkoop van leermiddelen.
0.0.4: Tijdens de werkconferentie van de Architectenraad Edu-V van 18 april 2023 zijn werkafspraken toegevoegd over het beheer van de definities.
De gegevensdefinities worden zoveel als mogelijk gekoppeld aan de begrippen in de ROSA.
De werkgroepen geven input vanuit de context van een use case. Dit kan leiden tot een wijziging van een begrip.
Alle begrippen worden voorzien van een Engels technische term.
Indien er een standaard wordt aangehouden als berichtdefinitie dan wordt er een crosswalk gedaan naar de definities zoals op deze pagina beschreven.
0.0.5: Engelse technische termen (zoals gehanteerd in de APIs) toegevoegd.
0.0.6: Herziening van de gegevensdefinities na afstemming met de Adviesgroep Samenhang Onderwijsarchitecturen.
0.0.7: De pagina is besproken tijdens de bijeenkomst van de Architectenraad Edu-V en is gereed voor de ROSA-architectuurscan.
Het gegevensmodel blijft in ontwikkeling aangezien er input kan komen vanuit de werkgroepen.
0.0.8: De gegevensdefinities zijn bijgewerkt op basis van input uit de werkgroepen. De aangepaste gegevensdiensten voor Doorgifte identiteiten, Administratiesystemen onderwijsaanbieder en -medewerker, Regie op gegevens en Verwerven en in gebruik nemen zijn verwerkt.
0.0.9: Definities uit architectuurkader toegevoegd.
1.0.0: Het Architectuurkader Edu-V is vastgesteld als startpunt voor de implementatie. Tevens is instemming verleend op verdere doorontwikkeling van het Architectuurkader Edu-V op basis van de Architectuurprincipes. Dit akkoord is verleend op het Bestuurlijk Overleg van 27 mei 2024.