Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Titel

Leveren van digitaal leermiddel

Use case

Scenario

#5 Leveren leermiddelen

#6 Monitoren status levering

Status

Status
title

DRAFT

In ontwikkeling
Status
title

WERKGROEP

ROSA-Architectuurscan
Status
title

KLANKBORDgroep

Status
titleARCHITECTenraad
Status
colourGreen
titleREDACTIE
Statustitle

BEsluitvorming

StatustitleCONCEPT

Stadium

Status
colour

Blue

Yellow
title

POC
Status
titleBEHEER

IMPLEMENTATIE
Status
title

PILOT

in beheer

Versie

0.9.0

.2

Datum

26 Mei 2023

27 Juni 2024

Auteur

Werkgroep Verwerven en in gebruik nemen

Acties

  • Geen openstaande 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 leveringeen digitaal leermiddel.

De specificatie bestaat uit de volgende onderdelen:

Table of Contents
minLevel2
maxLevel2
include
outlinefalse
indent
excludeRelease
typelist
class
printablefalse

...

Om Leermiddelen succesvol te kunnen laten leveren tussen de betrokken Leveranciers is het van belang dat de onderwijsorganisatie de gegevensuitwisselingen tussen deze Leveranciers activeert.

...

Bron

...

Gegevenssoort

...

Gegevens

...

Leermiddelenshop

...

Leerportaalaanbieder

...

Leermiddelenaanbieder

...

Dashboardaanbieder

...

Administratiesysteem-aanbieder

...

Administratiesysteem onderwijsdeelnemer

...

Schoolinfo

...

SchoolPeriode

SchoolVak

...

Faciliteit voor leveren (of arrangeren) van digitale leermiddelen

...

Mijn leermiddelen

Learning Management System

...

Licentiekantoor*

...

Overkoepelend dashboard gebruik

...

Schoolorganisatie

...

OnderwijsdeelnemerSchoolPeriode

OnderwijsmedewerkerSchoolPeriode

LesgroepSchoolPeriode

...

Faciliteit voor leveren (of arrangeren) van digitale leermiddelen

...

Mijn leermiddelen

Learning Management System

...

Licentiekantoor*

...

Overkoepelend dashboard gebruik

...

Fijndistributie

...

OnderwijsdeelnemerAdresgegevens

...

Distributiefaciliteit voor levering van fysieke leermiddelen

...

...

...

...

Leermiddelenshop

...

Faciliteit voor leveren (of arrangeren) van digitale leermiddelen

...

Aanspraken

...

Aanspraak

...

...

Mijn leermiddelen

Learning Management System

...

Licentiekantoor

...

Overkoepelend dashboard gebruik

Info

Geen Activering tussen Leermiddelenshop en Leermiddelenaanbieder

De onderwijsorganisatie hoeft de uitwisseling van Aanspraken tussen de Leermiddelenshop en de Leermiddelenaanbieder niet te activeren. Als gevolg van de bilaterale overeenkomst tussen de Leermiddelenaanbieder en de Leermiddelenshop is er reeds doelbinding om de gegevens uit te wisselen tussen de partijen.

Voor dit proces betreft het de volgende eisen:

...

De Onderwijsorganisatie heeft de uitwisseling van gegevens geactiveerd conform bovenstaande tabel.

  • De uitwisseling van Schoolinfo en Schoolorganisatie gegevenssoorten naar het Licentiekantoor van de Leermiddelenaanbieder 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 en vereisen een Verwerkersovereenkomst tussen de Onderwijsorganisatie en de Leverancier.

...

Het betreft de gegevenssoorten:

  • Schoolorganisatie

  • Fijndistributie

  • Aanspraken

De Onderwijsorganisatie heeft derhalve een Verwerkersovereenkomst gesloten met de Leverancier in de rollen van:

...

Leermiddelenshop

...

Leermiddelenaanbieder

...

Leerportaalaanbieder

...

...

De Verwerkersovereenkomst heeft geresulteerd in een geldig mandaat in het Mandatenregister van de Onderwijsorganisatie.

