OSO:2017/Opvragen dossier: verschil tussen versies

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen
k
 
(24 tussenliggende versies door 2 gebruikers niet weergegeven)
Regel 10: Regel 10:
 
|}
  
|}
   
  +
==Basisvariant: Overdracht van Dossier==
−
==Preconditie==
  
  +
In deze variant wordt het Dossier aangeduid met de zoeksleutel. Deze variant wordt [[OSO:2017/Opvragen_dossier/overdracht|hier]] verder uitgewerkt.
−
* DoelSysteem is toegelaten op OSO keten
  
−
* DoelSysteem heeft geldig ''OSO certificaat''
  
−
* DoelSysteem heeft geldige Sessie voor opvragen Dossier
  
−
* BronSysteem is toegelaten op OSO keten
  
−
* BronSysteem heeft geldig ''OSO certificaat'' toegekend door TC
  
   
  +
==Basisvariant: Aanvraag bij Samenwerkingsverbanden==
  +
In deze variant wordt het gevraagde Dossier niet aangeduid met de ZoekSleutel maar met de Koppelsleutel (die eerder door het TC is afgegeven).
  +
Deze variant wordt [[OSO:2017/Opvragen_dossier/aanvraag|hier]] verder uitgewerkt.
   
  +
==Basisscenario==
−
=== Notificatie tbv Aanvraag naar Samenwerkingsverband ===
  
−
*Doelsysteem heeft Koppelsleutel ontvangen van Bronsysteem
  
−
''=== Notificatie tbv Terugkoppeling naar Samenwerkingsverband ===
  
−
*Doelsysteem heeft Koppelsleutel verstuurd naar Bronsysteem
  
−
*Bronsysteem heeft in eerdere transactie Dossier opgevraagd bij Doelsysteem mbv Koppelsleutel''
  
−  
−
==Postconditie==
  
−
Dossier is verzonden van Doelsysteem naar Bronsysteem
  
−  
−
==Basis Scenario==
  
 
#Doelsysteem vraag dossier op <sup>#</sup>
  
#Doelsysteem vraag dossier op <sup>#</sup>
−
#Bronsysteem laat [[OSO:2017/Sessie_controleren|Sessie Controleren]] bij TC<sup>*</sup>
 +
#Bronsysteem laat [[OSO:2017/Controleren_Sessie|Sessie Controleren]] bij TC<sup>*</sup>
−
#'''IF''' Sessie valide <sup>!</sup>
 +
#'''IF''' Sessie valide
  +
## '''IF''' (overdrachtsoort='overstapdossier') '''OR''' (overdrachtsoort == 'binnenBRIN'))<sup>**</sup>
−
## ''Bronsysteem slaat aanvraag gegevens (PGN ''OF'' koppelsleutel, sessie id, documentRequest, doel brin, doel AP index, aanvraagMoment) op ten behoeve van [[OSO:2017/Versturen_notificatie|Notificatie]]''
  
  +
### ''Bronsysteem slaat aanvraag gegevens (PGN , sessie id, documentRequest, doel brin, doel AP index, aanvraagMoment) op ten behoeve van [[OSO:2017/Versturen_Notificatie|Notificatie]]''<sup>**</sup>
−
## '''IF''' dossier gereed is voor overdracht<sup>**</sup> '''And''' Dossier aan Doelsysteem overgedragen mag worden<sup>***</sup> '''And''' ''verzameldatum van Dossier voldoet''<sup>****</sup> '''And''' DossierVersie is correct
  
  +
### '''IF''' dossier gereed is voor overdracht<sup>***</sup> '''AND''' Dossier aan Doelsysteem overgedragen mag worden<sup>***</sup> '''AND''' ''verzameldatum van Dossier voldoet''<sup>*****</sup> '''And''' DossierVersie is correct
  +
#### Bronsysteem verstuurt dossier
  +
###'''ELSE'''
  +
### Bronsysteem verstuurt foutmelding<sup>******</sup>
  +
### '''ENDIF'''
  +
## '''ELSEIF''' (overdrachtsoort='SWVaanvraag')
  +
## '''IF''' dossier gereed is voor overdracht<sup>***</sup> AND ''' DossierVersie is correct
 
### Bronsysteem verstuurt dossier
  
### Bronsysteem verstuurt dossier
−
##'''Else'''
 +
## '''ELSE'''
−
### Bronsysteem verstuurt foutmelding<sup>*****</sup>
 +
### Bronsysteem verstuurt foutmelding
−
#'''Else'''
 +
## '''ENDIF'''
  +
# '''ELSE'''
−
## Bronsysteem verstuurt foutmelding<sup>*****</sup>
  
  +
## Bronsysteem verstuurt foutmelding
  +
# '''ENDIF'''
   
