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, 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 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.
De væsentligste ændringer ift. den udgåede webservice
Den nye metode AfhentUPV er udarbejdet så den mest muligt er lig den udgåede webservice GuidanceEffortService.
De væsentligste ændringer er:
- at den udstilles på STILs Integrationsplatform.
- at der ved hentning, kan angives hvilken afdeling (institution) uddannelsesparathedsvurderinger skal hentes fra, hvis denne ikke sendes med, hentes 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
Webservicen består af en metode, der gør det muligt at hente uddannelsesparathedsvurderinger for en institution.
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
Sekvensdiagrammer
Webservicen 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 for sidste skoleår, men når første UPV-periode starter, får man for indeværende skoleår.
Felter i svar fra webservicen
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 webservice".
HTTP statuskode | Succeeded | ErrorMessage | Beskrivelse / hvad skal man gøre? |
---|---|---|---|
200 | true | (null) | Intet. Alt gik godt. |
500 | false | Der skete en ukendt fejl i optagelse.dk | Indrapporter venligst fejlen hvis den forekommer over flere dage |
400 | false | 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 |
401 | false | Error: Unauthorized | Du har ikke adgang til webservicen |
Testvejledning og testdata til ny webservice
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ø.
Forespørgsel | Svar | |||||
---|---|---|---|---|---|---|
KUIInstitutionsNr | filterSkoleInstituionsNr | HTTP Statuskode | Succeeded | ErrorCode | ErrorMessage | ResponseBody |
961851 | 919901 | 200 | true | Fejl ved rendering af makro 'code': Ugyldig værdi angivet til parameter 'com.atlassian.confluence.ext.code.render.InvalidValueException' [ { "navneOgAdresseBeskyttelse": false, "cpr": "2109078886", "cpr_Uuid": "a168c3e8-415c-42c1-a23c-f53324896e40", "navn": "Mathilde M. Andersen", "skole": { "institutionsNr": 919901, "navn": "Skolen i Nordøstamager" }, "klasse": { "klasseTrin": 9, "betegnelse": "9.A" }, "foersteUPV": { "fritagetFraUddannelsesparathedsvurdering": false, "praksisFagligForudsaetninger": "Høj", "socialeForudsaetninger": { "gym": "IkkeOpfyldt", "hf": "Opfyldt", "eud": "Opfyldt" }, "personligeForudsaetninger": { "gym": "Opfyldt", "hf": "Opfyldt", "eud": "Opfyldt" }, "fagligeForudsaetninger": { "faarStandpunktsKarakter": true, "karakter": { "standpunktsKarakterGennemsnit": 9.9, "danskKarakterGennemsnit": 6.9, "matematikKarakterGennemsnit": 10.4 }, "manuelVurdering": null }, "resultat": { "skolensVurdering": { "vurderingsDato": "2022-11-11T10:11:12.465+01:00", "paratTilGym": false, "paratTilHf": true, "paratTilEud": true }, "helhedsvurdering": { "vurderingsDato": "2022-12-09T09:10:09.3+01:00", "paratTilGym": true, "paratTilHf": true, "paratTilEud": true }, "revurdering": null } }, "afsluttendeUPV": { "fritagetFraUddannelsesparathedsvurdering": false, "praksisFagligForudsaetninger": "Høj", "socialeForudsaetninger": { "gym": "IkkeOpfyldt", "hf": "Opfyldt", "eud": "Opfyldt" }, "personligeForudsaetninger": { "gym": "Opfyldt", "hf": "Opfyldt", "eud": "Opfyldt" }, "fagligeForudsaetninger": { "faarStandpunktsKarakter": true, "karakter": { "standpunktsKarakterGennemsnit": 9.8, "danskKarakterGennemsnit": 7.8, "matematikKarakterGennemsnit": 11.5 }, "manuelVurdering": null }, "resultat": { "skolensVurdering": { "vurderingsDato": "2022-11-11T10:11:12.465+01:00", "paratTilGym": false, "paratTilHf": true, "paratTilEud": true }, "helhedsvurdering": { "vurderingsDato": "2022-12-09T09:10:09.3+01:00", "paratTilGym": true, "paratTilHf": true, "paratTilEud": true }, "revurdering": null } } } ] | ||
961851 | 919902 | 200 | true | Fejl ved rendering af makro 'code': Ugyldig værdi angivet til parameter 'com.atlassian.confluence.ext.code.render.InvalidValueException' [ { "navneOgAdresseBeskyttelse": false, "cpr": "0701079183", "cpr_Uuid": "a168c3e8-415c-42c1-a23c-f53324896e41", "navn": "Benjamin C. Danielsen", "skole": { "institutionsNr": 919902, "navn": "Skolen i Brøndby" }, "klasse": { "klasseTrin": 9, "betegnelse": "9.B" }, "foersteUPV": { "fritagetFraUddannelsesparathedsvurdering": true, "praksisFagligForudsaetninger": null, "socialeForudsaetninger": null, "personligeForudsaetninger": null, "fagligeForudsaetninger": null, "resultat": null }, "afsluttendeUPV": { "fritagetFraUddannelsesparathedsvurdering": false, "praksisFagligForudsaetninger": "Mellem", "socialeForudsaetninger": { "gym": "IkkeOpfyldt", "hf": "IkkeOpfyldt", "eud": "Opfyldt" }, "personligeForudsaetninger": { "gym": "IkkeOpfyldt", "hf": "Opfyldt", "eud": "Opfyldt" }, "fagligeForudsaetninger": { "faarStandpunktsKarakter": true, "karakter": { "standpunktsKarakterGennemsnit": 10.4, "danskKarakterGennemsnit": 10.8, "matematikKarakterGennemsnit": 9.4 }, "manuelVurdering": null }, "resultat": { "skolensVurdering": { "vurderingsDato": "2022-11-20T14:15:16.123+01:00", "paratTilGym": false, "paratTilHf": false, "paratTilEud": true }, "helhedsvurdering": { "vurderingsDato": "2022-11-20T14:15:16.2+01:00", "paratTilGym": false, "paratTilHf": true, "paratTilEud": true }, "revurdering": { "vurderingsDato": "2022-12-20T14:12:11+01:00", "paratTilGym": true, "paratTilHf": true, "paratTilEud": true } } } } ] | ||
961851 | <ikke sat> | 200 | true | Fejl ved rendering af makro 'code': Ugyldig værdi angivet til parameter 'com.atlassian.confluence.ext.code.render.InvalidValueException' [ { "navneOgAdresseBeskyttelse": false, "cpr": "1509079036", "cpr_Uuid": "a168c3e8-415c-42c1-a23c-f53324896e42", "navn": "Alma P. Carlsen", "skole": { "institutionsNr": 919903, "navn": "Efterskolen i Århus" }, "klasse": { "klasseTrin": 9, "betegnelse": "9.A" }, "foersteUPV": { "fritagetFraUddannelsesparathedsvurdering": false, "praksisFagligForudsaetninger": "Høj", "socialeForudsaetninger": { "gym": "Opfyldt", "hf": "Opfyldt", "eud": "Opfyldt" }, "personligeForudsaetninger": { "gym": "Opfyldt", "hf": "Opfyldt", "eud": "Opfyldt" }, "fagligeForudsaetninger": { "faarStandpunktsKarakter": false, "karakter": null, "manuelVurdering": { "fagligeForudsaetningerForGym": "IkkeOpfyldt", "fagligeForudsaetningerForHf": "Opfyldt", "danskFagligeForudsaetningerForEud": "Opfyldt", "matematikFagligeForudsaetningerForEud": "IkkeOpfyldt" } }, "resultat": { "skolensVurdering": { "vurderingsDato": "2022-11-28T16:14:12.1+01:00", "paratTilGym": false, "paratTilHf": true, "paratTilEud": false }, "helhedsvurdering": { "vurderingsDato": "2022-12-14T15:15:15.1+01:00", "paratTilGym": false, "paratTilHf": true, "paratTilEud": false }, "revurdering": null } }, "afsluttendeUPV": { "fritagetFraUddannelsesparathedsvurdering": false, "praksisFagligForudsaetninger": "Høj", "socialeForudsaetninger": { "gym": "Opfyldt", "hf": "Opfyldt", "eud": "Opfyldt" }, "personligeForudsaetninger": { "gym": "Opfyldt", "hf": "Opfyldt", "eud": "Opfyldt" }, "fagligeForudsaetninger": { "faarStandpunktsKarakter": false, "karakter": null, "manuelVurdering": { "fagligeForudsaetningerForGym": "IkkeOpfyldt", "fagligeForudsaetningerForHf": "Opfyldt", "danskFagligeForudsaetningerForEud": "Opfyldt", "matematikFagligeForudsaetningerForEud": "IkkeOpfyldt" } }, "resultat": { "skolensVurdering": { "vurderingsDato": "2022-11-28T16:14:12.1+01:00", "paratTilGym": false, "paratTilHf": true, "paratTilEud": false }, "helhedsvurdering": { "vurderingsDato": "2022-12-14T15:15:15.1+01:00", "paratTilGym": false, "paratTilHf": true, "paratTilEud": false }, "revurdering": null } } } ] | ||
123456 | <ikke sat> | 200 | true | [] | ||
123456 | 123456 | 204 | false |
Mapning af felter mellem den udgåede webservice og den nye webservice
I nedenstående tabel er properties fra den udgåede webservice GuidanceEffortService beskrevet i venstre side under de grå felter. Properties fra den nye webservice AfhentUPV er beskrevet i højre side under de grønne felter.
Nogle properties fra den udgåede GuidanceEffortService udgår. Properties der udgår, er noteret med 'Udgår'.
Den nye AfhentUPV webservice indeholder nye properties, som ikke findes i den udgåede GuidanceEffortServic webservice. Nye properties noteres med '-' i de tre grå kolonner i venstre side.
Property i eksisterende webservice: GuidanceEffortService | Type | Beskrivelse | Property i ny webservice: AfhentUPV | Type | Påkrævet | Beskrivelse |
---|---|---|---|---|---|---|
PupilsGuidance | Kan indeholde: | Udgår | ||||
IsProtected | boolean | Protected | navneOgAdresseBeskyttelse | boolean | X | False = navn og addresse er ikke beskyttet True = navn og addresse er beskyttet False som default |
IsVerifiedByCpr | integer | VerificationLevel (Vi ved ikke hvad det betyder) | Udgår | |||
cpr | String | The pupils CPR <xs:minLength value="10"/> | cpr | String | X | CPR-nummer for elev |
- | - | - | cPR_UUID | String | X | Er et standard guid format |
name | String | The pupils name | navn | String | X | Elevens navn |
- | - | - | klasse | X | Nuværende klasse Indeholder: klassetrin klassebetegnelse | |
classLevel | String | class level of in school applicant Values: | klasseTrin | int | X | Nuværende klassetrin Kan have følgende værdier: 8 = ottende klasse 9 = niende klasse 10 = tiende klasse |
- | - | - | klasseBetegnelse | String | Nuværende klassebetegnelse | |
- | - | - | skole | Nuværende skole Indeholder: institutionsNr navn | ||
- | - | - | institutionsNr | int | X | Skolens institutions nummer |
- | - | - | navn | String | X | Skolens navn |
FirstEducationReadinessAssessment | Første UPV Kan indeholde: | foersteUPV | Indeholder: fritagetFraUddannelsesparathedsvurdering praksisFagligForudsaetninger socialeForudsaetninger personligeForudsaetninger fagligeForudsaetninger resultat | |||
FinalEducationReadinessAssessment | Afsluttende UPV Kan indeholde: | afsluttendeUPV | Indeholder: fritagetFraUddannelsesparathedsvurdering praksisFagligForudsaetninger socialeForudsaetninger personligeForudsaetninger fagligeForudsaetninger resultat | |||
- | - | - | fritagetFraUddannelsesparathedsvurdering | boolean | true = fritaget fra UPV false = ikke fritaget fra UPV | |
practicalCompetenciesOK | String | True if the person have the practical competencies to complete the education TRUE = Competencies set to true/yes | praksisFagligForudsaetninger | String | Praksisfaglige forudsætninger "Høj" = elevens praksisfaglige forudsætning er vurderet til at være høj "Mellem" = elevens praksisfaglige forudsætning er vurderet til at være mellem | |
socialCompetenciesOK | String | True if the person have the social competencies to complete the education TRUE = Competencies set to true/yes | Udgår, erstattes af socialeForudsaetninger | |||
- | - | - | socialeForudsaetninger | Indeholder: gym hf eud | ||
personalCompetenciesOK | String | True if the person have the personal competencies to complete the education TRUE = Competencies set to true/yes | Udgår, erstattes af personligeForudsaetninger | |||
- | - | - | personligeForudsaetninger | Indeholder: gym hf eud | ||
- | - | - | gym | String | "Opfyldt" = eleven opfylder de personlige forudsætninger for gym "IkkeOpfyldt" = eleven opfylder ikke de personlige forudsætninger for gym | |
- | - | - | hf | String | "Opfyldt" = eleven opfylder de personlige forudsætninger for HF "IkkeOpfyldt" = eleven opfylder ikke de personlige forudsætninger for HF | |
- | - | - | eud | String | "Opfyldt" = eleven opfylder de personlige forudsætninger for EUD "IkkeOpfyldt" = eleven opfylder de personlige forudsætninger for EUD | |
- | - | - | fagligeForudsaetninger | Indeholder: faarStandpunktsKarakter karakter manuelVurdering | ||
- | - | - | faarStandpunktsKarakter | boolean | True = eleven får standpunkts karakter False = eleven får ikke standpunkts karakter | |
- | - | - | karakter | Er kun sat hvis eleven får standpunktskarakter Indeholder: standpunktsKarakterGennemsnit danskKarakterGennemsnit matematikKarakterGennemsnit | ||
eigthGradeProfMarks | float | Udgår, erstattes af standpunktsKarakterGennemsnit | ||||
ninthGradeProfMarks | float | Udgår, erstattes af standpunktsKarakterGennemsnit | ||||
ninthGradeExamMarks | float | Udgår, erstattes af standpunktsKarakterGennemsnit | ||||
tenthGradeProfMarks | float | Udgår, erstattes af standpunktsKarakterGennemsnit | ||||
- | - | - | standpunktsKarakterGennemsnit | decimal | Karakter gennemsnit hentet fra karakterdatabasen | |
danishAverageMark | float | danskKarakterGennemsnit | decimal | Karakter gennemsnit af dansk hentet fra karakterdatabasen | ||
mathAverageMark | float | matematikKarakterGennemsnit | decimal | Karakter gennemsnit af matematik hentet fra karakterdatabasen | ||
- | - | - | manuelVurdering | Er kun sat hvis eleven ikke får standpunktskarakter Indeholder: fagligeForudsaetningerForGym fagligeForudsaetningerForHf danskFagligeForudsaetningerForEud matematikFagligeForudsaetningerForEud | ||
academicCompetenceOk | String | True if the person have the academic competencies to complete the education TRUE = Competencies set to true/yes | Erstattes af: fagligeForudsaetningerForGym | |||
- | - | - | fagligeForudsaetningerForGym | String | "Opfyldt" = eleven opfylder de faglige forudsætninger for gym "IkkeOpfyldt" = eleven opfylder ikke de faglige forudsætninger for gym | |
- | - | - | fagligeForudsaetningerForHf | String | "Opfyldt" = eleven opfylder de faglige forudsætninger for HF "IkkeOpfyldt" = eleven opfylder ikke de faglige forudsætninger for HF | |
academicDanishCompetenceOk | String | True if the person have the academic danish competencies to complete the education TRUE = Competencies set to true/yes | danskFagligeForudsaetningerForEud | String | "Opfyldt" = eleven opfylder de dansk faglige forudsætninger for EUD "IkkeOpfyldt" = eleven opfylder ikke de dansk faglige forudsætninger for EUD | |
academicMathCompetenceOk | String | True if the person have the academic math competencies to complete the education TRUE = Competencies set to true/yes | matematikFagligeForudsaetningerForEud | String | "Opfyldt" = eleven opfylder de matematik faglige forudsætninger for EUD "IkkeOpfyldt" = eleven opfylder ikke de matematik faglige forudsætninger for EUD | |
GYM | Details of the partial conclusions for all types of educations Kan indeholde: | Udgår | ||||
hf | Details of the partial conclusions for all types of educations Kan indeholde: | Udgår | ||||
EUD | Details of the partial conclusions for all types of educations Kan indeholde: | Udgår | ||||
notInterested | String | If the applicant is not interested in the education | Udgår | |||
interested | If the applicant has interested in the education Kan indeholde: | Udgår | ||||
OTHER | String | OTHER_CHOSEN = The pupils have choosed 'other' OTHER_NOT_CHOSEN = The pupils have not choosed 'other' | andreAktiviteter (udkast) | Dette passer med Andre aktiviteter, som ikke er lavet endnu. | ||
currentUpvResult | String | NOT_INTERESTED = The pupils have not expressed interested NOT_EVALUATED = The pupils have expressed interested, but have not been evaluated jet AUTOMATIC_NOT_READY = The pupils have expressed interested, and have been automatic evaluated not ready AUTOMATIC_READY= The pupils have expressed interested, and have been automatic evaluated not ready MANUAL_NOT_READY = The pupils have expressed interested, and have been manuel evaluated not ready MANUAL_READY = The pupils have expressed interested, and have been manuel evaluated not ready | Udgår, erstattes af resultat | |||
- | - | - | resultat | Indeholder: skolensVurdering helhedsvurdering revurdering | ||
- | - | - | skolensVurdering | Indeholder: vurderingsDato paratTilGym paratTilHf paratTilEud | ||
helhedsvurdering | Indeholder: vurderingsDato paratTilGym paratTilHf paratTilEud | |||||
revurdering | Indeholder: vurderingsDato paratTilGym paratTilHf paratTilEud | |||||
- | - | - | vurderingsDato | DateTime | Dato for sidste gang eleven blev vurderet | |
- | - | - | paratTilGym | boolean | True = institutionen vurdere eleven parat False = institutionen vurdere eleven ikke parat | |
- | - | - | paratTilHf | boolean | True = institutionen vurdere eleven parat False = institutionen vurdere eleven ikke parat | |
- | - | - | paratTilEud | boolean | True = institutionen vurdere eleven parat False = institutionen vurdere eleven ikke parat | |
lastAutomaticAssessment | DateTime? | Indeholder enten en DateTime eller en assessmentDate | Udgår | |||
lastManualAssessment | DateTime? | Indeholder enten en DateTime eller en assessmentDate og result | Udgår | |||
assessmentDate | DateTime | Contains the assessment date | Erstattes af: vurderingsDato | |||
result | String | READY = Competencies set to true/yes NOT_READY = Competencies set to false/no NOT_EVALUATED = Competencies are not given/specified | Udgår | |||
InstitutionNotFoundType | Smides når der ikke findes en institution med det medsendte inst.nr. Indeholder en errorMessage | Udgår | ||||
AuthorizationFailedType | Smides når man ikke har adgang til at se elever for given institution. Indeholder en errorMessage | Udgår | ||||
errorMessage | String | Udgår |
Spørgsmål og svar (QA)
Q: Hvorfor får jeg ikke nogen uddannelsesparathedsvurderinger tilbage på institutionsnummer xxxxxx?
A: Der kan være to muligheder for dette:
- Der er ikke nogen uddannelsesparathedsvurderinger tilknyttet den givne institution.
Verificer at der går elever på skolen i elev-databasen - 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 portal