Randvoorwaarden: aansluiting en beschikbare brongegevens

Leveranciers beschikken afhankelijk van de Business Rol die ze vervullen over actuele brongegevens en/of hebben onderling overeenkomsten afgesloten:

  • De Leermiddelenshop en de Leermiddelenaanbieder hebben 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) in de levering zijn technisch op elkaar aangesloten.

  • De Leermiddelenshop, de Leerportaalaanbieder(s) en de Dashboardaanbieder(s) beschikken over actuele informatie uit de Leveranciersspecfieke leermiddelencatalogus van de Leermiddelenaanbieder.

  • De Leermiddelenaanbieder 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 beschikken over actuele informatie uit het Administratiesysteem onderwijsdeelnemer van de Administratiesysteemaanbieder van de Onderwijsorganisatie.

    • Voor de Leerportaalaanbieder gelden specifieke verwerkingsregels ten aanzien van het verwerken van wijzigingen in Onderwijsdeelnemer of Lesgroep 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 correct te laten werken.

  • Indien de Leermiddelenaanbieder Leermiddelen aanbiedt in de Aanspraakvarianten SchoolVak of SchoolGroep dan beschikt de Leermiddelenaanbieder over actuele informatie uit het Administratiesysteem onderwijsdeelnemer van de Administratiesysteemaanbieder van de Onderwijsorganisatie.

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 leermiddel (of Setset van leermiddelen) is besteld. De specificatie op deze pagina licht toe op welke wijze dit Product de digitale leermiddelen (of de digitale componenten uit een set of combiproduct) geleverd gaat worden bij door de betrokken Business Rollen Leermiddelenshop, Leermiddelenaanbieder, Leerportaalaanbieder en Leerdashboardaanbiederreferentiecomponenten Bestelomgeving leermiddelen, Aanspraakmanager, Licentieregistratie en Leermiddelenportaal.

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) 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, Product, of anderszinsaggregatieniveau 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 levervariant en 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

      Status
      colourPurple
      titleBUITEN SCOPE POC
      worden gespecificeerd.

...

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
quantity

...

SchoolVak

...

Open

...

Onderwijsdeelnemers die bij in gebruik name het SchoolVak volgen

...

schoolId
schoolSubjectId
quantity

...

SchoolLesgroep

...

Open

...

Onderwijsdeelnemers die bij in gebruik name in een Lesgroep zitten

...

schoolId
groupId
quantity

...

SchoolOnderwijs-deelnemer

...

Individueel

...

Gespecificeerde onderwijsdeelnemer(s)

...

schoolId
eckId, userId OF activatiecode

...

SchoolOnderwijs-medewerker

...

Individueel

...

Gespecificeerde lera(a)r(en)

...

schoolId
eckId, userId OF activatiecode

...

Aanspraken en licenties

...

Proces: Interactieanalyse Leveren

...

digitaal leermiddel

Het leveren van Leermiddelen een digitaal leermiddel vindt plaats nadat een Koper Besteller een Leermiddel leermiddel heeft geselecteerd en besteld in de component 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 onderstaande figuur is het interactiediagram voor de levering van digitale leermiddelen dit proces 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

Status
colourYellow
titleNVT gecombineerde rol

...

Het proces van leveren van een digitaal leermiddel bestaat uit de volgende stappen:

Stap

Toelichting

1.

Een Besteller bestelt een leermiddel bij de Bestelomgeving leermiddelen.

2.

De Bestelomgeving leermiddelen zet een bestelling om in leveringsorders voor alle producten uit de bestelling. Alle leveringsorders betreffende digitale leermiddelen worden verder verwerkt in dit proces.

3.

De

Leverspecificatie

leveringsorder wordt door de

component

Bestelomgeving Leermiddelen

van een Leermiddelenshop

verstuurd naar de

component Faciliteit voor leveren (of arrangeren) van digitale leermiddelen van de Leermiddelenshop.

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.

2.

