...
Er kunnen situaties voordoen waarbij op korte termijn onderhoud moet plaatsvinden. Dit onderhoud zoveel mogelijk binnen het onderhoudsvenster plannen. Als dat niet mogelijk is, dan z.s.m. communiceren naar andere partijen via het kanaal van de beheerorganisatie EDU-V.
4. Performance
Performance is datgene dat de gegevensdiensten leveren, uitgedrukt in tijd of aantallen. Doel is het waarborgen van een gebruiksbeleving, ook op piekmomenten.
...
Transactiepatroon
...
Metric
...
Normaal
...
Prio
...
Bevraging
...
Response tijd (inclusief verwerking)
...
300ms
...
150ms
...
Melding-bevestiging
...
Response tijd (ontvangstbevestiging)
...
50ms
...
25ms
...
Asynchrone uitwisseling
...
Response tijd (ontvangstbevestiging)
...
50ms
...
25ms
...
Verwerkingstijd (terugmelding)
...
300ms
...
150ms
...
Georkestreerde uitwisseling
...
Verwerkingstijd (totale verwerking van alle onderliggende asynchrone uitwisseling)
...
900ms
...
In het Edu-V afsprakenstelsel zijn leveranciers actief als gegevensaanbieder of gegevensafnemer. In een gegevensuitwisseling tussen gegevensaanbieder en gegevensafnemer kunnen leveranciers op elkaar vertrouwen en bouwen.
Gegevensuitwisselingen t.b.v. een eindgebruiker
De gegevensuitwisseling tussen een gegevensaanbieder en een gegevensafnemer wordt geïnitieerd vanuit een eindgebruiker.
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 het Edu-V afsprakenstelsel zijn de gegevensdiensten onderwijsaanbod, onderwijsinrichting, onderwijsdeelnemers, onderwijsmedewerkers, leermiddelen en leermaterialen.
Voor deze gegevensuitwisselingen 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 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 van de gegevensaanbieder naar de gegevensaanbieder. Optioneel meldt de gegevensafnemer terug aan de gegevensaanbieder dat de gegevens zijn verwerkt.
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
...