OSO:2017/Versturen Terugkoppeling

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen

Overstapservice Onderwijs-symbol.png Overstapservice Onderwijs: 2017/Versturen Terugkoppeling

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

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

  • bronsysteem: Het LAS dat de Terugkoppeling ontvangt(!) (en voorafgaand een Notificatie met KoppelSleutel naar het Doelsysteem heeft verstuurd.)
  • doelsyteem: Het SWV/RP dat de Terugkoppeling verstuurt(!) (en voorafgaand een Notificatie met KoppelSleutel van het Bronsysteem heeft ontvangen.)

Preconditie

  • DoelSysteem is aangesloten op OSO keten
  • DoelSysteem heeft Terugkoppeling melding verstuurd naar Traffic Center
  • BronSysteem is aangesloten op OSO keten
  • DoelSysteem heeft Dossier opgevraagd bij Bronsysteem met behulp van KoppelSleutel

Postconditie

  • Doelsysteem heeft Terugkoppeling ontvangen van Bronsysteem


Basis scenario

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

*Deze bevestiging is impliciet op basis van correct ontvangen van bericht
**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.
*** 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.

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 Doelsysteem. Bronsysteem toont informatie van Terugkoppeling bij overeenkomstig Dossier.
KoppelSleutelOnbekend Het Bronsysteem kent deze KoppelSleutel niet Bronsysteem kan Terugkoppeling niet herleiden naar Dossier omdat Bronsysteem koppelsleutel niet kent en meldt dit aan het Doelsysteem. Doelsysteem toont fout aan eindgebruiker.
NotSupported Het Bronsysteem 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. 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 Doelsysteem 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 Notificatie wil versturen. verplicht
bronAanleverpuntIndex Dit is de index van het Aanleverpunt van het Bronsysteem dat de Notificatie wil versturen. verplicht
doelBrin Dit is het brinnummer van het Doelsysteem dat de Notificatie ontvangt. verplicht
doelAanleverpuntIndex Dit is de index van het Aanleverpunt van het Doelsysteem dat de Notificatie ontvangt. verplicht
KoppelSleutel De KoppelSleutel zoals eerder ontvangen van het DoelSysteem. verplicht
Status Informatie over de status van de Aanvraag (vrij tekstveld) optioneel
Datum Tijdstip waarop de Terugkoppeling werd verstuurd in het Bronsysteem. verplicht
Bijlage(n) Meegeleverde document(en). Hiervoor gelden dezelfde afspraken als die voor bijlagen bij een Dossier gelden (LINKX)
  • Response