OSO:2022/Controleren Sessie: verschil tussen versies

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen
k
 
Regel 46: Regel 46:
 
| OnbekendAanleverpunt
  
| OnbekendAanleverpunt
 
| A
  
| A
−
| | Het bronaanleverpunt komt niet voor in de Sessie.<BR>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.
 +
| | Het bronrouteringskenmerk komt niet voor in de Sessie.<BR>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
  
| GeenRelatieMetDoel
Regel 59: Regel 59:
 
| VerstrekkerAanleverpuntNietBekend
  
| VerstrekkerAanleverpuntNietBekend
 
| A
  
| A
−
| | Bronaanleverpunt (BRIN + APindex) is niet bekend bij het Traffic Center
+
| | Bronaanleverpunt (BRIN + bronRouteringskenmerk) is niet bekend bij het Traffic Center
 
|-
  
|-
   
Regel 74: Regel 74:
 
| AanvragerAanleverpuntNietBekend
  
| AanvragerAanleverpuntNietBekend
 
| A
  
| A
−
| Doelaanleverpunt (BRIN + APindex) is niet bekend bij het Traffic Center
+
| Doelaanleverpunt (BRIN + doelRouteringskenmerk) is niet bekend bij het Traffic Center
 
|-
  
|-
   
Regel 189: Regel 189:
 
| bronBRIN
  
| bronBRIN
 
| Dit is het brinnummer van de bronschool die het het dossier moet uitleveren.
  
| Dit is het brinnummer van de bronschool die het het dossier moet uitleveren.
−
| De bronschool kan meerdere aanleverpunten hebben.
 +
| De bronschool kan meerdere routeringskenmerken hebben.
   
 
|-
  
|-
 
| bronRouteringsKenmerk
  
| bronRouteringsKenmerk
 
| Dit is het routeringskenmerk van het bronsysteem dat bevraagd wordt (optioneel).
  
| Dit is het routeringskenmerk van het bronsysteem dat bevraagd wordt (optioneel).
−
| Deze parameter kan meegegeven worden als het doelsysteem één specifiek aanleverpunt van de school wil bevragen.
 +
| Deze parameter kan meegegeven worden als het doelsysteem één specifiek routeringskenmerken van de school wil bevragen.
   
 
|-
  
|-

Huidige versie van 19 jan 2022 om 14:19

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 bronrouteringskenmerk 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 + bronRouteringskenmerk) is niet bekend bij het Traffic Center
VerstrekkerNietBeschikbaar A Bronsysteem is niet gerechtigd om de overstapservice te gebruiken.
AanvragerNietBekend A De Doelschool (BRIN) is niet bekend bij het Traffic Center
AanvragerAanleverpuntNietBekend A Doelaanleverpunt (BRIN + doelRouteringskenmerk) 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.
RegistratieLeverancierOntbreekt E Leverancier is niet in het OSR geregistreerd.
GeenContractLeverancier E Leverancier heeft geen contract in het OSR.
LeverancierNietGekwalificeerd E De leverancier is niet gekwalificeerd.
GeenMandaatLeverancier E De leverancier heeft geen mandaat in het OSR.
AdministratiesysteemGeenType E Er is geen type voor deze leverancier geconfigureerd.
BronBRINIncorrectRouteringskenmerk E Bron BRIN en bron routeringskenmerk komen niet overeen in het OSR.
DoelBRINIncorrectRouteringskenmerk E Doel BRIN en doel routeringskenmerk komen niet overeen in het OSR.

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

Aanroep en antwoord

  • Request (voorbeel van OV controle):
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://xml.kennisnet.nl/schemas/Overstapservice/20200910">
  <SOAP-ENV:Body>
    <ns1:sessiecontroleRequest>
      <ns1:bronBrin>00YY</ns1:bronBrin>
      <ns1:bronRouteringsKenmerk>0000000700000YY00931</ns1:bronRouteringsKenmerk>
      <ns1:doelBrin>00YY</ns1:doelBrin>
      <ns1:doelRouteringsKenmerk>0000000700000YY00932</ns1:doelRouteringsKenmerk>
      <ns1:zoeksleutelPgnfrag>
        <ns1:zoeksleutel><!-- Zoeksleutel hier --></ns1:zoeksleutel>
        <ns1:pgnfrag>9468</ns1:pgnfrag>
      </ns1:zoeksleutelPgnfrag>
      <ns1:overdrachtsoort>overstapdossier</ns1:overdrachtsoort>
      <ns1:sessieId>9cebd89c-8953-416b-a2cb-ecee939f1775</ns1:sessieId>
    </ns1:sessiecontroleRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>


  • Request (voorbeel van PaO controle):
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://xml.kennisnet.nl/schemas/Overstapservice/20200910">
  <SOAP-ENV:Body>
    <ns1:sessiecontroleRequest>
      <ns1:bronBrin>00YY</ns1:bronBrin>
      <ns1:bronRouteringsKenmerk>0000000700000YY00931</ns1:bronRouteringsKenmerk>
      <ns1:doelBrin>00YY</ns1:doelBrin>
      <ns1:doelRouteringsKenmerk>0000000700000YY00932</ns1:doelRouteringsKenmerk>
      <ns1:koppelsleutel>19677A96-B737-402E-B3B8-24A3EEF32000</ns1:koppelsleutel>
      <ns1:overdrachtsoort>swv-dossier</ns1:overdrachtsoort>
      <ns1:sessieId>60d2909f-169f-4cb0-8256-5d1d5af1491d</ns1:sessieId>
    </ns1:sessiecontroleRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>


Element Uitleg Opmerkingen
bronBRIN Dit is het brinnummer van de bronschool die het het dossier moet uitleveren. De bronschool kan meerdere routeringskenmerken hebben.
bronRouteringsKenmerk Dit is het routeringskenmerk van het bronsysteem dat bevraagd wordt (optioneel). Deze parameter kan meegegeven worden als het doelsysteem één specifiek routeringskenmerken 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 OSR.
doelRouteringsKenmerk Dit is het routeringskenmerk 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
<?xml version="1.0"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Header/>
  <SOAP-ENV:Body>
    <sessiecontroleResponse xmlns="http://xml.kennisnet.nl/schemas/Overstapservice/20200910">
      <sectorAanvrager>VO</sectorAanvrager>
    </sessiecontroleResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Er is een nieuwe Sector toegevoegd: ONBEKEND. Wanneer een sector onbekend is word er "ONBEKEND" als sector worden teruggegeven 

<sectorAanvrager>ONBEKEND</sectorAanvrager>
Overgenomen van "https://developers.wiki.kennisnet.nl/index.php?title=OSO:2022/Controleren_Sessie&oldid=12180"