Versioner sammenlignet

Gammel version 2

changes.mady.by.user Michael Lerskov

Gemt på

sammenlignet med

Ny version 3

changes.mady.by.user Michael Lerskov

Gemt på

Nøgle

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

Webservicen anvendes til afhentning af 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
nameNy webservice til afhentning af ansøgninger.pdf
height250


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å IPLEndpoint WSDL + XSD på IPLBeskrivelse
ProdTilgårTilgår

Tilgår

Eksternt Testmiljø (ET/INT)TilgårTilgår

Hent FTU ansøgninger. 

Første version kun nye ansøgninger til skoleåret 2021/22.

"Gamle" ansøgninger til til skoleåret 2021/22 og ansøgninger til skoleåret 2022/23 hentes fortsat via den nuværende FTUApplicationService

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
expandedtrue
titleHent ansøgninger per institution
  • GetAnsoegningIdsByInstitutionsNr(int institutionsNr, int64 lastRequestTime)
    • Tager imod to parametre. En int for InstitutionsNr og en int64 epoch for sidste hentninger af ansøgninger.
    • InstitutionsNr er nummeret på institutionen som ansøgningen sendes til (ansøgningsinstitution) eller nummeret på hovedinstitutionen.
    • Returnerer en liste af objekter bestående af ansøgningsID, en int64  unix epoch for hvornår ansøgningen er oprettet / opdateret samt en status.
    • Henter ansøgninger med status SENDT og SLETTET. 
    • Henter data på enten hovedinstitutionen eller ansøgningsinstitutionen
    • Den returnerede liste består kun af ansøgningIDer, hvor i der er sket ændringer siden lastRequestTime (ændringstidspunkt >= lastRequestTime).
    • Ønsker man alle ansøgninger for en institution, udlader man lastRequestTime.

  • GetAnsoegningListByIds(int institutionsNr, int[] ansøgningIDs)
    • Tager imod en liste af ansøgningsID'er, samt institutionsNr.
    • InstitutionsNr er nummeret på institutionen som ansøgningen sendes til (ansøgningsinstitution)
    • Returnerer et ansøgnings objekt som indeholder alle informationer om ansøgningen, samt en liste af bilag objekter som indeholder det originale filnavn, bilagets type samt en datetime for hvornår bilaget er oprettet og gemt.
    • returnerer kun ansøgninger med status SENDT
      - OBS husk at opdatere hvornår sidste hentning er lavet.
UI Expand
expandedtrue
titleHent ansøgninger per kommunekode (anvendes af KUI)
  • GetAnsoegningIdsByKommuneKode(int kommuneNr, int64 lastRequestTime)
    • Tager imod to parametre. Kommunenummer og en epoch for sidste hentninger af ansøgninger.
    • Returnerer en liste af objekter bestående af ansøgningsID samt en int64  unix epoch for hvornår ansøgningen er oprettet / opdateret samt en status.
    • Henter ansøgninger med status SENDT og SLETTET. 
    • Den returnerede liste består kun af ansøgningsIDer, hvor i der er sket ændringer siden lastRequestTime (ændringstidspunkt >= lastRequestTime) .
    • Ønsker man alle ansøgninger for en kommune, udlader man lastRequestTime.

  • GetAnsoegningListByIds(int kommuneNr, int[] ansøgningIDs)
    • Tager imod en liste af ansøgningsID'er, samt kommunenummer.
    • Returnerer et ansøgnings objekt som indeholder alle informationer om ansøgningen, samt en liste af bilag objekter som indeholder det originale filnavn, bilagets type samt en datetime for hvornår bilaget er oprettet og gemt.
    • returnerer kun ansøgninger med status SENDT
      - OBS husk at opdatere hvornår sidste hentning er lavet.
UI Expand
expandedtrue
titleHent bilag
  • GetTicketForBilag(int insitutionsNr / kommuneNummer, int ansoegningId, int bilagId)
    • Tager imod tre parametre. En int for institutionsNr eller kommunenummer, int for anøsgningsId samt en int for bilagID.
    • Returnerer en ticket som vil skulle bruges på filservicen til at hente det specifikke bilag.
    • InstitutionsNr er nummeret på institutionen som ansøgningen sendes til (ansøgningsinstitution)
    • Returnerer en fejl, hvis institutions ikke har ret til at hente den angivne Ansøgning eller det angivne Bilag
    • Hvis bilaget ikke eksisterer får man en bad request  med teksten 'Bilag findes ikke'
    • Hvis ansøgningen er slettet får man en bad request 'Ansøgningen findes ikke'

  • GetTicketForAllBilagForAnsoegning(string insitutionsNr / kommuneNummer, string ansoegningID)
    • Tager imod to parametre. En string for institutionsNr eller kommunenummer, samt en string for ansøgningID.
    • Returnerer en ticket som vil skulle bruges i filservicen til at hente en zip-fil for alle bilagene for en specifik ansøgning.
    • InstitutionsNr er nummeret på institutionen ansøgningen sendes til (ansøgningsinstitution)

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
expandedtrue
titleHvordan versioneres ansøgninger i den nye webservice?

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.

