Dienstenniveaus

Alle onderstaande dienstenniveaus worden onderling geleverd voor de uitwisseling van de betreffende gegevensdiensten waarvoor een Deelnemer is toegetreden. Hiervoor vindt onderling geen verrekening plaats. Voor alle afwijkende onderlinge afspraken geldt dat Deelnemers hierover zelf onderling aanvullende afspraken maken. Deze zijn niet in scope van het afsprakenstelsel Edu-V.

1.     Ontwikkeling koppelpunten

De Kandidaat-Deelnemer ontwikkeld voor eigen rekening en risico de gegevensdienst voor de uitwisseling van data. Deze ontwikkeling is op basis van de ketenstandaard die in technische zin adequaat en compleet is gedocumenteerd.

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.

2. Afspraken bij aansluiten gegevensdiensten

Deze afspraken gelden bij iedere bilaterale aansluiting tussen twee referentiecomponenten van verschillende Deelnemers. Een Deelnemer kan met een andere Deelnemer koppelen vanuit één of meerdere van deze referentiecomponenten. Bij het koppelen worden afspraken gemaakt welke gegevensdiensten er tussen de referentiecomponenten uitgewisseld worden.

Deelnemers hebben hun eigen procedure voor het aansluiten van andere Deelnemers. Voor deze procedure gelden de volgende operationele afspraken:

• 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:
  o Acceptatieomgeving (endpoints voor testdoeleinden)
  o Productieomgeving (endpoints)
  o Technische documentatie

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 wordt binnen 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.

3.     Beschikbaarheid

Dit betreft de beschikbaarheid van de gegevensdienst. 

a.     Beschikbaarheidsvenster:

*Tussen 7u en 22u is de beschikbaarheid volgens de norm gegarandeerd met de hiervoor beschikbare support. Daarbuiten is geen ondersteuning gegarandeerd.

De beschikbaarheid is een optelsom van de beschikbaarheid van de betrokken gegevensdiensten binnen het beschikaarheidsvenster.

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:

(Operationeel tijd / Beschikbaarheidstijd) x 100 = (in procenten).

Definities rekenmethode:

b.     Onderhoudsvenster:

Er zijn meerdere tijdslots voor het onderhoudsvenster. Afhankelijk van de impact van het onderhoud, wordt bepaald wanneer er onderhoud gepleegd wordt.

 Impactbepaling onderhoud:

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 gedurende specifieke periodes tijdens het jaar - en daarvoor gelden dan andere afspraken 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

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

Een incident is elke gebeurtenis die niet tot de standaardoperatie van een dienst behoort en die mogelijk impact/risico oplevert ten aanzien van kwaliteit, beschikbaarheid, integriteit en/of vertrouwelijkheid van (gegevens binnen) het netwerk.

Incidenten bij belangrijke gegevensdiensten:
Een aantal gegevensdiensten is van groot belang binnen de keten. De volgende gegevensdiensten worden groot belang geacht gedurende een specifieke periode:

Bij het berekenen van de impact, worden deze diensten benoemd bij impactfactor 8.

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.

 Dienstenniveaus:

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

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

In de dienstenniveau overeenkomst die deelnemers onderling overeenkomen is opgenomen hoe gerapporteerd wordt over bovenstaande dienstenniveaus. Rapportage vindt minimaal elk kwartaal plaats.