OSO:2017/Versturen Terugkoppeling: verschil tussen versies

Uit Kennisnet Developers Documentatie
Ga naar: navigatie, zoeken
Regel 4: Regel 4:
 
|-
 
|-
 
| Bronsysteem
 
| Bronsysteem
| Versturen Terugkoppeling naar Doelsysteem.
+
| Ontvangen Terugkoppeling van Doelsysteem.
 
|-
 
|-
 
| Doelsysteem
 
| Doelsysteem
| Ontvangen Terugkoppeling van Bronsysteem.
+
| Versturen Terugkoppeling naar Bronsysteem.
  +
 
|}
 
|}
   
 
'''NB:''' Bij deze beschrijving worden bron- en doel- systeem gebruikt als:
 
'''NB:''' Bij deze beschrijving worden bron- en doel- systeem gebruikt als:
* bronsysteem: Het SWV/RP dat de Terugkoppeling verstuurt (en voorafgaand een Notificatie met KoppelSleutel van het Bronsysteem heeft ontvangen.)
+
* Bronsysteem: Het LAS dat (voorafgaand aan deze uitwisseling) een Dossier heeft verstuurd.
* doelsyteem: Het LAS dat de Terugkoppeling ontvangt (en voorafgaand een Notificatie met KoppelSleutel naar het Doelsysteem heeft verstuurd.)
+
* Doelsysteem: Het SWV/RP systeem dat (voorafgaand aan deze uitwisseling) een Dossier heeft ontvangen
Dit betekent dat de richting van het bericht wordt gevolgd (en deze richting wijkt af van die van de uitwisseling van een Dossier(!))<br>
+
Dit betekent dat de richting van de Dossier uitwisseling wordt aangehouden en wordt afgeweken(!) van de richting van dit beric
   
 
==Preconditie==
 
==Preconditie==
*BronSysteem is aangesloten op OSO keten
+
*Bronsysteem is aangesloten op OSO keten
  +
*Bronsysteem heeft Dossier opgevraagd bij Doelsysteem met behulp van KoppelSleutel
*BronSysteem heeft Terugkoppeling melding verstuurd naar Traffic Center
 
*DoelSysteem is aangesloten op OSO keten
+
*Doelsysteem is aangesloten op OSO keten
  +
*Doelsysteem heeft TerugkoppelingMelding verstuurd naar Traffic Center
*DoelSysteem heeft Dossier opgevraagd bij Bronsysteem met behulp van KoppelSleutel
 
   
 
==Postconditie==
 
==Postconditie==
*Doelsysteem heeft Terugkoppeling ontvangen van Bronsysteem
+
*Bronsysteem heeft Terugkoppeling ontvangen van Doelsysteem
   
   
 
==Basis scenario==
 
==Basis scenario==
# Bronsysteem verstuurt Terugkoppeling naar Doelsysteem
+
# Doelsysteem verstuurt Terugkoppeling naar Bronsysteem
# Doelsysteem stuurt bevestiging ontvangst Notificatie aan BronSysteem<sup>*</sup>
+
# Bronsysteem stuurt bevestiging ontvangst Terugkoppeling aan Doelsysteem<sup>*</sup>
# Doelsysteem toont Terugkoppeling gegevens aan Eindgebruiker (Doelsysteem)<sup>**</sup>
+
# Bronsysteem toont Terugkoppeling gegevens aan Eindgebruiker (Bronsysteem)<sup>**</sup>
# '''IF''' Bronsysteem heeft bevestiging ontvangen
+
# '''IF''' Doelsysteem heeft bevestiging ontvangen
## BronSysteem toont bevestiging aan Eindgebruiker (Bronsysteem)
+
## Doelsysteem toont bevestiging aan Eindgebruiker (Doelsysteem)
 
# '''ELSE'''
 
# '''ELSE'''
## BronSysteem toont melding aan Eindgebruiker (Bronsysteem)<sup>***</sup>
+
## Doelsysteem toont melding aan Eindgebruiker (Doelsysteem)<sup>***</sup>
 