De Faciliteit voor leveren (of arrangeren) van digitale leermiddelen verwerkt de Leverspecificatie en maakt een Aanspraak aan voor het bestelde Leermiddel. Iedere Aanspraak wordt conform de volgende stappen verstuurd.

  • Voor een Combiproduct of een Set van digitale leermiddelen geldt dat de Aanspraak op het niveau van de Combi of de Set wordt opgesteld.

  • Status
    colourPurple
    titleBUITEN 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 worden aangevraagd bij het Licentiekantoor van de Leermiddelenaanbieder.

3.

Status
colourYellow
titleNVT gecombineerde rol

De Faciliteit voor leveren (of arrangeren) van digitale leermiddelen 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 Leerportaalaanbieder(s) en Dashboardaanbieder(s) waar de Onderwijsorganisatie de gegevensuitwisseling van de gegevenssoort Aasnspraak voor heeft geactiveerd.

4.

Status
colourYellow
titleNVT gecombineerde rol

De Besteller kan in de component Faciliteit voor leveren (of arrangeren) van digitale 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 Overkoepelend dashboard gebruik, dan kan een Onderwijsmedewerker van de Onderwijsorganisatie de status van de levering volgen. Dit heeft als voordeel voor de Onderwijsorganisatie dat de levering van Leermiddelen die besteld zijn bij meerdere Leermiddelenshops in één statusoverzicht gecombineerd kunnen worden.

5.

Het Licentiekantoor van de Leermiddelenaanbieder 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

Aanspraakmanager met een status ordered.

4.

De Besteller kan in de Bestelomgeving leermiddelen zien dat de leveringsorders aangemaakt.

5.

De Aanspraakmanager verwerkt de Leveringsorder en richt het beheer van aanspraken conform de levervariant en de leverspecificatie in.

  • Voor een individuele levervariant kan direct een aanspraak toegekend worden.

  • Voor de open levervarianten Opleiding, Vak en Groep wordt een proces ingericht om aanspraken toe te kennen op basis van de leverspecificatie.

  • Voor de open levervariant School worden vooraf geen aanspraken toegekend.

  • Voor een combiproduct of een set van digitale leermiddelen geldt dat aanspraken op het niveau van de combi of de set wordt opgesteld.

6.

De Aanspraakmanager verstuurt een terugmelding naar de Bestelomgeving leermiddelen dat de leveringsorder is verwerkt en nu de status van processed heeft.

7.

De Besteller kan in de Bestelomgeving leermiddelen zien dat de leveringsorders verwerkt is en in het proces zoals uitgewerkt in de figuur dat er nog geen aanspraken zijn aangemaakt.

8.

De Aanspraakmanager creëert de aanspraak of de aanspraken voor de eindgebruikers op basis van de levervariant en de leverspecificatie. Hierbij worden de volgende statussen gehanteerd: entitlementStatus created en urlStatus uninitialized

9.

De Aanspraakmanager verstuurt de aanspraak met de entitlementStatus creatednaar de Licentieregistratie.

10.

De Licentieregistratie registreert de aanspraak zodat de eindgebruiker het leermiddel in gebruik kan gaan nemen conform de autorisatieregels van de aanspraak.

  • Voor een combiproduct of een set van digitale leermiddelen geldt dat de

Aanbieder
  • Licentieregistratie alle onderliggende digitale leermiddelen klaarzet voor in gebruik name.

6Het Licentiekantoor van de Leermiddelenaanbieder

11.

Status
colourYellow
titleNVT gecombineerde rol

De Licentieregistratie bevestigt aan de

Faciliteit voor leveren (of arrangeren) van digitale leermiddelen van de Leermiddelenshop

Aanspraakmanager dat de

Leermiddelen

leermiddelen klaar zijn gezet met een terugmelding

Provisioned

van de entitlementStatus entitled.

  • Indien

het Licentiekantoor
  • de Licentieregistratie niet in staat is om de

Leermiddelen
  • leermiddelen klaar te zetten dan stuurt

het Licentiekantoor
  • de Licentieregistratie een terugmelding met een afgesproken

Foutcode
  • foutcode terug.