−
<sup>#</sup> In OSO'16 kan een Doelsysteem aangeven dat het alleen geínteresseerd is in een 'geactualiseerd' Dossier. Zie ook punt <sup>****</sup><br />
 +
<sup>#</sup> In OSO kan een Doelsysteem aangeven dat het alleen geínteresseerd is in een 'geactualiseerd' Dossier. Zie ook punt <sup>****</sup><br />
  +
<sup>*</sup>'''Dit is een verplichte stap'''. Deze controle ''moet voor'' de andere controles worden uitgevoerd door het Bronsysteem. Als de Sessie gegevens incorrect blijken, moet dit worden teruggegeven aan het Doelsysteem. Pas daarna volgen de andere stappen en controles.<br />
−
<sup>*</sup>Dit is een verplichte stap<br />
 
  +
<sup>**</sup> De 'normale' OSO verstap wordt in deze tak afgehandeld. De tweede tak is bedoelt voor de afhandeling van 'Passend Onderwijs' aanvragen.<br />
−
Deze controle ''moet voor'' de andere controles worden uitgevoerd door het Bronsysteem. Als de Sessie gegevens incorrect blijken, moet dit worden teruggegeven aan het Doelsysteem. Pas daarna volgen de andere stappen en controles.<br />
  
−
<sup>!</sup>Alleen bij het resultaat 'Sessie is valide' mag een Dossier uitgeleverd worden(!)<br />
+
<sup>***</sup>Het <LINK NAAR GEREEED ZETTEN>Dossier is klaargezet en (indien van toepassing) inzage heeft plaats gevonden<br />
  +
<sup>****</sup>Bij het Dossier is door de Eindgebruiker (Bronsysteem) <LINK NAAR GEREEDZETTEN>aangegeven dat het opgevraagd mag worden door de School (BRIN).<br />
−
<sup>**</sup>Het [[OSO:2016/Klaarzetten_dossier|Dossier is klaargezet]] en (indien van toepassing) inzage heeft plaats gevonden<br />
  
  +
−
<sup>***</sup>Bij het Dossier is door de Eindgebruiker (Bronsysteem) [[OSO:2016/Gereed_zetten_Dossier|aangegeven dat het opgevraagd mag worden door de School (BRIN)]].<br />
  
  +
==Variant: Opvragen met AanvraagDatum==
 
<sup>****</sup>Als de optionele parameter in het documentRequest ‘aanvraagdatum’ door het Doelsysteem is ingevuld, vergelijkt het bronsysteem deze waarde met de verzameldatum van het Dossier:<br />
  
<sup>****</sup>Als de optionele parameter in het documentRequest ‘aanvraagdatum’ door het Doelsysteem is ingevuld, vergelijkt het bronsysteem deze waarde met de verzameldatum van het Dossier:<br />
 
*Als de ‘aanvraagDatum’ kleiner is dan de verzameldatum van het dossier ('na de vorige aanvraag is het dossier aangepast en ingezien'), volgt de ‘normale’ afhandeling van het request.
 
*Als de ‘aanvraagDatum’ kleiner is dan de verzameldatum van het dossier ('na de vorige aanvraag is het dossier aangepast en ingezien'), volgt de ‘normale’ afhandeling van het request.
 
*Als de ‘aanvraagDatum’ groter of gelijk is dan de verzameldatum van het dossier ('na de vorige aanvraag is het dossier niet aangepast') geeft het bronsysteem de (nieuwe) melding ‘LeerlingInfoNietGewijzigd’ (als het dossier wel klaar staat voor het bronsysteem).
  
*Als de ‘aanvraagDatum’ groter of gelijk is dan de verzameldatum van het dossier ('na de vorige aanvraag is het dossier niet aangepast') geeft het bronsysteem de (nieuwe) melding ‘LeerlingInfoNietGewijzigd’ (als het dossier wel klaar staat voor het bronsysteem).
−
*Als de parameter niet is ingevuld, volgt de ‘normale’ afhandeling van het request.
 +
*NB: Deze parameter wordt '''niet''' toegepast bij uitwisselingen met de KoppelSleutel (zie hierboven).
  +
  +
==Uitzonderingen en meldingen vanuit de Sessie controle==
   
