OSO:2022/Architectuur/Proces

Dossier uitwisseling

Vanaf OSO'18 worden er twee soorten uitwisselingen ondersteund:

• Overstap tussen Scholen
• Aanvragen bij Samenwerkingsverbanden Passend Onderwijs

In beide typen wordt een dossier uitgewisseld via het basisberichtenverkeer zoals hieronder beschreven. Daarnaast kennen beide varianten hun eigen uitbreidingen hierop:

• Notificatie na Aanvraag (Schooluitwisseling)
• Notificatie met KoppelSleutel (Samenwerkingsverband - Passend Onderwijs)
• Terugkoppeling naar School (Samenwerkingsverband - Passend Onderwijs)

Dossier uitwisseling voor Overstap tussen Scholen

In de figuur worden de stappen en berichten weergegeven die bij een succesvolle dossier overdracht worden doorlopen. Deze worden hieronder beschreven:

1. Het doelsysteem verzendt een aanvraag (OverdrachtRequest) naar het Traffic Center (TC) voor het opvragen van een dossier. Het initiatief voor de uitwisseling ligt bij de (medewerker van de) Doelschool.

   De aanvraag bevat het versleutelde BSN van de leerling . Het TC controleert of het doelsysteem bekend en gekwalificeerd is (zowel de school als de leverancier moeten gekwalificeerd zijn). Als dit het geval is, wordt een sessie id toegekend en teruggestuurd naar het aanvragende systeem (OverdrachtResponse). Sessie intiëren

   Binnen één Sessie word per bevraagd routeringskenmerk de berichten .2, .3 en .4 verzonden/ontvangen; deze kunnen meerdere malen binnen één Sessie voorkomen. (Berichten .1 en .5 worden éénmaal per Sessie uitgewisseld.)

2. Het doelsysteem verzendt een aanvraag voor een dossier naar het systeem van de huidige school (DocumentRequest), het bronsysteem.

   De aanvraag bevat de BSN van de leerling (één dossier per aanvraag) en het sessie id. Het bronsysteem vraagt vervolgens eerst een controle op de sessie gegevens op bij het TC. Dossier opvragen

3. Het bronsysteem verzendt een sessie controle verzoek (SessiecontroleRequest) naar het TC.

   Dit verzoek bevat het versleutelde BSN en de sessie id uit bericht 2. Het TC controleert deze gegevens; wanneer deze overeenkomen met een uitgegeven nog niet verlopen sessie wordt een ok teruggegeven (SessiecontroleResponse). Controleren sessie

4. Het bronsysteem verstrekt het dossier aan het doelsysteem (DocumentResponse).

   Als het gevraagde dossier beschikbaar is wordt een valide dossier geleverd; indien het dossier niet beschikbaar is (onbekend of nog niet gereed voor verzending) wordt de bijbehorende foutmelding verstuurd. De levering van het dossier en de foutmeldingen vormen de response op bericht 2 en wordt beschreven in Dossier opvragen.

5. Het doelsystem meldt de aanvraag af bij het TC. Bij het afmelden (AfmeldingRequest) geeft het doelsysteem aan of het dossier is ontvangen, of dit valide was of dat het niet beschikbaar was bij het bronsysteem. Het TC antwoordt (AfmeldingResponse) en administreert het resultaat en ruimt de sessie gegevens op. Sessie afmelden

Routeringskenmerken

Voor het de uitwisseling van Dossiers via OSO maakt de school gebruik van een of meerdere leerlingadministratiesystemen (LASsen) of regionale platforms (RPs).Een school zelf kan een centrale administratie hebben of deze verspreid hebben opgezet over meerdere vestigingen. Per vestiging kunnen dan ook een of meerdere systemen gebruikt worden
.

Het koppelvlak van een schoolsysteem met OSO een Routeringskenmerk (RK). Via het RK wisselt een schoolsysteem informatie uit met het TC en andere OSO systemen. Een RK wordt gekoppeld aan de school en (optioneel) een vestiging.

Notificatie na Aanvraag (Schooluitwisseling)

In de figuur worden de stappen en berichten weergegeven die bij een Notificatie na Aanvraag worden doorlopen. Deze worden hieronder beschreven:

