Sidehistorik
...
Webservicen anvendes til afhentning af
...
Det betyder at:
- Adressen (endpoint) til den tekniske grænseflade (webservice) ændres.
- Adgangsstyringen til afhentning flyttes fra Optagelse.dk til STILs Tilslutningssystem.
- Den tekniske grænseflade vil få en ny struktur, og der vil blive justeret i indholdet. Dvs. xsd’en vil bliver ændret.
Struktur og indhold vil senere blive præciseret.
For at sikre en smidig overgang og risikominimering ift. udvikling og idriftsættelse, ønsker STIL at indgå i dialog med jer om brugen af den nye tekniske grænseflade. På den måde håber vi at kunne stille jer bedst ift. jeres arbejde.
...
FTU ansøgninger (Fælles Tilmelding til Ungdomsuddannelserne) til ungdomsuddannelser og 10. klasse. Ansøgningerne oprettes af 9. og 10. klasses elever i grundskolen eller uden for skole (UFS) ansøgere, som ikke går i grundskolen.
Plan for overgang til ny webservice
...
- Fra januar 2022 afhentes ansøgninger fra 2 webservices:
- Nye ansøgninger til skoleåret 2021/22 afhentes via den nye webservice på Integrationsplatformen. Dvs. der er kun uddannelsessteder med studiestart i 1. halvår 2022, som skal hente via den nye webservice. Gymnasiale uddannelser vil ikke være omfattet, da de uddannelser ikke har studiestart i 1. halvår 2022.
- Ansøgninger til skoleåret 2022/23 afhentes via den nuværende webservice på Optagelse.dk.
- Fra oktober 2022
- Ansøgninger afhentes via den nye webservvice på Integrationsplatformen (den nuværende webservice på Optagelse.dk lukkes).
View file | ||||
---|---|---|---|---|
|
De væsentligste ændringer ift. den nuværende webservice
- Ansøgningsmodellen laves om, så der nu kun er én ansøgning til ét udbud af en uddannelse for en ansøger. Formålet er, at gøre det mere simplet. Dvs. at hvis en ansøgere har 5 ansøgninger, er det fremadrettet 5 selvstændige ansøgninger til hvert sit udbud. Tidligere var det 5 uddannelsesønsker samlet i én ansøgning. Det gælder både for uden-for-skole ansøgere (ansøgere der ikke går i 9. og 10. klasse) og ansøgere der går i 9. og 10. klasse.
- Pdf version af ansøgning og prioriteringsliste udgår (data leveres udelukkende som xml, så det kan vises i SA-systemet)
- For ansøgninger med prioritet, vil prioriteten fremgår af ansøgningen. Ændres prioriteten opdateres det i ansøgningen.
- Færre informationer i ansøgningen pga. færre input fra bruger, samt generel oprydning.
- Beviser fra grundskolen og fag på gymnasial niveau vedlægges som pdf og xml.
- Billeder fra mobiltelefon kan også vedlægges som bilag (ud over pdf).
- Mulighed for at hente bilag enkeltvis, i stedet for alle på en gang.
- Bedre muligheder ift. at hente delta af ændrede ansøgninger, så kun ansøgninger med ændringer siden sidste hentning skal behandles.
- Adgang sker via STILs Integrationsplatform - og ikke direkte til systemet.
Én ansøgning til ét udbud af en uddannelse for én ansøger
Nedenfor illustreres de logiske sammenhænge I Optagelse.dk, og hvordan relationerne er mellem forretningsbegreberne.
Info |
---|
En ansøger er en borger, som søger en ungdomsuddannelse på Optagelse.dk. Ansøgeren opretter en ansøgning til ét specifikt udbud af en uddannelse på ét uddannelsessted. Alt efter hvilket udbud ansøgeren søger skal der angives uddannelsesspecifikke informationer, som er afhængig af typen af uddannelse der udbydes. Oprettes der flere ansøgninger til det kommende skoleår angives der en indbyrdes prioritering for ansøgningerne, som angiver hvilken uddannelse og institution ansøgeren helst vil optages på (ansøgninger til indeværende skoleår prioriteres ikke). Til en ansøgning kan en ansøgere vedlægge ét eller flere bilag, som ansøger ønsker skal indgå i vurderingen af ansøgningen. Beviser vedlægges altid ansøgningen som et bilag, hvis de eksisterer i den nationale Karakterdatabasen fra 9. og 10. klasse, samt hvis der eksistere beviser på gymnasial niveau i den nationale Eksamensdatabase. |
Endpoints
Miljø | Endpoint på IPL | Endpoint WSDL + XSD på IPL | Beskrivelse |
---|---|---|---|
Prod | Tilgår | Tilgår | Tilgår |
Eksternt Testmiljø (ET/INT) | Tilgår | Tilgår | Hent FTU ansøgninger. Første version kun nye ansøgninger til skoleåret 2021/22. |
Adgang
Webservicen er tilgængelig på STILs Integrationsplatform (IPL) og adgangsstyringen til data sker via STILs Tilslutningssystem. Har dit system ikke tidligere anvendt Integrationsplatformen? Så læs her, hvordan du kommer i gang
Brug af webservicen
Beskrivelse tilgår
- Webservicen bruger epoch til at håndterer datetimes.
- Delta funktionen kræver at man gemmer en epoch for hvornår man sidst har hentet ansøgninger succesfuldt.
Metoder på webservicen
- echo()
- Tester forbindelsen til webservicen og leverer en OK ved succes.
- Returnerer en kode 200 ved en connection og en 500 for fejl.
UI Expand | ||||
---|---|---|---|---|
| ||||
|
UI Expand | ||||
---|---|---|---|---|
| ||||
|
UI Expand | ||||
---|---|---|---|---|
| ||||
|
Sekvens diagram
Felter i svar fra webservicen
Beskrivelsen tilgår
Mapning af felter mellem ny webservice og felter i nuværende webservice
Beskrivelse tilgår
Eksempel på opbygning af grænseflade til behandling af ansøgninger
Eksempel tilgår
Spørgsmål og svar
UI Expand | ||||
---|---|---|---|---|
| ||||
Optagelse.dk indeholder kun den aktuelle version af en ansøgning. Dvs. når en ansøgning hentes er det altid den aktuelle version der udleveres. |
UI Expand | ||||
---|---|---|---|---|
| ||||
Hvis du ønsker at hente alle ansøgning til en institution og dens afdelinger, kan du kalde webservicen med institutionsnummeret på hovedinstitutionen. Vær opmærksom på, at institutionerne selv angiver hvilken hovedinstitution, der ejer udbuddet. Det gør medarbejderne på Optagelse.dk, hvor de vedligeholder deres udbud. |
UI Expand | ||||
---|---|---|---|---|
| ||||
STIL vurdere lige nu, om/hvornår webservice kan udvides med denne mulighed. |
UI Expand | ||||
---|---|---|---|---|
| ||||
En effektiv og robust hentning af ansøgninger til en institution kan opbygges på følgende måde:
|
UI Expand | ||||
---|---|---|---|---|
| ||||
Kontakt STILs support, hvis du oplevere fejl når du henter ansøgninger. Oplever du fejl, når du henter bilag, kan de skyldes at ansøgningen er opdateret. Hent ansøgningen og prøve igen. Opleves der forsat problemer skal du kontakte STILs support. |
UI Expand | ||||
---|---|---|---|---|
| ||||
Hvis der opstår fejl, når du henter et bilag, kan det skyldes:
I alle tilfælde er løsningen at hente ansøgningen igen, og se i xml'en for ansøgningen, hvilke bilag der er tilknyttet ansøgningen. |
UI Expand | ||||
---|---|---|---|---|
| ||||
Det er kun prioritet på ansøgninger om optag efter sommerferien (til det kommende skoleår). Der er ikke prioritet på ansøgninger om optag i det skoleår der er i gang (indeværende skoleår). Fx en ansøgning oprettet i januar 2022 om optage på en erhvervsuddannelse med studiestart i april 2022. |