Versioner sammenlignet

Nøgle

  • Linjen blev tilføjet.
  • Denne linje blev fjernet.
  • Formatering blev ændret.

Metoden AfhentUPV erstatter den udgåede webservice GuidanceEffortService, som anvendes af Den Kommunale Ungeindsats (KUI) til at afhente Uddannelsesparathedsvurderinger (UPV). KUI kan få adgang til UPV data for alle elever på skoler i kommunen, som KUI dækker (bemærk, det kan være en eller flere kommuner) samt elever, som både er bosat i KUIs kommune (eller en kommune som KUI servicere), og går på skoler, som ikke er betjent af en KUI (fx efterskoler). Uddannelsesparathedsvurderingerne indberettes for alle elever i 8., 9. og 10. klasse i grundskolen to gange per skoleår, henholdsvis første og afsluttende uddannelsesparathedsvurdering.

Metoden anvendes til at returnere indhente data om UPV (Uddannelsesparathedsvurdering) for en skoles elever.
Leverandører med en aftale om udveksling af data med STIL , kan hente data fra Optagelse.dk.  Læs mere om, hvordan du får en aftale om adgang.

...

Plan for overgang til den nye webservice

Den nye metode AfhentUPV kan anvendes fra 1. november 2022 på version 1.3 af ftuKUIAnsoening webservicen.
Den udgåede GuidanceEffortService er lukket per 1. november 2022.

...

  • at den udstilles på STILs Integrationsplatform.
  • at der ved hentning , kan angives, hvilken afdeling (institution) uddannelsesparathedsvurderinger skal hentes fra, hvis denne . Hvis institutionsnummer ikke sendes med, hentes alene uddannelsesparathedsvurderinger fra alle ikke-KUI betjente skoler.

Endpoints

Se Hent ansøgninger for Den Kommunale Ungeindsats (KUI).

Adgang

Se Hent ansøgninger for Den Kommunale Ungeindsats (KUI).

Brug af webservicen

Bemærk! Det er KUI, der definerer, hvilke institutioner, der kan hentes uddannelsesparathedsvurderinger for, så kontakt venligst KUI for at få listen over institutioner, som KUI betjener.

Brug af metoden

Denne metode Webservicen består af en metode, der gør det muligt at hente uddannelsesparathedsvurderinger for eninstitution eller flere institutioner samt elever, som ikke er vurderet parat af den skole, de går på, som ikke er KUI-betjent, typisk efterskoler.
For at kunne anvende webservicen metoden korrekt, er det vigtigt at kalde med det rigtige institutionsnummer. Læs mere om de forskellige institutionstyper her:  Beskrivelse af institutionerMetoder på webservicen


Metoden

UI Expand
titleHente uddannelsesparathedsvurderinger
  • AfhentUPV(int KUIInstitutionsNr, int? filterSkoleInstituionsNr)
    • Tager imod en int som er institutionsnummer for den givne KUI vejleder, der kaldes på vegne af 
    • Tager imod en valgfri int som er et institutionsnummer for en given skole
      • Hvis denne ikke sendes med, vises udelukkende uddannelsesparathedsvurderinger for alle de af kommunens elever, som går på ikke-kui betjente skolerskoler og af deres skole ikke er vurderet uddannelsesparate. 
    • Metoden returnerer en liste af uddannelsesparathedsvurderinger for enten alle ikke-kui betjente skoler eller for en given institution, hvis et institutionsnummer er tilføjet
    • Se yderligere i skemaet 'Felter i svar fra webservicen'


Sekvensdiagrammer

Webservicen Metoden AfhentUPV kan bruges hele året rundt og henter UPV'erne for det skoleår, som seneste UPV tilhører. Det vil sige, at indtil første UPV-periode starter får man , returneres data for sidste skoleår, men når indtil første UPV-periode starter, får man hvorfra UPV for indeværende skoleår returneres efterhånden, som de indberettes af skolen.

Skoleår


Sekvensdiagram hentUPV

Felter i svar fra

...

metoden

Herunder kan I se hvilke HTTP statuskoder og svar I kan få tilbage. Eksempler på hvad data der kan forsage de forskellige beskeder er listet herunder i sektionen "Testvejledning og testdata til ny webservicemetode".


HTTP statuskodeSucceededErrorMessageBeskrivelse / hvad skal man gøre?
200true(null)Intet. Alt gik godt.
500falseDer skete en ukendt fejl i optagelse.dkIndrapporter venligst fejlen hvis den forekommer over flere dage
400false

Dataen du har sendt overholder ikke kontrakten. Verificer venligst at du indsender det korrekte data i den specificerede struktur og med de rigtige datatyper.

Tjek at du har indsat korrekt data i det beskrevne format
401falseError: UnauthorizedDu har ikke adgang til webservicen

Testvejledning og testdata til ny

...

metode

Herunder kan I se nogle eksempler på requests/forespørgsler og de svar I kan forvente at få i test-miljøet. Det er de samme svar I vil få i produktions-miljøet, hvis lignende fejl opstår i det miljø.

...

  1. Der er ikke nogen uddannelsesparathedsvurderinger tilknyttet den givne institution.
    Verificer at der går elever på skolen i elev-databasen samt, at skolen har påbegyndt indberetning af UPV-data til Optagelse.dk
  2. Det anvendte Dit KUI-center er ikke registreret til at betjene den skole, hvis institutionsnummer du gav.
    En KUI -vejleder skal tilknytte sig skolen i Optagelses medarbejder portalskolen i Optagelse.dk, hvis de betjener skolen. KUI har det fulde overblik over skoler, de betjener og bør tilvejebringe denne.