OSO:2018/Controleren Sessie

Uit Kennisnet Developers Documentatie
Ga naar: navigatie, zoeken
Actor(s) Goal(s)
Traffic Center Bewaken van integriteit van sessie
Bronsysteem Vaststellen dat ontvangen verzoek een valide en geldig verzoek voor een specifiek dossier is

Preconditie

  • BronSysteem is toegelaten op OSO keten
  • BronSysteem heeft geldig OSO certificaat
  • BronSysteem heeft DossierRequest ontvangen van DoelSysteem

Postconditie

  • Traffic Center heeft vastgesteld of gegevens uit verzoek voor Dossier overeenkomen met gegevens uit toegekende sessie.
  • Traffic Center heeft vastgesteld dat Bron- én Doel- systeem valide en actieve systemen zijn binnen de OSO keten.

Basisvariant

  1. Als Doelsysteem en Bronsysteem aangesloten zijn op OSO
    1. Als gegevens uit verzoek (Documentrequest) van Doelsysteem overeenkomen met gegevens uit sessie en Pgnfrag gelijk is aan Pgnfrag van sessie*
      1. Traffic Center geeft sector van de Doelschool terug
      2. Bronsysteem levert Dossier aan Doelsysteem
  2. Anders
    1. Traffic Center geeft foutmelding
    2. Bronsysteem geeft foutmelding door aan Doelsysteem

*Uitbreiding in OSO'18 (Link naar beschrijving).

Uitzonderingen en meldingen

Resultaat Type flow (N, A, E*) Omschrijving
Sessie is valide N De sector van het doelSysteem wordt teruggegeven als resultaat.
SessieAfwijkend A De combinatie bron/doel brin, overdrachtsoort en zoeksleutel/koppelsleutel moeten hetzelfde zijn als in het overdrachtsRequest. Ook moet de PGNfrag gelijk zijn de PGNfrag van de Sessie.
OnbekendAanleverpunt A Het bronaanleverpunt komt niet voor in de Sessie.
Er is of een ander AP in het overdrachtsRequest aangegeven (Specifieke overdracht) of het AP zat niet in de lijst die het TC uitgaf bij de Sessie aanvraag.
GeenRelatieMetDoel A Indien overdrachtsoort overdrachtbinnenbrin betreft, maar doel- en bronbrin wijken af
VerstrekkerNietBekend A Bronschool (BRIN) is niet bekend bij het Traffic Center
VerstrekkerAanleverpuntNietBekend A Bronaanleverpunt (BRIN + APindex) is niet bekend bij het Traffic Center
VerstrekkerNietBeschikbaar A Bronsysteem is niet gerechtigd om de overstapservice te gebruiken.
OngeautoriseerdAanleverpunt E Bronsysteem (aanvragend AP) is in het Register geregistreerd met andere Leverancier.
AanvragerNietBekend A De Doelschool (BRIN) is niet bekend bij het Traffic Center
AanvragerAanleverpuntNietBekend A Doelaanleverpunt (BRIN + APindex) is niet bekend bij het Traffic Center
AanvragerNietBeschikbaar A Doelsysteem (aanvragend AP) is (nog) niet gerechtigd om gebruik te maken van de overstapservice
SessieOngeldig E Het sessieId komt niet overeen met een door het TC uitgedeeld sessieID
SessieReedsAfgemeld E Het sessieId verwijst naar een sessie die al is afgemeld.
SessieVerlopen E Het sessieId is verlopen. Na 10 minuten verloopt de sessie.

* N: Normaal, A: Alternatief, E: Exceptie (fout)

Aanroep en antwoord

  • Request (voorbeel van OV controle):
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.kennisnet.nl/schemas/Overstapservice/20180404">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:sessiecontroleRequest>
         <ns:bronBrin>00AH</ns:bronBrin>
         <ns:bronAanleverpuntIndex>18</ns:bronAanleverpuntIndex>
         <ns:doelBrin>12SS</ns:doelBrin>
         <ns:doelAanleverpuntIndex>1</ns:doelAanleverpuntIndex>
         <!--You have a CHOICE of the next 2 items at this level-->
         <ns:zoeksleutel>SytZo1IuJ+Q+efm0oSd5kRngAz6NgzGDgCQEt1jo/FmoFfNlandlJ+kyfETaklBuoDPEVH0GVy5
 ySuoWyNIFbLFXXKEk+0THR7swVYa2K33xspMbFaL00NM62mA/bjbhPUJdTcwdHk/OnxnWvu/fYy5
 4y6Bn3hxkUf194biYk8=</ns:zoeksleutel>
         <ns:overdrachtsoort>overstapdossier</ns:overdrachtsoort>
         <ns:sessieId>b8b9a132-51ca-4188-8de7-323842336156</ns:sessieId>
      </ns:sessiecontroleRequest>
   </soapenv:Body>
</soapenv:Envelope>


  • Request (voorbeel van PaO controle):
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.kennisnet.nl/schemas/Overstapservice/20180404">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:sessiecontroleRequest>
         <ns:bronBrin>00AH</ns:bronBrin>
         <ns:bronAanleverpuntIndex>19</ns:bronAanleverpuntIndex>
         <ns:doelBrin>00AH</ns:doelBrin>
         <ns:doelAanleverpuntIndex>19</ns:doelAanleverpuntIndex>
         <!--You have a CHOICE of the next 2 items at this level-->
         <ns:koppelsleutel>19677A96-B737-402E-B3B8-24A3EEF32000</ns:koppelsleutel>
         <ns:overdrachtsoort>swv-dossier</ns:overdrachtsoort>
         <ns:sessieId>60d2909f-169f-4cb0-8256-5d1d5af1491d</ns:sessieId>
      </ns:sessiecontroleRequest>
   </soapenv:Body>
</soapenv:Envelope>


Element Uitleg Opmerkingen
bronBRIN Dit is het brinnummer van de bronschool die het het dossier moet uitleveren. De bronschool kan meerdere aanleverpunten hebben.
bronAanleverpuntIndex Dit is de index van het aanleverpunt van het bronsysteem dat bevraagd wordt (optioneel). Deze parameter kan meegegeven worden als het doelsysteem één specifiek aanleverpunt van de school wil bevragen.
doelBrin Dit is het brinnummer van het doelsysteem dat de sessie heeft aangevraagd met de overdrachtRequest. Het TC controleert of het doelsysteem bekend en actief is in het deelnemersregister.
doelAanleverpuntIndex Dit is de index van het aanleverpunt van het doelsysteem dat de sessie heeft aangevraagd met de overdrachtRequest.
zoeksleutel De zoeksleutel wordt overgenomen uit het documentRequest. Afhankelijk van de overdrachtsoort zal of de zoeksleutel of de koppelsleutel gevuld (moeten) zijn.
koppelsleutel De koppelsleutel wordt overgenomen uit het documentRequest. Afhankelijk van de overdrachtsoort zal of de zoeksleutel of de koppelsleutel gevuld (moeten) zijn.
overdrachtsoort De overdrachtsoort moet voor alle berichten in de sessie gelijk zijn Het brinnummer van het bron- en doelBrin moet hetzelfde zijn voor een binnenbrin overdracht.
sessieId
  • Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.kennisnet.nl/schemas/Overstapservice/20180404">
	<soapenv:Header/>
	<soapenv:Body>
		<ns:sessiecontroleResponse>
			<ns:sectorAanvrager>PO</ns:sectorAanvrager>
		</ns:sessiecontroleResponse>
	</soapenv:Body>
</soapenv:Envelope>