Titel | Leveren van digitaal leermiddel |
Scenario | ||
Status |
|
Status | ||
---|---|---|
|
Status | ||
---|---|---|
|
Status | ||
---|---|---|
|
|
|
|
Stadium
Status | ||||
---|---|---|---|---|
|
Status | ||
---|---|---|
|
| ||
Versie | 0.0. |
3 |
Datum |
11 December 2023 | |
Auteur | Werkgroep Verwerven en in gebruik nemen |
Acties |
|
Op deze pagina is de functionele, operationele en technische specificatie te vinden voor het Leveren van leermiddelen en het monitoren van de status van de levering.
...
Om Leermiddelen succesvol te kunnen laten leveren tussen de betrokken Leveranciers leveranciers is het van belang dat de onderwijsorganisatie de gegevensuitwisselingen tussen deze Leveranciers leveranciers activeert.
Van: | Gegevensdienst | Gegevenssoort | Gegevens |
---|
Naar: |
---|
Leerportaalaanbieder
Leermiddelenaanbieder
Dashboardaanbieder
Administratiesysteem-aanbieder
Administratiesysteem onderwijsdeelnemer
Administratiesysteem onderwijsdeelnemer | Onderwijs-administratie | Schoolinfo | SchoolPeriode SchoolVak |
---|
Faciliteit voor leveren (of arrangeren) van digitale leermiddelen
Mijn leermiddelen
Learning Management System
Licentiekantoor*
Aanspraakmanager Leermiddelenportaal Licentieregistratie Leermiddelendashboard | |
Schoolorganisatie | OnderwijsdeelnemerSchoolPeriode OnderwijsmedewerkerSchoolPeriode StamgroepSchoolPeriode LesgroepSchoolPeriode |
Faciliteit voor leveren (of arrangeren) van digitale leermiddelen
Mijn leermiddelen
Learning Management System
Licentiekantoor*
Overkoepelend dashboard gebruik
Aanspraakmanager Leermiddelenportaal Licentieregistratie Leermiddelendashboard | ||
Fijndistributie | OnderwijsdeelnemerAdresgegevens | Distributiefaciliteit |
Aanspraakmanager |
---|
Aanspraken |
Aanspraken |
Leermiddelenshop
Faciliteit voor leveren (of arrangeren) van digitale leermiddelen
Aanspraken
Aanspraak
–
Mijn leermiddelen
Learning Management System
Licentiekantoor
Aanspraak | Leermiddelenportaal Leermiddelendashboard | |||
Licentieregistratie | Leermiddelactivatie | Leermiddelactivatie | Leermiddelactivatie | Leermiddelenportaal Leermiddelendashboard |
---|
Info |
---|
Geen Activering tussen Leermiddelenshop en LeermiddelenaanbiederDe onderwijsorganisatie hoeft de uitwisseling van Aanspraken tussen de Leermiddelenshop en de Leermiddelenaanbieder niet te activerenRegie op gegevens bij bilaterale samenwerkingen tussen leveranciers Indien de leverancier die leermiddelen aanbiedt bilateraal samenwerkt met andere leveranciers (die bijvoorbeeld de verkoop en/of distributie verzorgt), dan is voor de gegevensuitwisseling tussen deze leveranciers geen toestemming nodig vanuit de onderwijsorganisatie. Als gevolg van de bilaterale overeenkomst tussen de Leermiddelenaanbieder en de Leermiddelenshop leveranciers is er reeds doelbinding om de gegevens uit te wisselen tussen de partijen. |
Voor dit proces betreft het de volgende eisen:
De Onderwijsorganisatie onderwijsorganisatie heeft de uitwisseling van gegevens geactiveerd conform bovenstaande tabel.
De uitwisseling van Schoolinfo en Schoolorganisatie gegevenssoorten naar het Licentiekantoor van de Leermiddelenaanbieder Licentieregistratie is geactiveerd indien gebruik gemaakt wordt van de Aanspraakvarianten SchoolVak of SchoolGroep. Dit is aangeduid met een * in de kruistabel.
Een aantal gegevenssoorten zijn vertrouwelijk gegevensdiensten bevatten persoonsgegevens en vereisen een Verwerkersovereenkomst verwerkersovereenkomst tussen de Onderwijsorganisatie onderwijsorganisatie en de Leverancierleverancier.
Het betreft de gegevenssoorten:
SchoolorganisatieOnderwijsadministratie
FijndistributieAansprakenAanspraken
Leermiddelactivatie
De Onderwijsorganisatie heeft derhalve een Verwerkersovereenkomst gesloten met de Leverancier in de rollen van:
Leermiddelenshop
Leermiddelenaanbieder
Leerportaalaanbieder
Dashboardaanbieder
alle betrokken leveranciers.
Randvoorwaarden: aansluiting en beschikbare brongegevens
Leveranciers beschikken afhankelijk van de Business Rol referentiecomponent die ze vervullen over actuele brongegevens en/of hebben onderling overeenkomsten afgesloten:
De Leermiddelenshop en de Leermiddelenaanbieder hebben Indien de leverancier die de leermiddelen aanbiedt, de verkoop laat verzorgen door een andere leverancier, dan hebben beide leveranciers bilaterale afspraken gemaakt en een overeenkomst gesloten.
Indien een Leverancier zowel de rol van Leermiddelenshop als Leermiddelenaanbieder vervult is deze overeenkomst vanzelfsprekend niet nodig.
Alle betrokken Business rollen (Leermiddelenshop, Leermiddelenaanbieder, Leerportaalaanbieder en Dashboardaanbieder) Alle betrokken referentiecomponenten in de levering zijn technisch op elkaar aangesloten.
De Leermiddelenshop, de Leerportaalaanbieder(s) en de Dashboardaanbieder(s) referentiecomponenten Bestelomgeving leermiddelen, Aanspraakmanager, Leermiddelenportaal en Leermiddelendashboard beschikken over actuele informatie uit de referentiecomponent Leveranciersspecfieke leermiddelencatalogus van de Leermiddelenaanbieder.
De
leverancier die de leermiddelen aanbiedt is verantwoordelijk voor actuele informatie in de Leveranciersspecifieke leermiddelencatalogus voor alle Producten die verworven kunnen worden. Dit betekent dat is voldaan aan de vullingsregels zoals toegelicht op de pagina Producten, Aanspraken en Licenties.
De Leermiddelenshop en de Leerportaalaanbieder Aanspraakmanager, het Leermiddelenportaal en het Leermiddelendashboard beschikken over actuele informatie uit het Administratiesysteem onderwijsdeelnemer onderwijsdeelnemers van de Administratiesysteemaanbieder van de Onderwijsorganisatieonderwijsorganisatie.
Voor de Leerportaalaanbieder het Leermiddelenportaal gelden specifieke verwerkingsregels ten aanzien van het verwerken van wijzigingen in Onderwijsdeelnemer of Lesgroep/Stamgroep informatie. Dit is nader toegelicht in de technische specificatie van de SIS API.
De verwerkingsregels zijn er op gericht om de open aanspraakvarianten SchoolVak en SchoolLesgroep SchoolGroep correct te laten werken.
Indien de Leermiddelenaanbieder Leermiddelen aanbiedt leermiddelen aangeboden worden in de Aanspraakvarianten aanspraakvarianten SchoolVak of SchoolGroep dan beschikt de Leermiddelenaanbieder referentiecomponent Licentieregistratie over actuele informatie uit het Administratiesysteem onderwijsdeelnemer onderwijsdeelnemers van de Administratiesysteemaanbieder van de Onderwijsorganisatieonderwijsorganisatie.
Start: Bestelling voltooid en
...
Leveringsorder bekend
Deze use case Dit scenario start op het moment dat een Onderwijsorganisatie Besteller (onderwijsorganisatie of een Particulier particulier) een bestelling heeft geplaatst bij een Bestelomgeving leermiddelen van een Leermiddelenshop. Een enkele bestelling kan bestaan uit meerdere bestelregels voor meerdere Productenproducten. Hierbij dient opgemerkt te worden dat ook een Product product kan bestaan uit meerdere deelproducten. In dat geval spreken we van een Set. Tot slot zijn er Producten producten die bestaan uit folio en digitale componenten. In dat geval spreken we van een Combi combi product.
Voor deze Use case dit scenario gaan we er van uit dat er een Product product (of Setset) is besteld. De specificatie op deze pagina licht toe op welke wijze dit Product product geleverd gaat worden bij door de betrokken Business Rollen Leermiddelenshop, Leermiddelenaanbieder, Leerportaalaanbieder en Leerdashboardaanbiederreferentiecomponenten Aanspraakmanager, Licentieregistratie, Leermiddelenportaal en Leermiddelendashboard.
Hierbij maakt het proces direct onderscheid tussen het type Productproduct: Fysiekfysiek, Digitaal digitaal of Combicombi. Deze uitwerking gaat uit van de levering van digitale leermiddelen die onderdeel zijn van een Digitaal digitaal of Combi combi product. De levering van Fysieke fysieke producten is buiten scope van deze uitwerking. De levering van Fysieke fysieke deelproducten uit een Combi-product is ook buiten scope van deze uitwerking.
Als gevolg van bovenstaande scope start het proces van Leveren met de volgende LeverspecificatieLeveringsorder:
De Besteller, zijnde een Onderwijsorganisatie of een Particulier(
Optioneel) Bestelnummer ter referentie aan de bestelling die door de Besteller is gedaan. Zo kan de verwerking van de Leverspecificatie terug herleid worden naar een daadwerkelijke bestelling door een BestellerLeveringsordernummer als unieke identifier voor de leveringsorder. Dit nummer kan door de Bestelomgeving leermiddelen worden gebruikt om de status van de levering te volgen.
(Optioneel) Leveringsorderregelnummer indien er in één leveringsorder meerdere producten worden geleverd.
(Optioneel) Contractnummer ter referentie tussen de Leverancier in de rol van Leermiddelenshop en de Leverancier rol van Leermiddelenaanbiederleverancier met de referentiecomponent Bestelomgeving leermiddelen en de leverancier met de referentiecomponent Licentieregistratie.
Dit is vanzelfsprekend niet van toepassing indien een Leverancier beide rollen referentiecomponenten vervult.
Het hanteren van een contractnummer is niet verplicht en Leveranciers kunnen hier bilaterale afspraken over maken.Tevens staat het Leveranciers vrij om een eigen aggregatieniveau voor contracten te hanteren, zoals een contractnummer per Leverancier, Onderwijsorganisatie, Boekjaar, Productaggregatieniveau voor contracten wordt bilateraal afgesproken en kan afhankelijk van de ketensamenwerking een ander niveau zijn. Voorbeelden zijn: contractnummer per leverancier, onderwijsorganisatie, bestelling, raamcontract, product, of anderszins.
Het contractnummer kan worden gebruikt door de Bestelomgeving leermiddelen om gegevens over Leermiddelactivatie en leermiddelgebruik op te vragen bij de Licentieregistratie.
Het Product, zijnde een combi of digitaal leermiddel of een set van digitale leermiddelen
De Activatieperiode gespecificeerd met een startdatum (startDate) en einddatum (activationUntilDate)
De Aanspraakvariant, inclusief de hiervoor vereiste autorisatiegegevens zoals opgenomen in onderstaande tabel
De individuele aanspraakvarianten kunnen op basis van een identifier (eckId of userId) of met een activatiecode
worden gespecificeerdworden gespecificeerd.Status colour Purple title BUITEN SCOPE POC Indien er voor een persoonlijke aanspraak gebruik wordt gemaakt van activatiecodes, dan wordt er een nog geldige en niet eerder verkochte activatiecode toegevoegd aan de aanspraak. Een activatiecode kan door de Bestelomgeving leermiddelen worden aangevraagd bij de Licentieregistratie.
Besteller | Aanspraakvariant | Autorisatieregel: wie mag leermiddel in gebruik nemen? | Minimaal vereiste gegevens | |
Particulier | Persoonlijk | Individueel | Gespecificeerde onderwijsdeelnemer | eckId, userId OF activatiecode |
Onderwijs-organisatie | School | Open | Alle onderwijsdeelnemers van de school | schoolId |
SchoolVak | Open | Onderwijsdeelnemers die bij in gebruik name het SchoolVak volgen | schoolId |
SchoolGroep | Open | Onderwijsdeelnemers die bij in gebruik name in een Lesgroep of Stamgroep zitten | schoolId |
SchoolOnderwijs-deelnemer | Individueel | Gespecificeerde onderwijsdeelnemer(s) | schoolId |
SchoolOnderwijs-medewerker | Individueel | Gespecificeerde lera(a)r(en) | schoolId |
Info |
---|
Aanspraken en licenties Bij het leveren van Leermiddelen wordt gebruik gemaakt van de entiteiten Aanspraak en Licentie. De definities, levenscyclus en statussen van deze entiteiten zijn toegelicht op de pagina Producten, Aanspraken en Licenties. |
...
Het leveren van Leermiddelen vindt plaats nadat een Koper Besteller een Leermiddel leermiddel heeft geselecteerd en besteld in de component referentiecomponent Bestelomgeving van een Leermiddelenshopleermiddelen. De bestelling wordt vervolgens door de Leermiddelenshop naar de component Faciliteit voor leveren (of arrangeren) van digitale leermiddelen van de Leermiddelenshop gestuurd. Deze component door de Bestelomgeving leermiddelen omgezet in één of meerdere leveringsorders. De levering van fysieke en digitale producten wordt op dit moment in het proces gesplitst. De leveringsorder voor fysieke leermiddelen wordt verstuurd naar de referentiecomponent Distributiefaciliteit. Zoals hierboven toegelicht is het leveren van fysieke leermiddelen buiten scope van dit scenario.
De leveringsorders voor de digitale producten worden door de Bestelomgeving leermiddelen naar de referentiecomponent Aanspraakmanager gestuurd. De Aanspraakmanager is verantwoordelijk voor de levering van alle de digitale leermiddelen uit de leverspecificatieleveringsorder. In Figuur 9 is het interactiediagram voor de levering van digitale leermiddelen dit leverproces weergegeven.
...
Info | ||||||
---|---|---|---|---|---|---|
Leverancier vervult zowel de rol van Leermiddelenshop als Leermiddelenaanbieder Indien een Leverancier zowel de component Faciliteit voor leveren (of arrangeren) van digitale leermiddelen in de rol van Leermiddelenshop als de component van Licentiekantoor in de business rol van Leermiddelenaanbieder vervult dan kunnen een aantal stappen worden overgeslagen. Dit is in de toelichting aangeduid met de aanduiding
|
...
Het proces van leveren van een digitaal leermiddel bestaat uit de volgende stappen:
Stap | Toelichting |
---|---|
1. | De |
Leveringsorder wordt door de |
Bestelomgeving Leermiddelen |
verstuurd naar de |
In dit proces gaan we er niet vanuit dat de Leverancier die de Faciliteit voor leveren (of arrangeren) van digitale leermiddelen aanbiedt ook de Bestelomgeving leermiddelen aanbiedt. Dit kunnen verschillende Leveranciers zijn.
Aanspraakmanager. | |
2. | De |
Aanspraakmanager verwerkt de |
Leveringsorder en maakt een |
aanspraak aan voor het bestelde |
digitale leermiddel. Iedere Aanspraak wordt conform de volgende stappen verstuurd.
|
|
|
|
|
Status | ||||
---|---|---|---|---|
|
3.
Status | ||||
---|---|---|---|---|
|
| |
3. | De Aanspraakmanager verstuurt de aanspraak met de status Entitled naar alle betrokken componenten in de levering van het |
leermiddel. Dit zijn de componenten: |
Licentiekantoor van de Leermiddelenaanbieder
Mijn Leermiddelen van de Leerportaalaanbieder
Learning Management System van de Leerportaalaanbieder
Overkoepelend dashboard gebruik van de Dashboardaanbieder
De aanspraak wordt alleen verstuurd naar de |
Leermiddelenportalen en Leermiddelendashboard(s) waar de |
onderwijsorganisatie de gegevensuitwisseling van de |
gegevensdienst aanspraken voor heeft geactiveerd. | |
4. | De Aanspraakmanager verstuurt een terugmelding naar de Bestelomgeving leermiddelen dat de leveringsorder is verwerkt en nu de status |
colour | Yellow |
---|---|
title | NVT gecombineerde rol |
van Entitled heeft. | |
5. | De Besteller kan in de |
Bestelomgeving leermiddelen zien wat de status is van de levering. De status van Entitled betekent dat de bestelling is verwerkt en de levering naar de betrokken componenten is gestart. Indien de |
onderwijsorganisatie de gegevensuitwisseling van de gegevenssoort Aanspraak heeft geactiveerd voor een |
Leermiddelendashboard, dan kan een |
onderwijsmedewerker van de |
onderwijsorganisatie de status van de levering in dit dashboard volgen. Dit heeft als voordeel voor de |
onderwijsorganisatie dat de levering van |
leermiddelen die besteld zijn bij meerdere |
Bestelomgevingen leermiddelen in één |
totaaloverzicht gecombineerd kunnen worden. |
6. |
De Licentieregistratie krijgt een |
aanspraak op een |
leermiddel binnen en zet het |
leermiddel, conform de autorisatieregels van de |
aanspraakvariant, klaar voor in gebruik name in de activatieperiode.
|
|
7. |
Status | ||||
---|---|---|---|---|
|
De Licentieregistratie bevestigt aan de |
Aanspraakmanager dat de |
leermiddelen klaar zijn gezet met een terugmelding Provisioned.
|
|
|
|
|
8. | De |
Aanspraakmanager verandert de status van de |
aanpraak van Entitled naar Provisioned en stuurt deze nieuwe status toe aan alle betrokken componenten in de levering van het |
leermiddel. | |
9. | De Aanspraakmanager verstuurt een terugmelding naar de Bestelomgeving leermiddelen dat de leveringsorder nu de status van Provisioned heeft. |
.10. | De Besteller kan de nieuwe status inzien bij de |
Bestelomgeving leermiddelen. Tevens kan een |
onderwijsmedewerker van de |
onderwijsorganisatie ook de nieuwe status inzien in het |
Leermiddelendashboard. |
11. | De statuswijzing van een Aanspraak naar Provisioned is de trigger voor |
het Leermiddelenportaal om de |
toegangslink op te nemen in het overzicht van leermiddelen voor de |
onderwijsdeelnemers (of -medewerkers). De |
toegangslinks worden geplaatst conform de autorisatieregels van de |
aAanspraakvariant.
|
|
|
|
|
9b
Indien |
een leverancier de referentiecomponenten Leermiddelenportaal en Onderwijsleeromgeving combineert, dan kunnen de aanspraken ook worden benut om deeplinks naar leermaterialen klaar te zetten, bijvoorbeeld in persoonlijke studiewijzers.
|
|
|
|
|
|
|
|
|
|
|
|
|
12. |
Het Leermiddelenportaal bevestigt aan de |
Aanspraakmanager dat de |
toegangslinks klaar zijn gezet met een terugmelding LinkReady.
|
|
|
|
13. | De |
Aanspraakmanager verandert de status van de |
aanspraak van Provisioned naar LinkReady en stuurt deze nieuwe status toe aan alle betrokken componenten in de levering van het |
leermiddel. | |
14. | De Aanspraakmanager verstuurt een terugmelding naar de Bestelomgeving leermiddelen dat de leveringsorder nu de status van LinkReady heeft. |
15. | De Besteller kan de nieuwe status inzien bij de |
Bestelomgeving leermiddelen. Tevens kan een |
onderwijsmedewerker van de |
onderwijsorganisatie ook de nieuwe status inzien in het |
Leermiddelendashboard. |
Info |
---|
Communicatie statusuwijziginen naar alle betrokken componenten In het proces is ervoor gekozen om de nieuwe status naar alle betrokken referentiecomponenten te sturen. Zo beschikken alle betrokken Leveranciers leveranciers en de Onderwijsorganisatie onderwijsorganisatie altijd over dezelfde informatie. Door deze transparantie kunnen alle betrokken Leveranciers leveranciers adequate support leveren aan de onderwijsorganisatie en de Onderwijsorganisatiebesteller. |
Anchor | ||||
---|---|---|---|---|
|
...
Buiten scope POC
Het gebruik van Deeplinks voor Leermaterialen die behoren tot een Leermiddel is buiten scope van de eerste POC.
deeplink
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
Werkgroep Combineren en arrangeren leermaterialen Dit onderwerp zal ook besproken gaan worden in de werkgroep Combineren en arrangeren leermaterialen. Vanwege de afhankelijkheid van een correcte levering om vervolgens te kunnen combineren en arrangeren is dit onderwerp wel alvast hier opgenomen. De inhoud wordt op een later moment uitgewerkt door zowel de werkgroep Combineren en arrangeren leermaterialen als de werkgroep Verwerven en in gebruik nemen leermiddelen. |
De Leermiddelenaanbieder bepaalt de opbouw van de Deeplink. aanbieder van de leermiddelen biedt in de referentiecomponent Leermaterialencatalogus informatie aan over de opbouw van leermiddelen uit leermodules en leermaterialen. Voor iedere leermodule en ieder leermateriaal voegt de aanbieder hiervoor een deeplink toe. Het formaat van deze deeplink wordt vanzelfsprekend bepaald door de aanbieder van de leermiddelen.
Om in gebruik name via een Deeplink deeplink mogelijk te maken kan de component Learning Management System van een Leerportaalaanbieder een referentiecomponent Onderwijsleeromgeving een optionele parameter product toevoegen aan een Deeplinkdeze deeplink. Hierdoor krijgt de Leermiddelenaanbieder een suggestie voor het Leermiddel waarop de Onderwijsdeelnemer kan in de Licentieregistratie gecontroleerd worden of de onderwijsdeelnemer (of -medewerker) een Aanspraak aanspraak heeft om het Leermiddel leermiddel in gebruik te nemen.
Dit voorkomt dat een Onderwijsdeelnemer onderwijsdeelnemer (of -medewerker) allereerst de Toegangslink toegangslink dient te gebruiken om een Leermiddel leermiddel in gebruik te nemen. Dit kan dan ook via één van de Deeplinks deeplinks van de Leermaterialen leermaterialen uit het Leermiddel. Ook ondersteunt het een Learning Management System in het beheer van relevante Deeplinks voor Onderwijsdeelnemers (of -medewerkers).Een Deeplink leermiddel.
Een deeplink krijgt in dat geval het volgende formaat:
...
Hierbij is het onderdeel www.uitgever.nl/leermateriaal de deeplink die geplaatst staat in de Course API. De identifier (veelal het EAN) – in dit voorbeeld 12345678 – betreft de productId van het Leermiddel leermiddel van een geldige Aanspraak aanspraak voor de Onderwijsdeelnemer onderwijsdeelnemer (of -medewerker). De component Learning Management System heeft deze informatie verkregen via de Entitlement APIDeze informatie heeft de leverancier die zowel het Leermiddelenportaal als de Onderwijsleeromgeving aanbiedt ontvangen via de aanspraken uitgewisseld tijdens de levering van het digitale leermiddel.
Het hanteren van deze parameter is optioneel. Zo kan het bijvoorbeeld voorkomen dat een Onderwijsdeelnemer onderwijsdeelnemer via meerdere Leermiddelen leermiddelen een gebruiksrecht heeft op hetzelfde Leermateriaalleermateriaal. In dat geval kan een Portaal Onderwijsleeromgeving twee deeplinks tonen, aan de Onderwijsdeelnemer onderwijsdeelnemer vragen welk product te gebruiken of de parameter niet hanteren.
...
Deze uitwerking is gebaseerd op basis van de volgende stappen:
0.0.1: Outline van de pagina is gemaakt op basis van bestaande content.
0.0.2: Verwijzingen naar Scenariobeschrijvingen Verwerven en in gebruik nemen bijgewerkt.
0.0.3: Tekst geactualiseerd op basis van herziening rollen en referentiecomponenten in het architectuurkader. Verwijzingen naar de POC scope zijn verwijderd.