7

12.

De

Faciliteit voor leveren (of arrangeren) van digitale leermiddelen van de Leermiddelenshop

Aanspraakmanager verandert de

status

entitlementStatus van de

Aanpraak 8

aanpraak van

Entitled naar Provisioned en stuurt deze nieuwe status toe aan alle betrokken componenten in de levering van het Leermiddel.

created naar entitled.

13.

De

Besteller kan de nieuwe status inzien bij de Faciliteit voor leveren (of arrangeren) van digitale leermiddelen van de Leermiddelenshop. Tevens kan een Onderwijsmedewerker van de Onderwijsorganisatie ook de nieuwe status inzien in het Overkoepelend dashboard gebruik van de Dashboardaanbieder(s).

9a.

De statuswijzing van een Aanspraak naar Provisioned is de trigger voor de component Mijn leermiddelen van een Leerportaalaanbieder om de Toegangslink op te nemen in

Aanspraakmanager wijzigt de urlStatus van de aanspraak naar initialized en stuurt de aanspraak naar het Leermiddelenportaal.

14.

Het Leermiddelenportaal verwerkt de aanspraak en plaatst de toegangslink voor het leermiddel op het overzicht van leermiddelen voor de

Onderwijsdeelnemers (of -medewerkers). De Toegangslinks worden geplaatst conform de autorisatieregels van de Aanspraakvariant

eindgebruiker.

  • Voor een combiproduct of een set van digitale leermiddelen geldt dat de overall

Toegangslink
  • toegangslink die leidt naar een pagina met alle onderliggende digitale producten wordt geplaatst op het overzicht van leermiddelen.

  • Optioneel worden ook alle

Toegangslinks
  • toegangslinks van alle onderliggende digitale leermiddelen uit het combiproduct of de set van digitale leermiddelen geplaatst op de het overzicht van leermiddelen. Bij het plaatsen van een

Toegangslink
  • toegangslink van een onderliggend digitaal leermiddel wordt een relatie gelegd naar de

Toegangslink

Status
colourPurple
titleBUITEN SCOPE POC

  • toegangslink van het hoofdproduct (de set).

9b

  • Indien

de School gebruik maakt van een Portaal met de component Learning Management System dan kan het Leermiddel inclusief de onderliggende Leermaterialen en Toetsen voorzien worden van een label dat deze zijn verworven door de school. Ook kunnen de Deeplinks van Leermaterialen worden geplaatst in een persoonlijke studiewijzer voor Onderwijsdeelnemers en -medewerkers. Dit maakt het voor Onderwijsmedewerkers gemakkelijker om relevante Leermaterialen en Toetsen te selecteren voor hun lesvoorbereiding.Optioneel kunnen de Deeplinks van de Leermaterialen
  • 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.

    • Optioneel kunnen de deeplinks van de leermaterialen worden voorzien van een parameter product van het

Leermiddel
    • leermiddel uit de

Aanspraak
    • aanspraak. De

Deeplink
    • deeplink kan in dat geval gebruikt worden om het

Leermiddel
    • leermiddel in gebruik te nemen. De

Onderwijsdeelnemer
    • onderwijsdeelnemer kan dan het

Leermiddel
    • leermiddel in gebruik nemen middels de

Toegangslink
    • toegangslink van het

Leermiddel én
    • leermiddel of de

Deeplinks
    • deeplinks van de

Leermaterialen
    • leermaterialen uit het

Leermiddel
    • leermiddel. De technische afspraken met betrekking tot het formaat van

Deeplinks
    • deeplinks is beschreven in de paragraaf formaat

Deeplink
10

15.

De component Mijn leermiddelen van de Leerportaalaanbieder

Het Leermiddelenportaal bevestigt aan de

Faciliteit voor leveren (of arrangeren) van digitale leermiddelen van de Leermiddelenshop

Aanspraakmanager dat de

Toegangslinks

toegangslinks klaar zijn gezet met een terugmelding

LinkReady

op de urlStatus van processed.

  • Indien