Ønsker SA-systemet at holde styr på, hvilken version af en ansøgning, der er indlæst i systemet, kan det opnås ved at gemme ansøgningsid, sidstÆndret. sidsteÆndret er tidspunktet for den seneste ændring, som har formatet epoch og derfor kan anvendes som versionsnummer på ansøgningen.

UI Expand
expandedtrue
titleHvordan henter jeg alle ansøgningerne til en institution og dens afdelinger?

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.
Webservicen returnerer kun ansøgninger til de udbud, hvor hovedinstititionen er registeret som ejer- eller ansøgningsinstitution.

Bemærk
titlePræcisering

Det skal præciseres, hvordan/om SA-system kan nøjes med at hente ansøgninger på de enkelte afdelinger på hovedinstitutionen.

UI Expand
expandedtrue
titleHvordan henter jeg en bestemt type ansøgninger til en afdeling på en institution?

STIL vurdere lige nu, om/hvornår webservice kan udvides med denne mulighed.

UI Expand
expandedtrue
titleHvordan henter jeg mest effektivt ansøgningerne?

En effektiv og robust hentning af ansøgninger til en institution kan opbygges på følgende måde:

  1. Gem tidspunkt for påbegyndt hentning.
  2. Hent ansøgnings-id'er for institutionen med ændringer siden sidste succesfulde hentning - GetAnsoegningIdsByInstitutionsNr(int institutionsNr, int64 lastRequestTime)
  3. Tilføj ansøgnings-id'er på eventuel fejlliste fra tidligere fejlet hentning til listen af ansøgnings-id'er (se punkt 6).
  4. Hent xml af ansøgningerne i ét kald - GetAnsoegningListByIds(int institutionsNr, int[] ansøgningIDs)
  5. For hver ansøgning
    1. Indlæs ansøgning i SA-system.
      1. Ved fejl i indlæsning tilføj ansøgnings-id til en fejlliste.
    2. For hvert bilag i ansøgningen (har ansøgningen tidligere være hentet, er det kun nødvendigt at hente bilag, hvor CreatedDate er nyere end LastRequestTime gemt i SA-systemet).
      1. Hent bilag fra Filservice - GetTicketForBilag(int insitutionsNr / kommuneNummer, int ansoegningId, int bilagId)
      2. Indlæs bilag i SA-system
        1. Ved fejl i indlæsning tilføj ansøgnings-id til en fejlliste.
  6. Genprøv ansøgningerne på fejllisten, ved for hvert ansøgnings-id at:
    1. Hente xml af ansøgningen GetAnsoegningListByIds(int institutionsNr, int[] ansøgningIDs).
    2. Gentage proces beskrevet i pkt 5. hvor ansøgningen.
    3. Indlæses ansøgningen uden fejl, så fjern ansøgning fra fejlliste.
  7. Gem fejllisten til næste indlæsning.
  8. Gem tidspunkt i pkt. 1 som lastRequestTime
UI Expand
expandedtrue
titleHvad gør jeg hvis jeg oplever fejl, når jeg henter ansøgningen eller dens bilag?

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
expandedtrue
titleHvorfor kan jeg ikke hente et bilag på en ansøgning?

Hvis der opstår fejl, når du henter et bilag, kan det skyldes:

  • At ansøger aktivt har fjernet bilaget fra ansøgningen. Det tillades ikke, at der hentes bilag, som ikke er tilknyttet til ansøgningen.
  • At ansøger har slettet ansøgningen. Der kan ikke hentes bilag på en slettet ansøgning.

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
expandedtrue
titleHvorfor er der ikke prioritet på ansøgninger til indeværende skoleår?

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.
Årsagen er, at alle ansøgninger til indeværende skoleår skal behandles af de modtagne skoler, og ansøger skal have besked. Uanset hvilken uddannelse ansøger helst vil ind på.