Versioner sammenlignet

Nøgle

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

...

Webservicen IndberetUPV erstatter den udgåede webservice CompetenciesService, som anvendes af grundskoler til at indberette Uddannelsesparathedsvurderinger (UPV) for deres elever til Optagelse.dk. Uddannelsesparathedsvurderingerne indberettes til alle elever i 8., 9. og 10. klasses elever i grundskolen to gange per skoleår.

NYT I DENNE VERSION af dette dokument: Se gul markering i Felter i svar fra webservicen. 


Indholdsfortegnelse


Plan for overgang til ny webservice

...

Webservicen består af en metode, der gør det muligt at indberette en elevs uddannelsesparathedsvurderinger for en afdeling med en dataaftale eller en afdeling under en hovedinstitution med en dataaftale.
For at kunne anvende webservicen korrekt, er det vigtigt at kalde med det rigtige institutionsnummer. Læs mere om de forskellige institutionstyper her: Beskrivelse af institutioner

Metoder på webservicen

Indberet

...

uddannelsesparathedsvurderinger 


  • IndsendUpv(IndsendUpvDto upvDto, int hovedinstitution)
    • Tager imod en IndsendUpvDto, som beskriver UPV data for den enkelte elev og en int for hovedinstitution
    • Hovedinstitution er institutionsnummeret for den institution, som der er indgået aftale med IPL om
    • Metoden returnerer en http status 200, hvis UPV data er gemt korrekt
    • Hvis data ikke gemmes returneres en fejlkode og beskrivelse. Det kan f.eks. være ved:
      • UPV-perioden er lukket
      • Elev i IndsendUpvDto matcher ikke afdelingsnummer eller hovedinstitutionafdelingsnummer 
      • Der mangler data i IndsendUpvDto

        Se yderligere i skemaet 'Felter i svar fra webservicen' nedenfor

...

Herunder kan du 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 webservice".


adgang til skolen I indberetter for
HTTP statuskodeSucceededErrorCodeErrorMessageBeskrivelse/ hvad skal man gøre?
200true(null)(null)Alt gik godt
500falseOPT000Der skete en ukendt fejl i optagelse.dkIndrapporter venligst fejlen hvis den forekommer over flere dage.
1XX Valideringsfejl
400falseOPT100

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 indsender korrekt data i den beskrevne format
400falseOPT101

Invalid CPR-value

Tjek at CPR-nummeret kun er tal og uden bindestreg, mellemrum e.l.
400falseOPT102

Invalid Gym-value

Tjek at strukturen og værdierne under gym-feltet er korrekte
400falseOPT103

Invalid Hf-value

Tjek at strukturen og værdierne under hf-feltet er korrekte
400falseOPT104

Invalid Eud-value

Tjek at strukturen og værdierne under eud-feltet er korrekte
400falseOPT105

Invalid Afdelings-value

Tjek at afdelingsnummeret er en tal-værdi
2XX Adgangsfejl
401falseOPT200

Afdeling ligger ikke under din institution

Sikre at I har en dataaftale for skolen eller hovedinstitutionen for skolen
3XX Opsætningsfejl
500falseOPT300

Ingen aktiv UPV-periode

Vent til en ny UPV-periode bliver aktiv (Se yderligre i QA)
500falseOPT301

Eleven er ikke registreret på din skole

Sikre at eleven er registreret på jeres skole (Se yderligre i QA)
500falseOPT302

Eleven er fritaget fra UPV

Når eleven er fritaget fra UPV af KUI i hjemkommunen, kan der ikke indberettes forudsætninger på eleven. Data bør fjernes fra det lokale elevadministrative system eller blot ikke overføres til Optagelse.dk. 



Testvejledning og testdata til ny webservice

...