de component Mijn leermiddelen
  • het Leermiddelenportaal niet in staat is om de

Toegangslinks
  • toegangslinks klaar te zetten dan stuurt het

Portaal
  • Leermiddelenportaal een terugmelding met een afgesproken Foutcode terug.

11

16.

De

Faciliteit voor leveren (of arrangeren) van digitale leermiddelen van de Leermiddelenshop

Aanspraakmanager verandert de

status

urlStatus van de

Aanspraak 12

aanspraak van

Provisioned naar LinkReady en stuurt deze nieuwe status toe aan alle betrokken componenten in de levering van het Leermiddel.

initialized naar processed.

15.

De Besteller kan

de nieuwe status inzien

bij de

Faciliteit voor leveren (of arrangeren) van digitale leermiddelen van de Leermiddelenshop. Tevens kan een Onderwijsmedewerker van de Onderwijsorganisatie ook de nieuwe status inzien in het Overkoepelend dashboard gebruik van de Dashboardaanbieder(s).
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 en de Onderwijsorganisatie altijd over dezelfde informatie. Door deze transparantie kunnen alle betrokken Leveranciers adequate support leveren aan de Onderwijsorganisatie.

...

Buiten scope POC

Het gebruik van Deeplinks voor Leermaterialen die behoren tot een Leermiddel is buiten scope van de eerste POC.

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#FFEBE6

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. Om in gebruik name via een Deeplink mogelijk te maken kan de component Learning Management System van een Leerportaalaanbieder een optionele parameter product toevoegen aan een Deeplink. Hierdoor krijgt de Leermiddelenaanbieder een suggestie voor het Leermiddel waarop de Onderwijsdeelnemer (of -medewerker) een Aanspraak heeft om het Leermiddel in gebruik te nemen.

Dit voorkomt dat een Onderwijsdeelnemer (of -medewerker) allereerst de Toegangslink dient te gebruiken om een Leermiddel in gebruik te nemen. Dit kan dan ook via één van de Deeplinks van de Leermaterialen uit het Leermiddel. Ook ondersteunt het een Learning Management System in het beheer van relevante Deeplinks voor Onderwijsdeelnemers (of -medewerkers).

Een Deeplink krijgt in dat geval het volgende formaat:

www.uitgever.nl/leermateriaal?product=12345678

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 van een geldige Aanspraak voor de Onderwijsdeelnemer (of -medewerker). De component Learning Management System heeft deze informatie verkregen via de Entitlement API.

...

Bestelomgeving leermiddelen de statusinformatie van de aanspraken op de leveringsorder inzien. Na voltooiing van alle stappen ziet de Besteller dat er een aanspraak is met de entitlementStatus entitled en de urlStatus processed.

Randvoorwaarden: aansluiting en beschikbare brongegevens

Leveranciers beschikken afhankelijk van de referentiecomponent die ze vervullen over actuele brongegevens en/of hebben onderling overeenkomsten afgesloten:

  • Indien de leermiddelenaanbieder, de verkoop laat verzorgen door een leermiddelenverkoper, dan hebben beide leveranciers bilaterale afspraken gemaakt en een overeenkomst gesloten.

  • Alle betrokken referentiecomponenten in de levering zijn technisch op elkaar aangesloten.

  • De referentiecomponenten Bestelomgeving leermiddelen, Aanspraakmanager, Leermiddelenportaal en Leermiddelendashboard beschikken over actuele informatie uit de Leveranciersspecfieke leermiddelencatalogus van de Leermiddelenaanbieder.

    • De Leermiddelenaanbieder 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 Levenscyclus en statussen Leermiddelen.

  • De Aanspraakmanager beschikt over actuele informatie uit het Administratiesysteem onderwijsdeelnemer van de onderwijsorganisatie.

    • Voor de Aanspraakmanager gelden specifieke verwerkingsregels ten aanzien van het verwerken van wijzigingen in Onderwijsdeelnemer of Lesgroep/Stamgroep informatie.

    • De verwerkingsregels zijn er op gericht om de open levervarianten Opleiding, Vak en Groep correct te laten werken.

  • De Bestelomgeving leermiddelen beschikt over actuele informatie uit het Administratiesysteem onderwijsdeelnemer van de onderwijsorganisatie indien een onderwijsorganisatie de Besteller is.

