Beschrijving dienstenniveaus
Alle onderstaande dienstenniveaus worden onderling geleverd voor de uitwisseling, realisatie en support van de betreffende gegevensdiensten waarvoor een leverancier Deelnemer is toegetreden. Hiervoor vindt onderling geen verrekening plaats. Voor alle afwijkende onderlinge afspraken geldt dat leveranciers hierover zelf overeenkomsten moeten sluitenDeelnemers hierover zelf onderling aanvullende afspraken maken. Deze zijn niet in scope van het afsprakenstelsel Edu-V.
1. Ontwikkeling koppelpunten
De Kandidaat-Deelnemer ontwikkeld ontwikkelt voor eigen rekening en risico de gegevensdienst voor de uitwisseling van data. Deze ontwikkeling is op basis van afspraken over de ketenstandaard die in technische zin adequaat en compleet is gedocumenteerdgegevensdienst in het afsprakenstelsel.
Als de Kandidaat-Deelnemer zich kwalificeert voor de referentiecomponent met bijbehorende gegevensdiensten en er jaarlijkse testen worden uitgevoerd als onderdeel van het beheer van het stelsel dan vindt er geen onderlinge verrekening plaats voor de uitvoering hiervan.
...
Deelnemers bepalen welke gegevensdiensten er onderling uitgewisseld gaan worden.
De mogelijkheden zijn afhankelijk van de door de Deelnemers gekozen en geïmplementeerde referentiecomponenten en gegevensdiensten.
Wat er uitgewisseld wordt, moet passen binnen hetgeen in de afspraken is beschreven voor de gegevensdienst(en) waarvoor de partij is toegetreden.
Deelnemers testen de aansluiting. Deelnemers delen hiervoor de noodzakelijke gegevens met elkaar en bepalen of de onderlinge aansluiting in productie kan:
o Acceptatieomgeving (endpoints voor testdoeleinden)
o Productieomgeving (endpoints)
o Technische documentatie
Bron: M2M gegevensuitwisselingen - Afsprakenstelsel Edu-V - Confluence (atlassian.net)
Het doorlopen van de aansluiting tussen gegevensdiensten wordt in onderlinge afstemming geregeld. Als aan de afspraken binnen Edu-V wordt voldaan, dan worden hier geen kosten voor in rekening gebracht voor de aansluiting. De aansluiting (het in productie brengen van de gegevensdienst en bijbehorende API) wordt binnen 14 15 werkdagen tot stand gebracht. De begeleiding van het daadwerkelijke aansluitproces vraagt niet meer dan 6 uur van de leverende partij. Indien meer begeleiding noodzakelijk is, dan kunnen Deelnemers hiervoor onderling aanvullende afspraken maken. Deze afspraken vallen buiten scope van het Afsprakenstelsel Edu-V.
...
Beschikbaarheidsvenster | Minimale beschikbaarheid per gegevensdienst |
tussen 7u en 22u* | 99,5% per maand |
*Tussen 7u en 22u op werkdagen is de beschikbaarheid volgens de norm gegarandeerd met de hiervoor beschikbare support. Daarbuiten is geen ondersteuning gegarandeerd.
...
Het is een inspanningsverplichting om over de gehele keten binnen het beschikbaarheidvenster de beschikbaarheid van de gegevensdienst te waarborgen. Het uitgangspunt is niet om individuele partijen af te rekenen op de beschikbaarheid in de gehele keten.
Rekenmethode voorstel:
Een Deelnemer dient de beschikbaarheid per rol als volgt te berekenen:
...
Definities rekenmethode:
Rapportage periode | Per kalendermaandkwartaal |
Totaal tijd | Dagen Werkdagen in de maand x uren per dag (24 15 uur) |
Incident tijd | Tijd dat een rol gegevensdienst niet operationeel is door een incident (in uren) |
Onderhoudstijd | Tijd dat een rol gegevensdienst niet operationeel is door onderhoud (in uren) |
Beschikbaarheidstijd | Tijd dat een rol gegevensdienst operationeel moet zijn (totaal tijd - onderhoudstijd) |
Operationeel tijd | Tijd dat een rol gegevensdienst operationeel is (totaal tijd - incident tijd - onderhoudstijd) |
Beschikbaar (A) | percentage dat rol gegevensdienst operationeel is |
Niet beschikbaar (NA) | percentage dat een rol gegevensdienst niet operationeel is |
Formule beschikbaarheid | (Operationeel tijd / Beschikbaarheidstijd) x 100 = (in procenten) |
...
Let op: het impact en het risico is voor de hele keten en niet alleen voor de eigen gegevensdienst.
| Dagen | Tijden |
Weekend | Zaterdag |
en zondag | 20:00 – 06:00 uur |
Avond/nacht | Maandag t/m vrijdag |
23:00 – |
07:00 uur |
Einde nacht/overdag | Dinsdag | 05:00 – 07:00 uur |
Overdag | Vrijdag | 17:00 – 18:00 uur |
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.
Streven is om een dienst niet-beschikbaar door onderhoud wordt beperkt tot hooguit 6 uur per maand. Dit is afhankelijk van de gegevensdienst – sommige gegevensdiensten zijn essentieel tijdens Start Schooljaar en daarvoor gelden dan andere afspraken gedurende specifieke periodes tijdens het jaar (zie bij 5 Incidenten/storingen en oplosstreeftijden) – en hiervoor vindt overleg plaats met Edu-V over onderhoud.
Ongepland onderhoud
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
...
500ms
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.
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.
In het Edu-V afsprakenstelsel 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 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 melding van de gegevensaanbieder naar de 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.
De gegevensaanbieder moet 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.
5. Incidenten/storingen en oplosstreeftijden
Een incident is elke gebeurtenis die niet tot de standaardoperatie van een dienst gegevensdienst binnen het afsprakenstelsel behoort en die mogelijk impact/risico oplevert ten aanzien van kwaliteit, beschikbaarheid, integriteit en/of vertrouwelijkheid van (gegevens binnen) het netwerk.
Incidenten bij cruciale gegevensdiensten:
Een aantal gegevensdiensten is cruciaal binnen de keten. De volgende gegevensdiensten worden cruciaal bevonden en gedurende welke periode:
Gegevensdienst | Periode waarin de gegevensdienst cruciaal is |
Onderwijsadministratie | Hele jaar |
Leveringsorders | Bestelperiode: juli, augustus, september |
Aanspraken en leermiddelactivatie | Hele jaar |
Leermiddelorders | Bestelperiode: juli, augustus, september |
Activatiecodeverzoek | Bestelperiode: juli, augustus, september |
Leermateriaalgebruik | Hele jaar |
Bij het berekenen van de impact, worden deze diensten benoemd bij impactfactor 8Het incident heeft effect op een bedrijfsproces en/of het primaire proces op school- en leerlingniveau.
Impact en urgentie vormen samen de prioriteit van een incident. Impact: Het effect van een incident op een bedrijfsproces en/of het primaire proces op school- en leerlingniveau. Urgentie: een meting hoe lang het zal duren voordat het incident een belangrijke impact heeft op bedrijfsprocessen.
Impact |
| Urgentie | ||
Aantal deelnemers | Impactfactor | Kan uitwijken/uitstellen | Urgentiefactor | |
Enkele andere deelnemer | 1 (laag) | 1 week | 1 (laag)* | |
Meerdere deelnemers | 2 (laag) | Tot overmorgen (+/- 48 uur)** | 2 (laag)* | |
Enkele praktijkcasus praktijksituatie | 4 (midden) | Tot morgen (+/- 24 uur)** | 4 (midden)* | |
Meerdere praktijkcasussen praktijksituaties | 8 (hoog) | Niet | 8 (hoog)* | |
Cruciale gegevensdiensten | 8 |
|
|
|
*uit ROSA certificeringsschema https://www.edustandaard.nl/standaard_afspraken/certificeringsschema-informatiebeveiliging-en-privacy-rosa/certificeringsschema-informatiebeveiliging-en-privacy-rosa-v3-0/
**alleen werkdagen
Dienstenniveaus:
Prioriteit bepalen met bijbehoredende bijbehorende service levels | ||||
Waarde | Prioriteit | Responstijd | Oplos-streeftijd | Escalatie |
64 | 1 (spoed) | Binnen 2 uur* | Binnen 8 uur* | 8 uur* |
32/16 | 2 (hoog) | Binnen 4 uur* | Binnen 2 werkdagen | 16 uur* |
2, 4 en 8 | 3 (normal) | Binnen 8 uur* | Binnen 3 werkdagen | 4e dag |
1 | 4 (laag) | Binnen 16 uur | Binnen 1 week | 5 werkdagen |
...
* |
...
Elke leverancier heeft een incidentmanager.
Proces bij incidenten/storingen:
Overzicht van de processtappen bij een incident/storing:
Intake van het incident/storing
Beoordeling
Behandelen van incident/storing
Monitoren, informeren en ondersteunen
Sluiten incident/storing
Opstellen rapportage
Intake incident/storing
Activiteit
Een Deelnemer meldt incident/storing bij de incidentmanager van Stichting Edu-V. Communicatie naar alle Deelnemers wordt opgestart, zodat alle Deelnemers geïnformeerd worden over het incident/de storing
Beoordeling
Activiteit
De incidentmanager van de betreffende Deelnemer beoordeelt aan de hand van het impact en urgentiemodel wat de impact is en meldt dit bij de incidentmanager van Stichting Edu-V
Behandelen incident/storing
Activiteit
Er worden één of meerdere partij(en) aangewezen die verantwoordelijk zijn voor het verhelpen van het incident onder regie van Stichting Edu-V.
Stichting Edu-V coördineert de acties en het contact met de andere partijen.
Monitoren, informeren en ondersteunen
Activiteit
De incidentmanager van Stichting Edu-V coördineert het contact met andere betrokken partijen, bewaakt de acties en biedt indien nodig ondersteuning.
Sluiten incident/storing
Activiteit
De oplossende partij geeft een signaal aan de incidentmanager van Stichting Edu-V zodra het incident is opgelost. De incidentmanager van Stichting Edu-V meldt dit aan de overige deelnemers
Opstellen rapportages derden
Activiteit
Door de incidentmanager wordt een samenvatting gemaakt met daarin:
De aard van incident/storing
De oorzaak van incident/storing
Eventuele trends in aard en oorzaak van incidenten/storingen
In overleg met de incidentmanager | In overleg met de incidentmanager |
*Dit betreft uren tijdens werkdagen
Tijden gelden vanaf melding bij incidentmanager Deelnemer.
Escalatieproces wordt nog nader uitgewerkt.
Elke Deelnemer heeft een incidentmanager. Partijen volgen het Incidenten en calamiteitenproces.
6. Helpdesk
De helpdeskafspraken zoals ook toegepast in het Toetredingsbeleid: Richtlijnen Help- en servicedesk - Afsprakenstelsel Edu-V - Confluence (atlassian.net)
7. Rapportage
Rapportage over bovenstaande dienstenniveaus vindt minimaal elk kwartaal aan Stichting Edu-V plaats.