# '''ENDIF'''
 
# '''ENDIF'''
   
 
<sup>*</sup>Deze bevestiging is impliciet op basis van correct ontvangen van bericht<br />
 
<sup>*</sup>Deze bevestiging is impliciet op basis van correct ontvangen van bericht<br />
<sup>**</sup>Het doelsysteem toont de informatie uit de notificatie aan de eindgebruiker bij het desbetreffende Dossier. OSO vereist compleetheid van de informatie, maar stel geen verdere eisen aan de manier waarop een Doelsysteem dit inricht.<br />
+
<sup>**</sup>Het Bronsysteem toont de informatie uit de notificatie aan de eindgebruiker bij het desbetreffende Dossier. OSO vereist compleetheid van de informatie, maar stel geen verdere eisen aan de manier waarop een Bronsysteem dit inricht.<br />
<sup>***</sup> Het bronsysteem doet één poging per Terugkoppeling om deze te versturen na het doelsysteem; er volgen geen nieuwe (automatische) pogingen wanneer de aflevering faalt. Het bronsysteem toont haar eindgebruiker informatie over het wel of niet succesvol versturen van de Terugkoppeling. De eindgebruiker kan dan een nieuwe poging initiëren voor het versturen van een Terugkoppeling.<br />
+
<sup>***</sup> Het Doelsysteem doet één poging per Terugkoppeling om deze te versturen na het Bronsysteem; er volgen geen nieuwe (automatische) pogingen wanneer de aflevering faalt. Het Doelsysteem toont haar eindgebruiker informatie over het wel of niet succesvol versturen van de Terugkoppeling. De eindgebruiker kan dan een nieuwe poging initiëren voor het versturen van een Terugkoppeling.<br />
   
 
== Uitzonderingen en meldingen==
 
== Uitzonderingen en meldingen==
Regel 49: Regel 50:
 
|-
 
|-
 
| <Terugkoppeling>
 
| <Terugkoppeling>
| De Terugkoppeling is succesvol ontvangen door het Doelsysteem.
+
| De Terugkoppeling is succesvol ontvangen door het Bronsysteem.
| Bronsysteem toont informatie van Terugkoppeling bij overeenkomstig Dossier.
+
| Doelsysteem toont informatie van Terugkoppeling bij overeenkomstig Dossier.
 
|
 
|
 
|-
 
|-
   
 
| KoppelSleutelOnbekend
 
| KoppelSleutelOnbekend
| Het Bronsysteem kent deze KoppelSleutel niet
+
| Het Doelsysteem kent deze KoppelSleutel niet
| Bronsysteem kan Terugkoppeling niet herleiden naar Dossier omdat Bronsysteem koppelsleutel niet kent en meldt dit aan het Doelsysteem.
+
| Doelsysteem kan Terugkoppeling niet herleiden naar Dossier omdat Doelsysteem koppelsleutel niet kent en meldt dit aan het Bronsysteem.
| Doelsysteem toont fout aan eindgebruiker.
+
| Bronsysteem toont fout aan eindgebruiker.
 
|-
 
|-
   
 
| NotSupported
 
| NotSupported
| Het Bronsysteem ondersteunt dit type OSO uitwisseling niet.
+
| Het Doelsysteem ondersteunt dit type OSO uitwisseling niet.
| Het Bronsysteem geeft aan dat een Terugkoppeling is ontvangen, maar dat dit systeem deze functionaliteit niet ondersteund. Er vindt geen verdere verwerking plaats.
+
| Het Doelsysteem geeft aan dat een Terugkoppeling is ontvangen, maar dat dit systeem deze functionaliteit niet ondersteund. Er vindt geen verdere verwerking plaats.
 
| De school waar de melding naar toe wordt verstuurd, heeft een systeem dat geen functie heeft voor het ontvangen van terugkoppelingen van dossiers. Neem contact op met de betreffende school.
 