Anchor
activering
activering
Randvoorwaarden: regie op gegevens door onderwijsorganisaties

Om Leermiddelen succesvol te kunnen laten leveren tussen de betrokken leveranciers is het van belang dat de onderwijsorganisatie de gegevensuitwisselingen tussen de betrokken referentiecomponenten autoriseert. Meer informatie over het activeren van gegevensuitwisselingen is te vinden in de sectie Regie op gegevens.

Van:

Gegevensdienst

Gegevens

Naar:

Levervarianten

Administratiesysteem onderwijsdeelnemer

Onderwijsaanbod

Onderwijsorganisatie

AangebodenOpleiding

AangebodenVak

Bestelomgeving leermiddelen

School
Opleiding
Vak
Groep
Onderwijsdeelnemers
Onderwijsmedewerkers

Aanspraakmanager

Opleiding
Vak
Groep

Onderwijsinrichting

SchoolPeriode

Inschrijving

Groep

Bestelomgeving leermiddelen

Onderwijsdeelnemers

Aanspraakmanager

Opleiding
Vak
Groep

Onderwijsdeelnemers

Onderwijsdeelnemers

Bestelomgeving leermiddelen

Onderwijsdeelnemers

Onderwijsmedewerkers

Onderwijsmedewerkers

Bestelomgeving leermiddelen

Onderwijsmedewerkers

Aanspraakmanager

Aanspraken

Aanspraak

Leermiddelenportaal

Allen

Bestelomgeving leermiddelen

Leveringsorders

Leveringsorder

Leermiddelenportaal

School

Info

Geen Regie op gegevens tussen leermiddelenverkoper en leermiddelenaanbieder

Voor de uitwisseling van gegevens tussen referentiecomponenten van de leermiddelenverkoper en de leermiddelenaanbieder is geen toestemming nodig vanuit de onderwijsorganisatie. Als gevolg van de bilaterale overeenkomst tussen de leveranciers is er reeds doelbinding om de gegevens uit te wisselen.

Voor dit proces betreft het de volgende eisen:

  • De onderwijsorganisatie heeft de uitwisseling van gegevens geactiveerd conform bovenstaande tabel.

  • Het delen van informatie vanuit het Administratiesysteem onderwijsdeelnemer is afhankelijk van de gekozen levervariant. In de kolom Levervarianten is aangegeven voor welke levervarianten de gegevensdienst noodzakelijk is.

    • Voor de levervarianten Persoon met ID en Persoon met activatiecode is geen informatie uit het Administratiesysteem onderwijsdeelnemer vereist.

  • Een aantal gegevensdiensten bevatten persoonsgegevens en vereisen een verwerkersovereenkomst tussen de onderwijsorganisatie en de leverancier.

    • Het betreft de gegevenssoorten:

      • Onderwijsadministratie

      • Leveringsorders

      • Aanspraken

    • De Onderwijsorganisatie heeft derhalve een Verwerkersovereenkomst gesloten met alle betrokken leveranciers.

Technisch: APIs

Voor dit proces zijn de volgende brongegevens relevant:

De interactieanalyse maakt gebruik van de de:

...

Release notes

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.

  • 0.0.4: Delivery API toegevoegd voor communicatie tussen Bestelomgeving leermiddelen en Aanspraakmanager.

  • 0.0.5: Gegevensdiensten van SIS API opgesplitst in:

    • Onderwijsorganisatie

    • Adresgegevens fijndistributie

  • 0.0.6: De interactieanalyse is bijgewerkt op basis van de herziening van het Conceptueel model.

  • 0.9.0: Het Bestuurlijk Overleg heeft tijdens de bijeenkomst van 27 juni 2024 het Afsprakenstelsel Edu-V als versie 0.9.0 goedgekeurd voor implementatie.