Dienstenniveaus

Alle onderstaande dienstenniveaus worden onderling geleverd voor de uitwisseling, realisatie en support 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 ontwikkelt voor eigen rekening en risico de gegevensdienst voor de uitwisseling van data. Deze ontwikkeling is op basis van afspraken over de gegevensdienst 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.

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 en bepalen of de onderlinge aansluiting in productie kan:
  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 (het in productie brengen van de gegevensdienst en bijbehorende API) 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 op werkdagen 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:

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 (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

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

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.