Webservicen IndberetUPV erstatter den nuværende 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.
Plan for overgang til ny webservice
Den nye webservice IndberetUPV skal anvendes fra 1. november 2022.
Den nuværende CompetenciesService lukkes per 1. august 2022.
De væsentligste ændringer ift. den nuværende webservice
Den nye webservice IndberetUPV er udarbejdet så den mest muligt er lig den nuværende webservice CompetenciesService.
De væsentligste ændringer er:
- at den udstilles på STILs Integrationsplatform.
- at der ved indberetning, skal angives hvilken afdeling (institution) eleven går på.
- at webservicen er lukket for indberetning i perioder i løbet af skoleåret. Se mere under Brug af webservicen.
- at oplysningerne der skal indberettes simplificeres pba. reglerne om at alle skal vurderes til hhv. erhvervsuddannelse, gymnasiet og hf.
Endpoints
Indhold opdateres.
| Miljø | Endpoint på IPL | Endpoint WSDL + XSD på IPL | Beskrivelse |
|---|---|---|---|
| Prod | |||
| Eksterns testmiljø (ET/INT) |
Adgang
Webservicen er tilgængelig på STILs Integrationsplatform (IPL) og adgangsstyringen til data sker gennem STILs Tilslutningsystem.
Har dit system ikke tidligere anvendt Integrationsplatformen? Så læs her, hvordan du kommer i gang. Når der anmodes om adgang, skal det kort beskrives hvad formålet med adgangen er, hvilke opgave systemet der skal integrer løser og hvad det bruges til.
Brug af webservicen
Webservicen består af en metode, der gør det muligt at indberette en elevs uddannelsesparathedsvurderinger for en afdeling under en hovedinstitution.
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
Ved første UPV-periodes start, kan skolemedarbejderen via skolens elevadministrative system indberette uddannelsesparathedsvurderinger. Første UPV-periode vil typisk løbe fra 1. november til fristen 1. december.
Ved første UPV-periodes slut, lukkes der for, at webservice kan indsende data til Optagelse.dk. Hvis skolen fx på grund af fejl/mangler har behov for at foretage ændringer efter periode-slut, kan skolemedarbejderen logge ind i Optagelse.dk og manuelt redigere i ønskede uddannelsesparathedsvurderinger.
Tilsvarende er gældende i forhold til afsluttende UPV-periodes start og slut. Afsluttende UPV-periode vil typisk løbe fra medio maj til medio juni. Der kan IKKE redigeres manuelt efter afsluttende periodes slutdato.
Diagrammet nedenfor illustrerer et overblik over skoleåret og de perioder, hvor der er åbnet for at indberette uddannelsesparathedsvurdering via IndberetUPV webservice.
Felter i svar fra webservicen
Indhold opdateres.
| Http statuskode | Fejlkode | Beskrivelse |
|---|---|---|
| 201 | - | - |
| 400 | ?? | UPV ikke udfyldt korrekt |
| 400 | ?? | UPV-periode lukket |
| 401 | ?? | Ingen adgang til at indrapportere for eleven. |
| 500 | ||
Testvejledning og testdatas til ny webservice
Indhold opdateres. For at teste den nye webservice oprettes en testvejledning, samt en beskrivelse af tilgængeligt testdata.
Mapning af felter mellem nuværende webservice og felter i ny webservice
I nedenstående tabel er properties fra den nuværende webservice CompetenciesService beskrevet i venstre side under de grå felter og properties fra den nye webservice i højre side under de grønne felter.
Nogle properties fra den nuværende CompetenciesService udgår i den nye IndberetUPV webservice. Properties der udgår i den nye webservice noteres med 'Udgår'.
Den nye IndberetUPV webservice indeholder nye properties, som ikke findes i den nuværende CompetenciesService webservice. Properties der ikke findes i den nuværende webservice noteres med '-'.
| Property i eksisterende webservice: setCompetencies(CompetenciesRequestType competencies) | Type | Beskrivelse | Property i ny webservice: IndberetUPV | Type | Påkrævet | Beskrivelse |
|---|---|---|---|---|---|---|
cpr | String* | A valid CPR number with 10 uppercase alphanumeric digits. First 6 digits are number and rest 4 are uppercase alphanumeric. | Cpr | String | X | CPR-nummer for elev |
| - | - | - | Afdeling | Int | X | Afdelingsinstitutionsnummer for den skole, som eleven går på. |
| - | - | - | PraksisFaglig | Enum | X | Mulige værdier jf. lovgivning:
Bemærk: Denne værdi indberettes fremover for eleven UDEN sammenhæng til en uddannelsestype. |
eud:isPersonalCompetenciesOK | boolean | true= has the competencies, false= doesn't has the competencies. Default value is false ("nej"). If interest is given for eud, then personal competencies is mandatory. | eud:Personlig | boolean | X | true = har personlige forudsætninger for at kunne vurderes parat til EUD false = har IKKE personlige forudsætninger for at kunne vurderes parat til EUD |
| eud:isSocialCompetenciesOK | boolean | true= has the competencies, false= doesn't has the competencies. Default value is false ("nej"). If interest is given for eud, then social competencies is mandatory. | eud:Social | boolean | X | true = har sociale forudsætninger for at kunne vurderes parat til EUD false = har IKKE sociale forudsætninger for at kunne vurderes parat til EUD |
eud:isPracticalCompetenciesOK | boolean | true=has the competencies, false= doesn't has the competencies. Default value is false ("middel"). If interest is given for eud, then practical competencies is mandatory. | Udgår | Udgår | Udgår og erstattes af det nye PraksisFaglig felt. | |
gym:isPersonalCompetenciesOK | boolean | true= has the competencies, false= doesn't has the competencies. Default value is false ("nej"). If interest is given for eud, then personal competencies is mandatory. | gym:Personlig | boolean | X | true = har personlige forudsætninger for at kunne vurderes parat til GYM false = har IKKE personlige forudsætninger for at kunne vurderes parat til GYM |
gym:isSocialCompetenciesOK | boolean | true= has the competencies, false= doesn't has the competencies. Default value is false ("nej"). If interest is given for eud, then social competencies is mandatory. | gym:Social | boolean | X | true = har sociale forudsætninger for at kunne vurderes parat til GYM false = har IKKE sociale forudsætninger for at kunne vurderes parat til GYM |
| gym:isPracticalCompetenciesOK | boolean | true= has the competencies, false= doesn't has the competencies. Default value is false ("middel"). If interest is given for eud, then practical competencies is mandatory. | Udgår | Udgår | Udgår og erstattes af det nye PraksisFaglig felt. | |
hf:isPersonalCompetenciesOK | boolean | true= has the competencies, false= doesn't have the competencies. Default value is false ("nej"). If interest is given for eud, then personal competencies is mandatory. | hf:Personal | boolean | X | true = har personlige forudsætninger for at kunne vurderes parat til HF false = har IKKE personlige forudsætninger for at kunne vurderes parat til HF |
| hf:isSocialCompetenciesOK | boolean | true= has the competencies, false= doesn't have the competencies. Default value is false ("nej"). If interest is given for eud, then social competencies is mandatory. | hf:Social | boolean | X | true = har sociale forudsætninger for at kunne vurderes parat til HF false = har IKKE sociale forudsætninger for at kunne vurderes parat til HF |
| hf:isPracticalCompetenciesOK | boolean | true= has the competencies, false= doesn't have the competencies. Default value is false ("middel"). If interest is given for eud, then practical competencies is mandatory. | Udgår | Udgår | Udgår og erstattes af det nye PraksisFaglig felt. | |
| isInterested | boolean* | true for choosing other activities | Udgår | Udgår | Denne er ikke en del af den nye webservice | |
| other | Udgår | Udgår | Denne er ikke en del af den nye webservice. Fremover indberettes dette af en vejleder og ikke af skolen. |
Spørgsmål og svar
Indhold opdateres.