−
<sup>*****</sup> In deze tabel zie je in de rechterkolom het overzicht van foutmeldingen die het bronssysteem, in de documentResponse, kan versturen aan het doelsysteem.
  
 
{|class="wikitable"
  
{|class="wikitable"
 
! style="text-align:left;"| Mogelijk resultaat van de sessieControle bij het TrafficCenter
  
! style="text-align:left;"| Mogelijk resultaat van de sessieControle bij het TrafficCenter
Regel 97: Regel 98:
 
| SessieOngeldig
  
| SessieOngeldig
 
|-
  
|-
−
| ''Sessie is valide''
 +
| ''Sessie is valide (zie hieronder)''
 
| ''dossier'' of<BR/>
  
| ''dossier'' of<BR/>
 
LeerlingNietBekend of<BR/>
  
LeerlingNietBekend of<BR/>
Regel 112: Regel 113:
 
[[Categorie:Overstapservice Onderwijs]]
  
[[Categorie:Overstapservice Onderwijs]]
   
  +
==Uitzonderingen en meldingen==
−
==Scenario's==
  
  +
  +
Hieronder volgt een overzicht van afwijkingen van de 'normale flow' zoals die door het bronsysteem gedetecteerd moeten worden een doorgegeven aan het doelsysteem. Voor de 'SWV-aanvragen' geldt dat de uitzonderingen 2, 4 en 5 '''niet''' van toepassing zijn. <br/>
  +
* Uitzondering #2 'LeerlingInfoNietGewijzigd': De parameter 'datum gewijzigd' wordt genegeerd bij de SWV-aanvragen.
  +
* Uitzonderingen #4 'LeerlinginfoNietOpvraagbaar' en #5 'LeerlinginfoNietIngezien' zijn niet van toepassing bij SWV-aanvragen omdat inzage niet nodig is.
  +
'
  +
 
{|class="wikitable"
  
{|class="wikitable"
 
! style="text-align:left;"| Rangorde<sup>*</sup>
  
! style="text-align:left;"| Rangorde<sup>*</sup>
 
! style="text-align:left;"| Resultaat
  
! style="text-align:left;"| Resultaat
−
! style="text-align:left;"| Type flow (N, A, E<sup>**</sup>)
  
 
! style="text-align:left;"| Omschrijving
  
! style="text-align:left;"| Omschrijving
 
! style="text-align:left;"| Stopcriterium bij aflopen aanleverpunten
  
! style="text-align:left;"| Stopcriterium bij aflopen aanleverpunten
  +
! style="text-align:left;"| ''Melding aan Eindgebruiker''
 
|-
  
|-
 
| 0
  
| 0
 
| <Document>
  
| <Document>
  +
| Het gevraagde document. ''(Let op: In het afmeldingRequest moet dan status='VerstrekkingGeslaagd' worden gebruikt)''
−
| N
  
−
| Het gevraagde document. (Let op: In het afmeldingRequest moet dan status='VerstrekkingGeslaagd' worden gebruikt)
  
 
| ja
  
| ja
  +
| nvt
 
|-
  
|-
 
| 1
  
| 1
−
| LeveringInBehandeling<sup>***</sup>
 +
| LeveringInBehandeling<sup>**</sup>
−
| A
  
 
| Het leverende systeem (bron) kan niet bepalen of het dossier al beschikbaar is of dat de leerling bij de bron bekend is. Het aanvragende systeem (doel) gaat verder met het opvragen van het dossier bij de andere aanleverpunten.
  
| Het leverende systeem (bron) kan niet bepalen of het dossier al beschikbaar is of dat de leerling bij de bron bekend is. Het aanvragende systeem (doel) gaat verder met het opvragen van het dossier bij de andere aanleverpunten.
 
| nee
  
| nee
  +
| nvt
 
|-
  
|-
 
| 2
  
| 2
−
| LeerlingInfoNietGewijzigd<sup>****</sup>
 +
| LeerlingInfoNietGewijzigd
−
| A
  
 
| De inhoud van het Dossier is sinds de opgegeven 'aanvraagdatum’ in het documentRequest niet gewijzigd.
  
| De inhoud van het Dossier is sinds de opgegeven 'aanvraagdatum’ in het documentRequest niet gewijzigd.
 
| ja
  
| ja
  +
|
 
|-
  
|-
 
| 3
  
| 3
−
| DossierVersieNietCorrect<sup>*****</sup>
 +
| DossierVersieNietCorrect
−
| A
  
 
| De versie van het dossier dat klaar staat wijkt af van de huidige versie (en kan daardoor niet correct geïmporteerd worden door het doelsysteem).
  
| De versie van het dossier dat klaar staat wijkt af van de huidige versie (en kan daardoor niet correct geïmporteerd worden door het doelsysteem).
 
| ja
  
| ja
  +
| De versies van het dossier tussen bron en doelsysteem wijken van elkaar af en kunnen niet verwerkt worden.
 
|-
  
|-
 
| 4
  
| 4
 
| LeerlinginfoNietOpvraagbaar
  
| LeerlinginfoNietOpvraagbaar
−
| A
  
 
| Het Dossier mag niet worden verstrekt, omdat de ouders/leerling geen toestemming hebben verleend.
  
| Het Dossier mag niet worden verstrekt, omdat de ouders/leerling geen toestemming hebben verleend.
 
| ja
  
| ja
  +
| Het dossier mag niet worden verstrekt, omdat de ouders/leerling geen toestemming hebben verleend.
 
|-
  
|-
 
| 5
  
| 5
 
| LeerlinginfoNietIngezien
  
| LeerlinginfoNietIngezien
−
| A
  
 
| Het document mag (nog) niet worden verstrekt, omdat de ouders nog geen inzage hebben gehad.
  
| Het document mag (nog) niet worden verstrekt, omdat de ouders nog geen inzage hebben gehad.
 
| ja
  
| ja
  +
| Het document mag (nog) niet worden verstrekt, omdat de ouders nog geen inzage hebben gehad in het dossier.
 
|-
  
|-
 
| 6
  
| 6
 
| LeerlinginfoNietBeschikbaar
  
| LeerlinginfoNietBeschikbaar
−
| A
  
 
| Het Dossier is (nog) niet klaargezet voor overdracht.
  
| Het Dossier is (nog) niet klaargezet voor overdracht.
 
| ja
  
| ja
  +
| Het dossier is (nog) niet klaargezet voor overdracht. Neem contact op met de betreffende school.
 
|-
  
|-
 
| 7
  
| 7
 
| LeveringGeweigerd
  
| LeveringGeweigerd
−
| A
  
 
| Het verstrekkende bronsysteem had het dossier klaargezet voor een specifiek BRIN-nummer. Het verstrekkende bronsysteem heeft het dossier niet uitgeleverd aan het opvragende doelsysteem, omdat het BRIN van het opvragende doelsysteem niet overeenkomt met het BRIN waarvoor het dossier was klaargezet.
  
| Het verstrekkende bronsysteem had het dossier klaargezet voor een specifiek BRIN-nummer. Het verstrekkende bronsysteem heeft het dossier niet uitgeleverd aan het opvragende doelsysteem, omdat het BRIN van het opvragende doelsysteem niet overeenkomt met het BRIN waarvoor het dossier was klaargezet.
 
| nee
  
| nee
  +
| Het dossier is niet klaargezet voor het BRIN-nummer van jouw school. Neem contact op met de betreffende school.
 
|-
  
|-
 
| 8
  
| 8
 
| LeerlingNietBekend
  
| LeerlingNietBekend
  +
| De leerling met het opgegeven BSN of Koppelsleutel is niet bekend bij het leverende bronsysteem.
−
| A
  
−
| De leerling met het opgegeven BSN is niet bekend bij het leverende bronsysteem.
  
 
| nee
  
| nee
  +
| Het BSN-nummer van de leerling is niet bekend bij de betreffende school. Controleer het BSN, of neem contact op met de betreffende school.
 
|-
  
|-
 
| 9
  
| 9
 
| AuthenticatieVerstrekkerMislukt
  
| AuthenticatieVerstrekkerMislukt
−
| E
  
 
| Het leverende bronsysteem kon zich niet authenticeren bij het Traffic Center. Het opvragende doelsysteem hoeft hierop geen actie te ondernemen.
  
| Het leverende bronsysteem kon zich niet authenticeren bij het Traffic Center. Het opvragende doelsysteem hoeft hierop geen actie te ondernemen.
 
| nee
  
| nee
  +
| De school waar het dossier wordt opgehaald, wordt niet herkend. Neem contact op met de betreffende school.
 
|-
  
|-
 
| 10
  
| 10
 
| SessieAfwijkend
  
| SessieAfwijkend
−
| E
  
 
| De overstapvraag wijkt af van die, waarmee de sessie verkregen is. Dit is het resultaat van de sessieControle.
  
| De overstapvraag wijkt af van die, waarmee de sessie verkregen is. Dit is het resultaat van de sessieControle.
 
| nee
  
| nee
  +
| Er heeft zich een interne fout voorgedaan tijdens de overdracht. Neem contact op met je software leverancier.
 
|-
  
|-
 
| 11
  
| 11
 
| SessieReedsAfgemeld
  
| SessieReedsAfgemeld
−
| E
  
 
| De sessie is al afgemeld en dus niet langer geldig. Dit is het resultaat van de sessieControle.
  
| De sessie is al afgemeld en dus niet langer geldig. Dit is het resultaat van de sessieControle.
 
| nee
  
| nee
  +
| Er heeft zich een interne fout voorgedaan tijdens de overdracht. Neem contact op met je software leverancier.
 
|-
  
|-
 
| 12
  
| 12
 
| SessieVerlopen
  
| SessieVerlopen
−
| E
  
 
| De sessie is verlopen; de time-out is verstreken. Dit is het resultaat van de sessieControle.
  
| De sessie is verlopen; de time-out is verstreken. Dit is het resultaat van de sessieControle.
 
| nee
  
| nee
  +
| Er heeft zich een interne fout voorgedaan tijdens de overdracht. Neem contact op met je software leverancier.
 
|-
  
|-
 
| 13
  
| 13
 
| SessieOngeldig
  
| SessieOngeldig
−
| E
  
 
| De sessie is ongeldig; bij het controleren van de Sessie gegevens door het Traffic Center is een fout geconstateerd. (Bijvoorbeeld: Het SessieID is nooit uitgedeeld, het SessieID was leeg, de aanvrager heeft geen geldige status). Deze foutcode moet doorgegeven worden wanneer andere foutmeldingen niet van toepassing zijn.
  
| De sessie is ongeldig; bij het controleren van de Sessie gegevens door het Traffic Center is een fout geconstateerd. (Bijvoorbeeld: Het SessieID is nooit uitgedeeld, het SessieID was leeg, de aanvrager heeft geen geldige status). Deze foutcode moet doorgegeven worden wanneer andere foutmeldingen niet van toepassing zijn.
 
| nee
  
| nee
  +
| Er heeft zich een interne fout voorgedaan tijdens de overdracht. Neem contact op met je software leverancier.
 
|-
  
|-
  +
 
| 14
  
| 14
  +
| NietOndersteund
  +
| Het bevraagde bronsysteem geeft aan geen Dossiers te kunnen leveren (Functie niet ingebouwd)
  +
| nee
  +
| De school waar het dossier wordt opgehaald, heeft een systeem dat geen functie heeft voor het versturen van dossiers. Neem contact op met de betreffende school.
  +
|-
  +
  +
| 15
 
| Communicatiefout
  
| Communicatiefout
−
| E
  
 
| Het leverende bronsysteem geeft geen antwoord of er treedt een (technische) fout op. Er is geen contact geweest met het leverende bronsysteem.
  
| Het leverende bronsysteem geeft geen antwoord of er treedt een (technische) fout op. Er is geen contact geweest met het leverende bronsysteem.
 
| nee
  
| nee
  +
| Er treedt een (technische) fout op bij de school van herkomst.
 
|-
  
|-
−
|}
  
−
<sup>*</sup> De rangorde geeft de 'mate van succes' van de overdracht aan, hoe hoger hoe beter. Bronsystemen moeten de 'laagste toestand' teruggeven aan het Doelsysteem; het Doelsysteem moet het 'hoogste resultaat' binnen één Sessie terugrapporteren bij het afsluiten van de Sessie.<br />
  
−
<sup>**</sup> N: Normaal, A: Alternatief, E: Exceptie (fout)<br />
  
−
<sup>***</sup>Deze melding is optioneel, niet alle systemen kennen deze toestand.<br />
  
−
<sup>****</sup>POVO overstap.<br />
  
−
<sup>*****</sup>Nieuw in OSO'16.<br />
  
   
−
==Aanroep en antwoord==
  
   
−
*Request
  
   
−
<syntaxhighlight lang="xml">
  
−
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.eld.nl/schemas/Overstapservice/20160411">
  
−
<soapenv:Header/>
  
−
<soapenv:Body>
  
−
<ns:documentRequest>
  
−
<ns:bronBrin>00YY</ns:bronBrin>
  
−
<ns:bronAanleverpuntIndex>0</ns:bronAanleverpuntIndex>
  
−
<ns:doelBrin>12SS</ns:doelBrin>
  
−
<ns:doelAanleverpuntIndex>102</ns:doelAanleverpuntIndex>
  
−
<ns:zoeksleutel>yl/xKgjcxwvxryvCveYeefn3NzZY8xCyC3UIpR62S7nVMV51q8X ... JpgyucEUAmzrXr+aEfkINN9xAZehsINL6mvvNPFskIbZzSgFUTDpI=</ns:zoeksleutel>
  
−
<ns:overdrachtsoort>overstapdossier</ns:overdrachtsoort>
  
−
<ns:sessieId>fe6b2710-3fe5-468e-822d-e2b409a9f0d0</ns:sessieId>
  
−
<!--Optional:-->
  
−
<ns:pgn>
  
−
<!--You have a CHOICE of the next 2 items at this level-->
  
−
<ns:bsn>123123121</ns:bsn>
  
−
</ns:pgn>
  
−
<!--Optional:-->
  
−
<ns:aanvraagdatum>2016-03-06T14:19:39.977+02:00</ns:aanvraagdatum>
  
−
</ns:documentRequest>
  
−
</soapenv:Body>
  
−
</soapenv:Envelope>
  
−
</syntaxhighlight>
  
−  
−  
−  
−
{|class="wikitable"
  
−
! style="text-align:left;"| Element
  
−
! style="text-align:left;"| Uitleg
  
−
! style="text-align:left;"| Opmerkingen
  
−  
−
|-
  
−
| bronBrin
  
−
| Dit is het BRIN van de bronschool.
 
−
|
 
−  
−
|-
  
−
| bronAPindex
  
−
| Dit is de index van het aanleverpunt van het bronsysteem dat dit verzoek ontvangt.
  
−
|
 
−  
−
|-
  
−
| doelBrin
  
−
| Dit is het BRIN van de doelschool
  
−
|
 
−  
−
|-
  
−
| doelAPindex
  
−
| Dit is de index van het Aanleverpunt van het Bronsysteem dat dit verzoek indient.
  
−
|
 
−  
−
|-
  
−
| zoeksleutel
  
−
| Dit is de versleutelde PGN
  
−
| Dit moet exact overeenkomen met de zoeksleutel zoals meegegeven bij het aanvragen van een sessie (wordt door Doelsysteem gegenereerd bij aanvragen Sessie)
  
−  
−
|-
  
−
| overdrachtsoort
  
−
| Dit bepaalt om wat voor soort overdracht het gaat, een overstapdossier of overdrachtbinnenbrin.
  
−
| De overdrachtsoort wordt overeenkomen met de overdrachtsoort welke gebruikt is in het overdrachtsRequest. Het BRIN-nummer van het bron- en doelBRIN moet hetzelfde zijn voor een binnenbrin overdracht.
  
−  
−
|-
  
−
| sessieId
  
−
| De sessie-ID die verkregen is bij het Initiëren van de Sessie.
  
−
|
  
−  
−
|-
  
−
| PGN
  
−
| Het BSN of Onderwijsnummer van de leerling (verplicht)
  
−
| Dit wordt onversleuteld verstuurd in het documentRequest
 
−  
−
|-
  
−
| aanvraagdatum
  
−
| Als de optionele parameter ‘aanvraagdatum’ door het doelsysteem is ingevuld, dan vergelijkt het bronsysteem de aanvraagdatum met de verzameldatum van het dossier. De uitkomst van die vergelijking bepaalt het antwoord van het bronsysteem.
  
−
| De aanvraagdatum is optioneel
  
 
|}
  
|}
  +
<sup>*</sup> De rangorde geeft de 'mate van succes' van de overdracht aan, hoe hoger hoe beter. Bronsystemen moeten de 'laagste toestand' teruggeven aan het Doelsysteem; het Doelsysteem moet het 'hoogste resultaat' binnen één Sessie terugrapporteren bij het afsluiten van de Sessie.<br />
−  
  +
<sup>**</sup>Deze melding is optioneel, niet alle systemen kennen deze toestand.<br />
−  
−
*Response
  
−  
−
<syntaxhighlight lang="xml">
  
−
<?xml version="1.0" encoding="UTF-8"?>
  
−
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://xml.eld.nl/schemas/Overstapservice/20160411">
  
−
<SOAP-ENV:Body>
  
−
<ns1:documentResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.w3.org/2001/XMLSchema">
  
−
<ns1:fout>LeerlinginfoNietBeschikbaar</ns1:fout>
  
−
</ns1:documentResponse>
  
−
</SOAP-ENV:Body>
  
−
</SOAP-ENV:Envelope>
  
−
</syntaxhighlight>
  
   
   
   
 
[[Categorie:Overstapservice Onderwijs]]
  
[[Categorie:Overstapservice Onderwijs]]
−
[[Category:Book OSO|73]]
  

Huidige versie van 12 feb 2018 om 12:57

Actor(s) Goal(s)
Doelsysteem Doelsysteem heeft dossier van specifieke leerling ontvangen
Bronsysteem Verzoek tot overhandigen specifiek dossier afgehandeld

Basisvariant: Overdracht van Dossier

In deze variant wordt het Dossier aangeduid met de zoeksleutel. Deze variant wordt hier verder uitgewerkt.

Basisvariant: Aanvraag bij Samenwerkingsverbanden

In deze variant wordt het gevraagde Dossier niet aangeduid met de ZoekSleutel maar met de Koppelsleutel (die eerder door het TC is afgegeven). Deze variant wordt hier verder uitgewerkt.

Basisscenario

  1. Doelsysteem vraag dossier op #
  2. Bronsysteem laat Sessie Controleren bij TC*
  3. IF Sessie valide
    1. IF (overdrachtsoort='overstapdossier') OR (overdrachtsoort == 'binnenBRIN'))**
      1. Bronsysteem slaat aanvraag gegevens (PGN , sessie id, documentRequest, doel brin, doel AP index, aanvraagMoment) op ten behoeve van Notificatie**
      2. IF dossier gereed is voor overdracht*** AND Dossier aan Doelsysteem overgedragen mag worden*** AND verzameldatum van Dossier voldoet***** And DossierVersie is correct
        1. Bronsysteem verstuurt dossier
      3. ELSE
      4. Bronsysteem verstuurt foutmelding******
      5. ENDIF
    2. ELSEIF (overdrachtsoort='SWVaanvraag')
    3. IF dossier gereed is voor overdracht*** AND DossierVersie is correct
      1. Bronsysteem verstuurt dossier
    4. ELSE
      1. Bronsysteem verstuurt foutmelding
    5. ENDIF
  4. ELSE
    1. Bronsysteem verstuurt foutmelding
  5. ENDIF

# In OSO kan een Doelsysteem aangeven dat het alleen geínteresseerd is in een 'geactualiseerd' Dossier. Zie ook punt ****
*Dit is een verplichte stap. Deze controle moet voor de andere controles worden uitgevoerd door het Bronsysteem. Als de Sessie gegevens incorrect blijken, moet dit worden teruggegeven aan het Doelsysteem. Pas daarna volgen de andere stappen en controles.
** De 'normale' OSO verstap wordt in deze tak afgehandeld. De tweede tak is bedoelt voor de afhandeling van 'Passend Onderwijs' aanvragen.
***Het <LINK NAAR GEREEED ZETTEN>Dossier is klaargezet en (indien van toepassing) inzage heeft plaats gevonden
****Bij het Dossier is door de Eindgebruiker (Bronsysteem) <LINK NAAR GEREEDZETTEN>aangegeven dat het opgevraagd mag worden door de School (BRIN).

Variant: Opvragen met AanvraagDatum

****Als de optionele parameter in het documentRequest ‘aanvraagdatum’ door het Doelsysteem is ingevuld, vergelijkt het bronsysteem deze waarde met de verzameldatum van het Dossier:

  • Als de ‘aanvraagDatum’ kleiner is dan de verzameldatum van het dossier ('na de vorige aanvraag is het dossier aangepast en ingezien'), volgt de ‘normale’ afhandeling van het request.
  • Als de ‘aanvraagDatum’ groter of gelijk is dan de verzameldatum van het dossier ('na de vorige aanvraag is het dossier niet aangepast') geeft het bronsysteem de (nieuwe) melding ‘LeerlingInfoNietGewijzigd’ (als het dossier wel klaar staat voor het bronsysteem).
  • NB: Deze parameter wordt niet toegepast bij uitwisselingen met de KoppelSleutel (zie hierboven).

Uitzonderingen en meldingen vanuit de Sessie controle

Mogelijk resultaat van de sessieControle bij het TrafficCenter Verstrekkingsfout (of dossier) die de bron in de documentResponse aan het doel teruggeeft
<technische fout> SessieOngeldig
SessieReedsAfgemeld SessieReedsAfgemeld
SessieAfwijkend SessieAfwijkend
SessieVerlopen SessieVerlopen
SessieOngeldig SessieOngeldig
VerstrekkerNietBekend AuthenticatieVerstrekkerMislukt
VerstrekkerNietBeschikbaar AuthenticatieVerstrekkerMislukt
VerstrekkerAanleverpuntNietBekend AuthenticatieVerstrekkerMislukt
OngeautoriseerdAanleverpunt SessieOngeldig
OnbekendAanleverpunt SessieOngeldig
AanvragerNietBekend SessieOngeldig
AanvragerAanleverpuntNietBekend SessieOngeldig
AanvragerNietBeschikbaar SessieOngeldig
GeenRelatieMetDoel SessieOngeldig
Sessie is valide (zie hieronder) dossier of

LeerlingNietBekend of
LeerlinginfoNietOpvraagbaar of
LeerlinginfoNietBeschikbaar of
LeveringGeweigerd of
LeveringInBehandeling of
LeerlinginfoNietIngezien of
LeerlingInfoNietGewijzigd of
DossierVersieNietCorrect

Uitzonderingen en meldingen

Hieronder volgt een overzicht van afwijkingen van de 'normale flow' zoals die door het bronsysteem gedetecteerd moeten worden een doorgegeven aan het doelsysteem. Voor de 'SWV-aanvragen' geldt dat de uitzonderingen 2, 4 en 5 niet van toepassing zijn.

  • Uitzondering #2 'LeerlingInfoNietGewijzigd': De parameter 'datum gewijzigd' wordt genegeerd bij de SWV-aanvragen.
  • Uitzonderingen #4 'LeerlinginfoNietOpvraagbaar' en #5 'LeerlinginfoNietIngezien' zijn niet van toepassing bij SWV-aanvragen omdat inzage niet nodig is.

'

Rangorde* Resultaat Omschrijving Stopcriterium bij aflopen aanleverpunten Melding aan Eindgebruiker
0 <Document> Het gevraagde document. (Let op: In het afmeldingRequest moet dan status='VerstrekkingGeslaagd' worden gebruikt) ja nvt
1 LeveringInBehandeling** Het leverende systeem (bron) kan niet bepalen of het dossier al beschikbaar is of dat de leerling bij de bron bekend is. Het aanvragende systeem (doel) gaat verder met het opvragen van het dossier bij de andere aanleverpunten. nee nvt
2 LeerlingInfoNietGewijzigd De inhoud van het Dossier is sinds de opgegeven 'aanvraagdatum’ in het documentRequest niet gewijzigd. ja
3 DossierVersieNietCorrect De versie van het dossier dat klaar staat wijkt af van de huidige versie (en kan daardoor niet correct geïmporteerd worden door het doelsysteem). ja De versies van het dossier tussen bron en doelsysteem wijken van elkaar af en kunnen niet verwerkt worden.
4 LeerlinginfoNietOpvraagbaar Het Dossier mag niet worden verstrekt, omdat de ouders/leerling geen toestemming hebben verleend. ja Het dossier mag niet worden verstrekt, omdat de ouders/leerling geen toestemming hebben verleend.
5 LeerlinginfoNietIngezien Het document mag (nog) niet worden verstrekt, omdat de ouders nog geen inzage hebben gehad. ja Het document mag (nog) niet worden verstrekt, omdat de ouders nog geen inzage hebben gehad in het dossier.
6 LeerlinginfoNietBeschikbaar Het Dossier is (nog) niet klaargezet voor overdracht. ja Het dossier is (nog) niet klaargezet voor overdracht. Neem contact op met de betreffende school.
7 LeveringGeweigerd Het verstrekkende bronsysteem had het dossier klaargezet voor een specifiek BRIN-nummer. Het verstrekkende bronsysteem heeft het dossier niet uitgeleverd aan het opvragende doelsysteem, omdat het BRIN van het opvragende doelsysteem niet overeenkomt met het BRIN waarvoor het dossier was klaargezet. nee Het dossier is niet klaargezet voor het BRIN-nummer van jouw school. Neem contact op met de betreffende school.
8 LeerlingNietBekend De leerling met het opgegeven BSN of Koppelsleutel is niet bekend bij het leverende bronsysteem. nee Het BSN-nummer van de leerling is niet bekend bij de betreffende school. Controleer het BSN, of neem contact op met de betreffende school.
9 AuthenticatieVerstrekkerMislukt Het leverende bronsysteem kon zich niet authenticeren bij het Traffic Center. Het opvragende doelsysteem hoeft hierop geen actie te ondernemen. nee De school waar het dossier wordt opgehaald, wordt niet herkend. Neem contact op met de betreffende school.
10 SessieAfwijkend De overstapvraag wijkt af van die, waarmee de sessie verkregen is. Dit is het resultaat van de sessieControle. nee Er heeft zich een interne fout voorgedaan tijdens de overdracht. Neem contact op met je software leverancier.
11 SessieReedsAfgemeld De sessie is al afgemeld en dus niet langer geldig. Dit is het resultaat van de sessieControle. nee Er heeft zich een interne fout voorgedaan tijdens de overdracht. Neem contact op met je software leverancier.
12 SessieVerlopen De sessie is verlopen; de time-out is verstreken. Dit is het resultaat van de sessieControle. nee Er heeft zich een interne fout voorgedaan tijdens de overdracht. Neem contact op met je software leverancier.
13 SessieOngeldig De sessie is ongeldig; bij het controleren van de Sessie gegevens door het Traffic Center is een fout geconstateerd. (Bijvoorbeeld: Het SessieID is nooit uitgedeeld, het SessieID was leeg, de aanvrager heeft geen geldige status). Deze foutcode moet doorgegeven worden wanneer andere foutmeldingen niet van toepassing zijn. nee Er heeft zich een interne fout voorgedaan tijdens de overdracht. Neem contact op met je software leverancier.
14 NietOndersteund Het bevraagde bronsysteem geeft aan geen Dossiers te kunnen leveren (Functie niet ingebouwd) nee De school waar het dossier wordt opgehaald, heeft een systeem dat geen functie heeft voor het versturen van dossiers. Neem contact op met de betreffende school.
15 Communicatiefout Het leverende bronsysteem geeft geen antwoord of er treedt een (technische) fout op. Er is geen contact geweest met het leverende bronsysteem. nee Er treedt een (technische) fout op bij de school van herkomst.

* De rangorde geeft de 'mate van succes' van de overdracht aan, hoe hoger hoe beter. Bronsystemen moeten de 'laagste toestand' teruggeven aan het Doelsysteem; het Doelsysteem moet het 'hoogste resultaat' binnen één Sessie terugrapporteren bij het afsluiten van de Sessie.
**Deze melding is optioneel, niet alle systemen kennen deze toestand.

Overgenomen van "https://developers.wiki.kennisnet.nl/index.php?title=OSO:2017/Opvragen_dossier&oldid=8127"