• A: Het Bronsysteem meldt een Notificatie bij het Traffic Center. Het Traffic Center controleert of het endpoint dat de Notificatie moet ontvangen valide is en een url heeft geregistreerd. Als dit het geval is, wordt de url teruggegeven aan het Bronsysteem.
• B: Het Bronsysteem verstuurt de Notificatie (na ontvangst van de url) naar het Routeringskenmerk dat het Dossier eerder heeft aangevraagd.

Notificatie met KoppelSleutel (Samenwerkingsverband - Passend Onderwijs)

Deze uitwisseling wijkt af van de 'normale'uitwisseling voor de overstap tussen scholen, doordat:

• initiatief ligt bij (de medewerker van) de School van het BronSysteem
• de eerste stap een (special vorm van) Notificatie is

In de figuur worden de stappen en berichten weergegeven die bij een Notificatie met Koppelsleutel worden doorlopen. Deze worden hieronder beschreven:

• A: Het Bronsysteem (LAS) initieert een Notificatie bij het Traffic Center. Het Traffic Center controleert of het Routeringskenmerk dat de Notificatie moet ontvangen valide is en bij dezelfde school is geregistreerd(BRIN). Als dit het geval is, wordt en een nieuw gegenereerde KoppelSleutel én de url teruggegeven aan het Bronsysteem.
• B: Het Bronsysteem verstuurt vervolgens de Notificatie met Koppelsleutel naar het Routeringskenmerk. Het Doelsysteem start vervolgens een Dossier uitvraag met behulp van de Koppelsleutel.

Push en Pull

In OSO is sprake van een 'pull mechanisme' waarbij de Doelschool het initiatief neemt voor het opvragen van een Dossier bij de Bronschool. De Doelschool heeft daarbij het PGN van het desbetreffende Dossier nodig. Dit verkrijgt de Doelschool buiten OSO om bij de aanmelding/inschrijving van een leerling bij de Doelschool.

In OSO'18 worden Samenwerkingsverbanden Passend Onderwijs aangesloten op OSO. In dit uitwisselproces is sprake van een 'push', waarbij de Bronschool het initiatief heeft. In het LAS van een School wordt een Dossier aangemerkt voor verzending naar een Samenwerkingsverband. Hierna wordt via een Notificatie een Koppelsleutel naar het Samenwerkingsverband systeem (SWV of RP) verstuurd (de PGN mag voor deze overdracht niet gebruikt). Met behulp van de KoppelSleutel wordt het Dossier vervolgens opgevraagd bij de Bronschool.

Sleutel tussen Systemen

In OSO wordt gebruik gemaakt van twee typen sleutels om Dossiers tussen verschillende systemen aan te duiden. De eerste is de 'Zoeksleutel', een sleutel gebaseerd op een gecodeerde versie van het PGN van het Dossier. De tweede is de 'KoppelSleutel', een aanduiding die wordt verstrekt door het TC aan het bronsysteem en via een notificatie naar het doelsysteem verstuurd.

Zoeksleutel

In OSO wordt het Persoonsgebonden Nummer (PGN) toegepast als 'key' voor het Dossier. De PGN is of het BSN of het Onderwijsnummer van de leerling. Bij aanroepen van het TC wordt het PGN versleuteld doorgegeven in het Zoeksleutel veld.
De Zoeksleutel kan door Systemen niet ontsleuteld worden (de Key is niet bekend bij deelnemende systemen).

De Zoeksleutel wordt door het Doelsysteem aangemaakt bij het aanvragen van de Sessie. Vervolgens wordt de Zoeksleutel via het DocumentRequest van Doel- naar Bron- systeem verstuurd. Het Bronsysteem stuurt de Zoeksleutel mee met de SessieControle.

KoppelSleutel

De Koppelsleutel wordt in plaats van de Zoeksleutel gebruikt bij de uitwisselingen in het kader van de aanvragen bij Samenwerkingsverbanden Passend Onderwijs. De KoppelSleutel wordt aan het Bronsysteem verstrekt door het TC bij het melden van een Notificatie. Via de Notificatie wordt deze dan doorgeven aan het Bronsysteem.
Een Koppelsleutel is uniek en alleen geldig voor de specifieke uitwisseling en terugkoppeling(en) van:

• Bron Routeringskenmerk
• Dossier
• Doel Routeringskenmerk