OSO:2017/Opvragen Aanleverpunten: verschil tussen versies

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen
k
 
(6 tussenliggende versies door dezelfde gebruiker niet weergegeven)
Regel 16: Regel 16:
 
* Voor het vullen van de keuzelijst van AP's bij de SWV aanvragen.
  
* Voor het vullen van de keuzelijst van AP's bij de SWV aanvragen.
   
−
NB: Alle filter parameters van deze aanroep zijn optioneel. Door geen parameter in te vullen, wordt een lijst van alle (actieve) AP's die bij het TC bekend zijn opgevraagd. Dit is incidenteel toegestaan, maar het wordt gevraagd en sterk aanbevolen om 'zuinig' met deze functie om te springen.
 +
NB: Alle filter parameters van deze aanroep zijn optioneel. Door geen parameter in te vullen, wordt een lijst van alle (actieve) AP's die bij het TC bekend zijn opgevraagd. Dit is incidenteel toegestaan, maar het wordt '''sterk aanbevolen''' om 'zuinig' met deze functie om te springen én '''bij voorkeur een filter toe te passen!'''.
−  
   
 
==Preconditie==
  
==Preconditie==
Regel 27: Regel 26:
   
   
  +
===Request===
−
==Aanroep en antwoord==
  
  +
  +
* Zonder filterparameters
  +
<syntaxhighlight lang="xml">
  +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.eld.nl/schemas/Overstapservice/20170401">
  +
<soapenv:Header/>
  +
<soapenv:Body>
  +
<ns:overzichtAanleverpuntRequest>
  +
</ns:overzichtAanleverpuntRequest>
  +
</soapenv:Body>
  +
</soapenv:Envelope>
  +
  +
</syntaxhighlight>
  +
  +
  +
* Met filter op APsleutel
  +
<syntaxhighlight lang="xml">
  +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.eld.nl/schemas/Overstapservice/20170401">
  +
<soapenv:Header/>
  +
<soapenv:Body>
  +
<ns:overzichtAanleverpuntRequest>
  +
<ns:aanleverpuntSleutel>E7B01291-3DA0-4F68-BD17-AB74880050B6</ns:aanleverpuntSleutel>
  +
</ns:overzichtAanleverpuntRequest>
  +
</soapenv:Body>
  +
</soapenv:Envelope>
  +
  +
</syntaxhighlight>
   
 
{|class="wikitable"
  
{|class="wikitable"
Regel 59: Regel 84:
 
| Optioneel. Impliciet
  
| Optioneel. Impliciet
 
|}
  
|}
  +
  +
===Response===
  +
  +
<syntaxhighlight lang="xml">
  +
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  +
<SOAP-ENV:Header/>
  +
<SOAP-ENV:Body>
  +
<over:overzichtAanleverpuntResponse xmlns:over="http://xml.eld.nl/schemas/Overstapservice/20170401">
  +
<over:brin>
  +
<over:aanleverpunt>
  +
<over:brin>17PR</over:brin>
  +
<over:aanleverpuntIndex>0</over:aanleverpuntIndex>
  +
<over:sector>PO</over:sector>
  +
<over:wijzigingsdatum>2013-01-01 00:00:00.0</over:wijzigingsdatum>
  +
<over:label>17PR00000 LAS PCBS De Wegwijzer</over:label>
  +
<over:doel>OV</over:doel>
  +
</over:aanleverpunt>
  +
<over:aanleverpunt>
  +
<over:brin>00MS</over:brin>
  +
<over:aanleverpuntIndex>0</over:aanleverpuntIndex>
  +
<over:sector>PO</over:sector>
  +
<over:wijzigingsdatum>2013-01-01 00:00:00.0</over:wijzigingsdatum>
  +
<over:label>00MS00000 LAS Professor Waterinkschool School voor SO</over:label>
  +
<over:doel>OV</over:doel>
  +
</over:aanleverpunt>
  +
</over:brin>
  +
</over:overzichtAanleverpuntResponse>
  +
</SOAP-ENV:Body>
  +
</SOAP-ENV:Envelope>
  +
</syntaxhighlight>
   
 
== Uitzonderingen en meldingen==
  
== Uitzonderingen en meldingen==
Regel 65: Regel 120:
 
{|class="wikitable"
  
{|class="wikitable"
 
! style="text-align:left;"| Resultaat
  
! style="text-align:left;"| Resultaat
−
! style="text-align:left;"| A/E<sup>*</sup>
  
 
! style="text-align:left;"| Omschrijving
  
! style="text-align:left;"| Omschrijving
 
! style="text-align:left;"| Toelichting
  
! style="text-align:left;"| Toelichting
  +
 
|-
  
|-
  +
| <Lijst met AP's>
  +
| TC retourneert (gefilterde) lijst met Aanleverpunten
  +
| ''NB: Lijst kan leeg zijn(!)''
  +
  +
|-
  +
| '''DoelNietBekend'''
  +
| Het opgegeven Doel heeft een afwijkende waarde (moet zijn: PaO of OV)
  +
| AP's hebben of een Doel 'PaO' of een Doel 'OV'
  +
  +
|-
  +
| '''SectorNietBekend'''
  +
| De opgegeven Sector heeft een afwijkende waarde
  +
| Sector moet een geldige onderwijssector zijn (PO, VO, ..)
  +
  +
|-
  +
| <Geen response>
  +
| Technische fout
  +
| Het bronsysteem staakt het opvragen van de Aanleverpunten.
 
|}
  
|}
  +
−
<sup>*</sup> A: Alternatief, E: Exceptie (fout)
  
 
[[Categorie:Overstapservice Onderwijs]]
  
[[Categorie:Overstapservice Onderwijs]]
−
[[Category:Book OSO|Book OSO]]
  

Huidige versie van 11 dec 2017 om 10:33

Actor(s) Goal(s)
BronSysteem, DoelSysteem Overzicht opvragen van actieve Aanleverpunten in OSO.
Traffic Center Leveren informatie over Aanleverpunten

Basisvariant: Opvragen AP informatie

Met deze aanroep kan (zonder dat daar een Sessie voor nodig is) informatie over Aanleverpunten opgevraagd worden bij het TC. Deze informatie kan voor een aantal zaken gebruikt worden, zoals:

  • Beheren AP's in het aangesloten systeem
  • Bij het registren van AP's (via de APsleutel kan informatie over het specifieke AP worden opgehaald
  • Voor het vullen van de keuzelijst van AP's bij de SWV aanvragen.

NB: Alle filter parameters van deze aanroep zijn optioneel. Door geen parameter in te vullen, wordt een lijst van alle (actieve) AP's die bij het TC bekend zijn opgevraagd. Dit is incidenteel toegestaan, maar het wordt sterk aanbevolen om 'zuinig' met deze functie om te springen én bij voorkeur een filter toe te passen!.

Preconditie

  • Bron/Doelsysteem is toegelaten op OSO keten
  • Bron/Doelsysteem heeft geldig OSO certificaat

Postconditie

  • TC heeft Bron/DoelSysteem overzicht van Aanleverpunten verstrekt


Request

  • Zonder filterparameters
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.eld.nl/schemas/Overstapservice/20170401">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:overzichtAanleverpuntRequest>
      </ns:overzichtAanleverpuntRequest>
   </soapenv:Body>
</soapenv:Envelope>


  • Met filter op APsleutel
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.eld.nl/schemas/Overstapservice/20170401">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:overzichtAanleverpuntRequest>
      <ns:aanleverpuntSleutel>E7B01291-3DA0-4F68-BD17-AB74880050B6</ns:aanleverpuntSleutel>
      </ns:overzichtAanleverpuntRequest>
   </soapenv:Body>
</soapenv:Envelope>
Element Uitleg Opmerkingen
BRIN Dit is het brinnummer van de School waar de AP's onder geregistreerd zijn. Optioneel. BRIN(4) wordt hier gebruikt (in lijn met sessie aanvraag).
Sector PO, VO Optioneel. Afgeleid van sector 'eigenaar' (school)
Doel OV (overstap) of PaO (Passend Onderwijs) Optioneel.
APsleutel Unieke sleutel zoals gegenereerd in OfficeHeart/mijnOSO bij het aanmaken van een AP. Optioneel.
Actief Optioneel. Impliciet

Response

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <over:overzichtAanleverpuntResponse xmlns:over="http://xml.eld.nl/schemas/Overstapservice/20170401">
         <over:brin>
            <over:aanleverpunt>
               <over:brin>17PR</over:brin>
               <over:aanleverpuntIndex>0</over:aanleverpuntIndex>
               <over:sector>PO</over:sector>
               <over:wijzigingsdatum>2013-01-01 00:00:00.0</over:wijzigingsdatum>
               <over:label>17PR00000 LAS PCBS De Wegwijzer</over:label>
               <over:doel>OV</over:doel>
            </over:aanleverpunt>
            <over:aanleverpunt>
               <over:brin>00MS</over:brin>
               <over:aanleverpuntIndex>0</over:aanleverpuntIndex>
               <over:sector>PO</over:sector>
               <over:wijzigingsdatum>2013-01-01 00:00:00.0</over:wijzigingsdatum>
               <over:label>00MS00000 LAS Professor Waterinkschool School voor SO</over:label>
               <over:doel>OV</over:doel>
            </over:aanleverpunt>
         </over:brin>
      </over:overzichtAanleverpuntResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Uitzonderingen en meldingen

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

Resultaat Omschrijving Toelichting
<Lijst met AP's> TC retourneert (gefilterde) lijst met Aanleverpunten NB: Lijst kan leeg zijn(!)
DoelNietBekend Het opgegeven Doel heeft een afwijkende waarde (moet zijn: PaO of OV) AP's hebben of een Doel 'PaO' of een Doel 'OV'
SectorNietBekend De opgegeven Sector heeft een afwijkende waarde Sector moet een geldige onderwijssector zijn (PO, VO, ..)
<Geen response> Technische fout Het bronsysteem staakt het opvragen van de Aanleverpunten.
Overgenomen van "https://developers.wiki.kennisnet.nl/index.php?title=OSO:2017/Opvragen_Aanleverpunten&oldid=7823"