| De school waar de melding naar toe wordt verstuurd, heeft een systeem dat geen functie heeft voor het ontvangen van terugkoppelingen van dossiers. Neem contact op met de betreffende school.
 
|-
 
|-
Regel 68: Regel 69:
 
| <Geen response>
 
| <Geen response>
 
| Technische fout
 
| Technische fout
| Het meldende Doelsysteem staakt de verdere Terugkoppeling en geeft de eindgebruiker hierover een foutmelding.
+
| Het meldende Bronsysteem staakt de verdere Terugkoppeling en geeft de eindgebruiker hierover een foutmelding.
 
| Er kan geen verbinding gemaakt worden met het OSO systeem. Probeer het later nog eens.
 
| Er kan geen verbinding gemaakt worden met het OSO systeem. Probeer het later nog eens.
 
|-
 
|-
Regel 84: Regel 85:
 
|-
 
|-
 
| bronBRIN
 
| bronBRIN
| Dit is het BRINnummer van de Bronschool dat de Notificatie wil versturen.
+
| Dit is het BRINnummer van de Bronschool dat de Terugkoppeling ontvangt
 
| verplicht
 
| verplicht
   
 
|-
 
|-
 
| bronAanleverpuntIndex
 
| bronAanleverpuntIndex
| Dit is de index van het Aanleverpunt van het Bronsysteem dat de Notificatie wil versturen.
+
| Dit is de index van het Aanleverpunt van het Doelsysteem dat de Terugkoppeling ontvangt.
 
| verplicht
 
| verplicht
   
 
|-
 
|-
 
| doelBrin
 
| doelBrin
| Dit is het brinnummer van het Doelsysteem dat de Notificatie ontvangt.
+
| Dit is het brinnummer van het Bronsysteem dat de Terugkoppeling verstuurt.
 
| verplicht
 
| verplicht
   
 
|-
 
|-
 
| doelAanleverpuntIndex
 
| doelAanleverpuntIndex
| Dit is de index van het Aanleverpunt van het Doelsysteem dat de Notificatie ontvangt.
+
| Dit is de index van het Aanleverpunt van het Bronsysteem dat de Terugkoppeling verstuurt.
 
| verplicht
 
| verplicht
   
 
|-
 
|-
 
| KoppelSleutel
 
| KoppelSleutel
| De KoppelSleutel zoals eerder ontvangen van het DoelSysteem.
+
| De KoppelSleutel die eerder is ontvangen door Doelsysteem van het Bronsysteem dmv een Notificatie met KoppelSleutel.
 
| verplicht
 
| verplicht
   
Regel 114: Regel 115:
 
|-
 
|-
 
| Datum
 
| Datum
| Tijdstip waarop de Terugkoppeling werd verstuurd in het Bronsysteem.
+
| Tijdstip waarop de Terugkoppeling werd verstuurd in het Doelsysteem.
 
| verplicht
 
| verplicht
   

Versie van 9 mrt 2017 om 14:35

Actor(s) Goal(s)
Bronsysteem Ontvangen Terugkoppeling van Doelsysteem.
Doelsysteem Versturen Terugkoppeling naar Bronsysteem.

NB: Bij deze beschrijving worden bron- en doel- systeem gebruikt als:

  • Bronsysteem: Het LAS dat (voorafgaand aan deze uitwisseling) een Dossier heeft verstuurd.
  • Doelsysteem: Het SWV/RP systeem dat (voorafgaand aan deze uitwisseling) een Dossier heeft ontvangen

Dit betekent dat de richting van de Dossier uitwisseling wordt aangehouden en wordt afgeweken(!) van de richting van dit beric

Preconditie

  • Bronsysteem is aangesloten op OSO keten
  • Bronsysteem heeft Dossier opgevraagd bij Doelsysteem met behulp van KoppelSleutel
  • Doelsysteem is aangesloten op OSO keten
  • Doelsysteem heeft TerugkoppelingMelding verstuurd naar Traffic Center

