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.

...

*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:

...

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.  

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

...

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:

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.

 *uit ROSA certificeringsschema https://www.edustandaard.nl/standaard_afspraken/certificeringsschema-informatiebeveiliging-en-privacy-rosa/certificeringsschema-informatiebeveiliging-en-privacy-rosa-v3-0/

**alleen werkdagen

 Dienstenniveaus:

...

*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.

...

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.