Page Comparison

...

Let op: het impact en het risico is voor de hele keten en niet alleen voor de eigen gegevensdienst.

Aankondiging onderhoud

Geplande onderhoudswerkzaamheden aan diensten, die kunnen leiden tot niet-beschikbaar zijn van de dienstverlening worden minimaal vijf werkdagen van tevoren bekend gemaakt via een kanaal van de beheerorganisatie Edu-V.  

...

Gegevensuitwisselingen t.b.v. een eindgebruiker
De gegevensuitwisseling tussen een gegevensaanbieder en een gegevensafnemer wordt geïnitieerd vanuit een eindgebruiker.

Voor  In het Edu-V afsprakenstelsel betreft dit de gegevensdiensten:

• ID-verklaring

• Licentieverificatie

• Leermiddelgebruik

• Aanspraken (bevraging)

 Voor deze gegevensuitwisselingen hanteren we de volgende richtlijnen:

• Een eindgebruiker ervaart bij normaal gebruik van een applicatie geen vertraging als gevolg van een gegevensuitwisseling met een andere applicatie.

  • De totale response en verwerkingstijd is maximaal 1 seconde.

• Bij het genereren van een totaaloverzicht in een dashboard waarbij het dashboard gegevens verzamelt uit meerdere gegevensaanbieders is enige vertraging toegestaan.

  • De totale response en verwerkingstijd is maximaal 10 seconden..

Gegevensuitwisselingen uit een bron
De gegevensuitwisseling betreft het opvragen van gegevens door een gegevensafnemer bij een gegevensaanbieder die een bron aanbiedt.

Voorbeelden van bronnen in In het Edu-V afsprakenstelsel zijn de gegevensdiensten onderwijsaanbod, onderwijsinrichting, onderwijsdeelnemers, onderwijsmedewerkers, leermiddelen en leermaterialen.Voor deze gegevensuitwisselingen betreft dit de gegevensdiensten:

• Onderwijsdeelnemers

• Onderwijsaanbod

• Onderwijsinrichting

• Onderwijsmedewerkers

• Leermiddelen

• Leermaterialen

 Voor gegevensuitwisselingen uit een stand hanteren we de volgende richtlijnen:

• Een gegevensafnemer hanteert bij het opvragen van gegevens uit een bron bij een gegevensaanbieder altijd de since parameter.

  • De since parameter zorgt ervoor dat alleen de wijzigingen vanaf een bepaalde tijdstempel uit de bron worden opgehaald.

  • De since parameter die gehanteerd wordt is maximaal 7 dagen geleden.

  • De gegevensafnemer is zelf verantwoordelijk voor het verwerken van wijzigingen. Het is nadrukkelijk niet de bedoeling om als gegevensafnemer periodiek de volledige stand op te halen bij de gegevensaanbieder.

• De volledige stand kan opgehaald worden bij de start van een nieuwe uitwisselingsrelatie (initiële stand) en bij incidenten.

  • Het opvragen van een initiële stand is een relatief zwaar verzoek aan de gegevensaanbieder. Dit verzoek mag niet leiden tot interrupties in de beschikbaarheid van gegevensaanbieder. Deze verzoeken worden daarom niet uitgevoerd in piekuren.

  • Het opvragen van een initiële stand is tenminste niet toegestaan tussen 8:00 en 17:00 uur.

• Een gegevensaanbieder kan optioneel een notificatieservice aanbieden voor het toesturen van een notificatie bij wijzigingen aan een object uit een stand. Deze notificatieservice is niet verplicht en valt buiten de standaarddienstverlening.

• Het is niet toegestaan om als gegevensafnemer een polling mechanisme toe te passen om hoogfrequent gegevens op te vragen bij een gegevensaanbieder.

• Voor het opvragen van gegevens hanteren we de volgende maximale response en verwerkingstijden:

  • Enkel object: 300 milliseconden

  • Grote batch: 1.500 milliseconden

  • Initiële stand: 3.000 milliseconden

Gegevensuitwisselingen van transacties
De gegevensuitwisseling betreft een transactie melding van de gegevensaanbieder naar de gegevensaanbieder. Optioneel meldt de gegevensafnemer terug aan de gegevensaanbieder dat de gegevens zijn verwerkt.gegevensafnemer.

In het Edu-V afsprakenstelsel betreft dit de gegevensdiensten:

• Leermiddelactivatie

• Leerresultaten

• Leermateriaalgebruik 

Voor deze gegevensuitwisselingen hanteren we de volgende richtlijnen:

• De gegevensuitwisselingen worden asynchroon verwerkt conform het transactiepatroon melding-bevestiging, asynchrone uitwisseling of georkestreerde uitwisseling.

• De gegevensaanbieder moet in alle in het voorgaande punt genoemde transactiepatronen in staat zijn om hoogfrequent meldingen te versturen naar gegevensafnemers.

  • De implicatie hiervan is dat de gegevensafnemer beschikbaar is om meldingen in ontvangst te nemen. De verwerking van de melding kan daarna worden uitgevoerd.

  • De maximale responsetijd van een ontvangstbevestiging op een melding is 50 milliseconde.

  Een gegevensaanbieder die afhankelijk is van een terugmelding na verwerking door een gegevensafnemer moet niet onnodig beperkt worden in de uitvoering van vervolgprocessen.

  • De maximale tijd tussen de ontvangstbevestiging van een melding en ontvangstbevestiging van een terugmelding is 300 milliseconde.

5.     Incidenten/storingen en oplosstreeftijden

...

...