Postconditie

  • Bronsysteem heeft Terugkoppeling ontvangen van Doelsysteem


Basis scenario

  1. Doelsysteem verstuurt Terugkoppeling naar Bronsysteem
  2. Bronsysteem stuurt bevestiging ontvangst Terugkoppeling aan Doelsysteem*
  3. Bronsysteem toont Terugkoppeling gegevens aan Eindgebruiker (Bronsysteem)**
  4. IF Doelsysteem heeft bevestiging ontvangen
    1. Doelsysteem toont bevestiging aan Eindgebruiker (Doelsysteem)
  5. ELSE
    1. Doelsysteem toont melding aan Eindgebruiker (Doelsysteem)***
  6. ENDIF

*Deze bevestiging is impliciet op basis van correct ontvangen van bericht
**Het Bronsysteem toont de informatie uit de notificatie aan de eindgebruiker bij het desbetreffende Dossier. OSO vereist compleetheid van de informatie, maar stel geen verdere eisen aan de manier waarop een Bronsysteem dit inricht.
*** Het Doelsysteem doet één poging per Terugkoppeling om deze te versturen na het Bronsysteem; er volgen geen nieuwe (automatische) pogingen wanneer de aflevering faalt. Het Doelsysteem toont haar eindgebruiker informatie over het wel of niet succesvol versturen van de Terugkoppeling. De eindgebruiker kan dan een nieuwe poging initiëren voor het versturen van een Terugkoppeling.

Uitzonderingen en meldingen

Hieronder worden alternatieve scenario's en de bijbehorende melding opgesomd:
.

Resultaat Omschrijving Toelichting Melding aan Eindgebruiker
<Terugkoppeling> De Terugkoppeling is succesvol ontvangen door het Bronsysteem. Doelsysteem toont informatie van Terugkoppeling bij overeenkomstig Dossier.
KoppelSleutelOnbekend Het Doelsysteem kent deze KoppelSleutel niet Doelsysteem kan Terugkoppeling niet herleiden naar Dossier omdat Doelsysteem koppelsleutel niet kent en meldt dit aan het Bronsysteem. Bronsysteem toont fout aan eindgebruiker.
NotSupported Het Doelsysteem ondersteunt dit type OSO uitwisseling niet. Het Doelsysteem geeft aan dat een Terugkoppeling is ontvangen, maar dat dit systeem deze functionaliteit niet ondersteund. Er vindt geen verdere verwerking plaats. De school waar de melding naar toe wordt verstuurd, heeft een systeem dat geen functie heeft voor het ontvangen van terugkoppelingen van dossiers. Neem contact op met de betreffende school.
<Geen response> Technische fout Het meldende Bronsysteem staakt de verdere Terugkoppeling en geeft de eindgebruiker hierover een foutmelding. Er kan geen verbinding gemaakt worden met het OSO systeem. Probeer het later nog eens.

Aanroep en antwoord

  • Request:
Element Uitleg Opmerkingen
bronBRIN Dit is het BRINnummer van de Bronschool dat de Terugkoppeling ontvangt verplicht
bronAanleverpuntIndex Dit is de index van het Aanleverpunt van het Doelsysteem dat de Terugkoppeling ontvangt. verplicht
doelBrin Dit is het brinnummer van het Bronsysteem dat de Terugkoppeling verstuurt. verplicht
doelAanleverpuntIndex Dit is de index van het Aanleverpunt van het Bronsysteem dat de Terugkoppeling verstuurt. verplicht
KoppelSleutel De KoppelSleutel die eerder is ontvangen door Doelsysteem van het Bronsysteem dmv een Notificatie met KoppelSleutel. verplicht
Status Informatie over de status van de Aanvraag (vrij tekstveld) optioneel
Datum Tijdstip waarop de Terugkoppeling werd verstuurd in het Doelsysteem. verplicht
Bijlage(n) Meegeleverde document(en). Hiervoor gelden dezelfde afspraken als die voor bijlagen bij een Dossier gelden (LINKX)
  • Response