Versioner sammenlignet

Gammel version 13

changes.mady.by.user Jane Holm Hansen

Gemt på

sammenlignet med

Ny version Nuværende

changes.mady.by.user Thor Thomsen Krarup

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. 

Indholdsfortegnelse

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å af ansøgningen. Ændres prioriteten opdateres det i ansøgningen. 
  • Færre informationer i ansøgningen pga. færre input fra ansøger, 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.

Image Removed

Endpoints

MiljøEndpoint på IPLEndpoint WSDL + XSD på IPLBeskrivelseProdTilgårTilgår

Tilgår

Eksternt Testmiljø (ET/INT)https://et.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1https://et.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1?wsdl

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

To nye webservices

Webservicen ftuAnsoegning, der beskrives på denne side, anvendes til at hente ansøgninger til en given institution.  Hvis der derimod skal hentes ansøgninger for en kommune til den kommunale ungeindsats, skal webservicen ftuKUIAnsoegning anvendes. Læs mere om webservicen her: Hent ansøgninger for en kommune (KUI)  

É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.


Image Added

Endpoints

MiljøEndpoint på IPL (WSDL + XSD)Beskrivelse
Prod

v1.6

https://integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.6

https://integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.6?wsdl

v1.5

https://integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.5

(https://integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.5?wsdl)

Hent FTU ansøgninger. 

v1.5 - Ny bilagstype til Karakteroversigt, godkendelsesstatus på forrang, videresendelse af ansøgninger.

v1.4 - Rettidighed, bopælsland (sms-ansøger), anden aktivitet og forrang tilføjet. Statusmodel ændret.

Eksternt Testmiljø (ET/INT)

v1.6

https://et.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.6

https://et.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.6?wsdl

v1.5

https://et.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.5

(https://et.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.5?wsdl)

Hent FTU ansøgninger. 

v1.6 - Fødselsdato, personstatus, flere årsager for videresend, fritaget for upv, hent bilag med zip er fjernet, mv.

v1.5 - Ny bilagstype til Karakteroversigt, godkendelsesstatus på forrang, videresendelse af ansøgninger.

Adgang

Webservicen kan anvendes af studieadministrative systemer, som er under systemrevision.

Den 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. 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.


To webservices

Webservicen ftuAnsoegning, der beskrives på denne side, anvendes til at hente ansøgninger til en given institution.  Hvis der derimod skal hentes ansøgninger for en kommune til den kommunale ungeindsats, skal webservicen ftuKUIAnsoegning anvendes. Læs mere om webservicen her: Hent ansøgninger for en kommune (KUI)  


Brug af webservicen

Webservicen består af en række metoder, der samlet gør det muligt at hente alle ansøgninger for en hovedinstitution eller en afdeling. 


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

  • echo()
    • Tester forbindelsen til webservicen og leverer en OK ved succes.
    • Returnerer en kode 200 = "Forbindelse oprettet" eller en 500 = "Forbindelse ikke oprettet"


UI Expand
expandedtrue
titleHent ansøgninger per institution
  • GetAnsoegningIdsByInstitutionsNr(int institutionsNr, int64 lastRequestTime, int? filterInstitutionNr)
    • Tager imod tre parametre. En int for InstitutionsNr, en int64 epoch for sidste hentninger af ansøgninger og en filterInstitutionNr.
    • InstitutionsNr er nummeret på institutionen som ansøgningen sendes til ansøgningsinstitutionen eller nummeret på ejerinstitutionen (hovedinstitutionen).
    • FilterInstitutionNr er et institutionNr på en under institution til det angivede institutionsNr, som betyder at der kun udleveres ansøgninger hvor ejerinstitution er institutionNr og ansøgninsinstitutionen er filterInstitutionenNr.
    • Angives ingen filterinstitution, vil alle ansøgninger på institutionsNr udleveres.
    • 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.
    • Returnerer alle ansøgninger med én af nedenstående status. Bemærk: ansøgninger til næste skoleår, først kan hentes efter STIL frigiver 1. prioritets ansøgningerne. Forventet umiddelbart efter FTU ansøgningsfristen. 
    • Deltafunktionen:
      • Delta funktionen kræver at man gemmer en epoch for hvornår man sidst har hentet ansøgninger succesfuldt.
      • 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.
    • Statuskoder: 
      • 200: OK. Hentning gik godt.
      • 204: Ingen opdateringer. Der er ingen opdaterede ansøgninger siden sidste hentning
      • 401: Institutionsnummeret er ikke gyldigt til at hente. Institutionsnummeret findes ikke i Optagelse.dk's database


  • GetAnsoegningListByIds(int institutionsNr, int[] ansøgningIDs)
    • Tager imod en liste af ansøgningsID'er, samt institutionsNr

Brug af webservicen

Webservicen består af en række metoder, der samlet gør det muligt at hente alle ansøgninger for en hovedinstitution eller en afdeling. 

For at kunne anvende webservicen korrekt, er det vigtigt at kalde med de rigtige institutionsnummer. Læs mere om de forskellige institutionstyper her: Beskrivelse af institutioner

Metoder på webservicen

echo()
  • Tester forbindelsen til webservicen og leverer en OK ved succes.
    • Returnerer en kode 200 = "Forbindelse oprettet" eller en 500 = "Forbindelse ikke oprettet"
    UI Expand
    expandedtrue
    titleHent ansøgninger per institution
    • GetAnsoegningIdsByInstitutionsNr(int institutionsNr, int64 lastRequestTime, int? filterInstitutionNr)Tager imod tre parametre. En int for InstitutionsNr, en int64 epoch for sidste hentninger af ansøgninger og en filterInstitutionNr
      • .
      • InstitutionsNr er nummeret på institutionen som ansøgningen sendes til
      ansøgningsinstitutionen eller nummeret på ejerinstitutionen (hovedinstitutionen).
    • FilterInstitutionNr er et institutionNr på en under institution til det angivede institutionsNr, som betyder at der kun udleveres ansøgninger hvor ejerinstitution er institutionNr og ansøgninsinstitutionen er filterInstitutionenNr.
    • Angives ingen filterinstitution, vil alle ansøgninger på institutionsNr udleveres.
    • 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. 
      • Deltafunktionen:
      • (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 AfventerFordeling, Tildelt og TilBehandling.
        - OBS husk at opdatere hvornår sidste hentning er lavet
    • Delta funktionen kræver at man gemmer en epoch for hvornår man sidst har hentet ansøgninger succesfuldt.
    • 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
      • .
      • Statuskoder: 
        • 200: OK.
      Hentning
        •  Hentning gik godt
      .204: Ingen opdateringer
        • .
       Der er ingen opdaterede ansøgninger siden sidste hentning
        • 401: Institutionsnummeret er ikke gyldigt til at hente. Institutionsnummeret findes
      ikke i Optagelse.dk's databaseGetAnsoegningListByIds(int institutionsNr, int[] ansøgningIDs)
        • ikke i Optagelse.dk's database
        • 404: Ingen ansøgninger fundet. Der blev ikke fundet nogle ansøgninger som matcher parametrene
    UI Expand
    expandedtrue
    titleHent bilag
    • GetURLForBilag(int insitutionsNr, int ansoegningId, int bilagId)
      • Tager imod tre parametre. En int for institutionsNr, int for anøsgningsId samt en int for bilagID.
      • Returnerer en URL som vil skulle bruges på filservicen til at hente det specifikke bilag
      • 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.
      • ansøgningen sendes til (ansøgningsinstitution)
      • Returnerer en fejl, hvis institutionen 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'
      • Statuskoder:Statuskoder: 
        • 200: OK.  Hentning Hentning gik godt.
        • 404: Bilag eller ansøgning ikke fundet. AnsoegningId eller bilagId matcher ikke med nogen værdi fra databasen.
        • 401: Institutionsnummeret  Institutionsnummeret er ikke gyldigt til at hente. Institutionsnummeret findes ikke i Optagelse.dk's database
        • 404: Ingen ansøgninger fundet. Der blev ikke fundet nogle ansøgninger som matcher parametrene
    UI Expand
    expandedtrue
    titleHent bilag
        • Det angivne institutionsnummer er ugyldigt eller har ikke adgang til at hente bilaget
        • 400: Bilaget eksisterer ikke på ansøgningen. Det angivne bilag er ikke tilknyttet ansøgningen
        • 503: Fejl i filservice. Der opstod en ukendt fejl i kommunikationen med filservice


    • GetURLForAlleBilag(string insitutionsNr, string ansoegningID) IKKE FUNKTIONEL I TIDLIGERE VERSIONER PR 15.11.23, UDGÅET I VERSION 1.6
      • Tager imod to parametre. En string for institutionsNr samt en string for ansøgningID
      GetURLForBilag(int insitutionsNr, int ansoegningId, int bilagId)
      • Tager imod tre parametre. En int for institutionsNr, int for anøsgningsId samt en int for bilagID.
      • Returnerer en URL som vil skulle bruges på i filservicen til at hente det specifikke bilaghente en zip-fil for alle bilagene for en specifik ansøgning.
      • InstitutionsNr er nummeret på institutionen som ansøgningen sendes til (ansøgningsinstitution)
      • Returnerer en fejl, hvis institutionen 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'
      • Statuskoder: 
        • 200: OK. Hentning gik godt.
        • 404: Bilag eller ansøgning Ansøgning ikke fundet. AnsoegningId eller bilagId matcher ikke med nogen værdi fra databasen.
        • 401: Institutionsnummeret er ikke gyldigt til at hente. Det angivne institutionsnummer er ugyldigt eller har ikke adgang til at hente bilaget400: Bilaget eksisterer ikke på ansøgningen. Det angivne bilag er ikke tilknyttet ansøgningenhente bilag fra denne ansøgning
        • 503: Fejl i filservice. Der opstod en ukendt fejl i kommunikationen med filservice
    • GetURLForAlleBilag(string insitutionsNr, string ansoegningID)
      • Tager imod to parametre. En string for institutionsNr samt en string for ansøgningID.
      • Returnerer en URL 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)
      • Statuskoder: 
        • 200: OK. Hentning gik godt.
        • 404: Ansøgning ikke fundet. AnsoegningId matcher ikke med nogen værdi fra databasen.
        • 401: Institutionsnummeret er ikke gyldigt til at hente. Det angivne institutionsnummer er ugyldigt eller har ikke adgang til at hente bilag fra denne ansøgning
        • 503: Fejl i filservice. Der opstod en ukendt fejl i kommunikationen med filservice

    Sekvens diagrammer

    Image Removed

    Image Removed

    Image Removed

    Sekvens diagrammer

    Image Added


    Image Added



    Betydning af status på ansøgning
    Anker
    status
    status

    Status i webserviceBetydningSA-systemer
    AfventerFordelingAnsøgningen afventer regionens eller elevfordelingsalgoritmens fordeling.

    Får prioritet 1. ansøgninger.

    Vil kun være gym/hf ansøgninger.

    TildeltAnsøgeren er tildelt plads på ansøgningen.

    Får alle ansøgninger

    TilBehandlingAnsøgningen er klar til behandling på institutionen.

    Får prioritet 1. ansøgninger og videresendte ansøgninger.

    IkkeAktuel

    Ansøgningen er trukket tilbage og er pt. ikke længere relevant for institutionen. Det kan fx ske ved:

    • At forældrene låser ansøgningerne op, og ikke underskriver igen.
    • At ansøgeren omprioritere ansøgningerne
    • At ansøgeren ikke bliver tildelt plads på ansøgningen af regionernes fordeling.

    Ansøgningen kan dog blive aktuel igen på et senere tidspunkt.

    		Får id'erne på de ansøgninger institutionen tidligere har kunne hente. 

    Selve ansøgningen og tilhørende bilag kan ikke længere hentes.
    VideresendtAnsøgningen er videresendt af institutionen selv på Optagelse.dk til en anden af ansøgers ansøgninger.
    SlettetAnsøgningen er slettet og bliver dermed ikke aktuelt igen på et senere tidspunkt.

    Felter i svar fra webservicen

     Se beskrivelse af de properties, der returneres for ansøgningen: Properties for en ansøgning 


    UI Expand
    titleDokumention af webservice

    Nedenstående beskriver WSDL for FtuAnsoegning. 


    Kodeblok
    languagexml
    firstline1
    titleWSDL
    linenumberstrue
    collapsetrue
    <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
                  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                  xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
                  xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"
                  xmlns:tns="http://ipl.stil.dk/services/optagelsedk/ftuansoegning/v1"
                  name="Optagelsedk_ftuAnsoegning"
                  targetNamespace="http://ipl.stil.dk/services/optagelsedk/ftuansoegning/v1">

    <wsdl:types>
        <xsd:schema targetNamespace="http://ipl.stil.dk/services/optagelsedk/ftuansoegning/v1">
            <xsd:include schemaLocation="Optagelsedk_ftuAnsoegning.xsd"/>
        </xsd:schema>
    </wsdl:types>

    <!-- IPL security policy -->
    <wsdl:import namespace="http://ipl.stil.dk/services/optagelsedk/ftuansoegning/v1" location="common-resources/WSPolicy.wsdl"/>

    <!-- Message definitions -->
    <wsdl:message name="PingRequest">
        <wsdl:part name="request" element="tns:Ping"/>
    </wsdl:message>
    <wsdl:message name="PingResponse">
        <wsdl:part name="response" element="tns:PingResponse"/>
    </wsdl:message>
    <wsdl:message name="ServiceException">
        <wsdl:part name="fault" element="tns:ServiceFaultDetailer"/>
    </wsdl:message>

    <wsdl:message name="getAnsoegningIdsByInstitutionNrRequest">
        <wsdl:part name="request" element="tns:getAnsoegningIdsByInstitutionNrRequest"/>
    </wsdl:message>
    <wsdl:message name="getAnsoegningIdsByInstitutionNrResponse">
        <wsdl:part name="response" element="tns:getAnsoegningIdsByInstitutionNrResponse"/>
    </wsdl:message>

    <wsdl:message name="getAnsoegningListByIdsRequest">
        <wsdl:part name="request" element="tns:getAnsoegningListByIdsRequest"/>
    </wsdl:message>
    <wsdl:message name="getAnsoegningListByIdsNrResponse">
        <wsdl:part name="response" element="tns:getAnsoegningListByIdsResponse"/>
    </wsdl:message>

    <wsdl:message name="getURLForBilagRequest">
        <wsdl:part name="request" element="tns:getURLForBilagRequest"/>
    </wsdl:message>
    <wsdl:message name="getURLForBilagResponse">
        <wsdl:part name="response" element="tns:getURLForBilagResponse"/>
    </wsdl:message>

    <wsdl:message name="getURLForAlleBilagRequest">
        <wsdl:part name="request" element="tns:getURLForAlleBilagRequest"/>
    </wsdl:message>
    <wsdl:message name="getURLForAlleBilagResponse">
        <wsdl:part name="response" element="tns:getURLForAlleBilagResponse"/>
    </wsdl:message>

    <!-- Port definitions -->
    <wsdl:portType name="Optagelsedk_ftuAnsoegning_V1_PortType">

        <wsdl:operation name="Ping">
            <wsdl:input message="tns:PingRequest"/>
            <wsdl:output message="tns:PingResponse"/>
            <wsdl:fault name="ServiceException" message="tns:ServiceException"/>
        </wsdl:operation>

        <wsdl:operation name="getAnsoegningIdsByInstitutionNr">
            <wsdl:input message="tns:getAnsoegningIdsByInstitutionNrRequest" wsp:PolicyURIs="#AsymmetricX509TokensWithUntPolicy"/>
            <wsdl:output message="tns:getAnsoegningIdsByInstitutionNrResponse"/>
            <wsdl:fault name="ServiceException" message="tns:ServiceException"/>
        </wsdl:operation>

        <wsdl:operation name="getAnsoegningListByIds">
            <wsdl:input message="tns:getAnsoegningListByIdsRequest" wsp:PolicyURIs="#AsymmetricX509TokensWithUntPolicy"/>
            <wsdl:output message="tns:getAnsoegningListByIdsNrResponse"/>
            <wsdl:fault name="ServiceException" message="tns:ServiceException"/>
        </wsdl:operation>

        <wsdl:operation name="getURLForBilag">
            <wsdl:input message="tns:getURLForBilagRequest" wsp:PolicyURIs="#AsymmetricX509TokensWithUntPolicy"/>
            <wsdl:output message="tns:getURLForBilagResponse"/>
            <wsdl:fault name="ServiceException" message="tns:ServiceException"/>
        </wsdl:operation>

        <wsdl:operation name="getURLForAlleBilag">
            <wsdl:input message="tns:getURLForAlleBilagRequest" wsp:PolicyURIs="#AsymmetricX509TokensWithUntPolicy"/>
            <wsdl:output message="tns:getURLForAlleBilagResponse"/>
            <wsdl:fault name="ServiceException" message="tns:ServiceException"/>
        </wsdl:operation>
    </wsdl:portType>

    <!-- Bindings definitions -->
    <wsdl:binding name="Optagelsedk_ftuAnsoegning_V1_Binding"
                  type="tns:Optagelsedk_ftuAnsoegning_V1_PortType">
        <soap12:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
        <wsdl:operation name="Ping">
            <soap12:operation soapAction="Ping" style="document"/>
            <wsdl:input>
                <soap12:body use="literal"/>
            </wsdl:input>
            <wsdl:output>
                <soap12:body use="literal"/>
            </wsdl:output>
        </wsdl:operation>

        <wsdl:operation name="getAnsoegningIdsByInstitutionNr">
            <soap12:operation soapAction="getAnsoegningIdsByInstitutionNr" style="document"/>
            <wsdl:input>
                <soap12:body use="literal"/>
            </wsdl:input>
            <wsdl:output>
                <soap12:body use="literal"/>
            </wsdl:output>
            <wsdl:fault name="ServiceException">
                <soap12:fault name="ServiceException" use="literal" />
            </wsdl:fault>
        </wsdl:operation>

        <wsdl:operation name="getAnsoegningListByIds">
            <soap12:operation soapAction="getAnsoegningListByIds" style="document"/>
            <wsdl:input>
                <soap12:body use="literal"/>
            </wsdl:input>
            <wsdl:output>
                <soap12:body use="literal"/>
            </wsdl:output>
            <wsdl:fault name="ServiceException">
                <soap12:fault name="ServiceException" use="literal" />
            </wsdl:fault>
        </wsdl:operation>

        <wsdl:operation name="getURLForBilag">
            <soap12:operation soapAction="getURLForBilag" style="document"/>
            <wsdl:input>
                <soap12:body use="literal"/>
            </wsdl:input>
            <wsdl:output>
                <soap12:body use="literal"/>
            </wsdl:output>
            <wsdl:fault name="ServiceException">
                <soap12:fault name="ServiceException" use="literal" />
            </wsdl:fault>
        </wsdl:operation>

        <wsdl:operation name="getURLForAlleBilag">
            <soap12:operation soapAction="getURLForAlleBilag" style="document"/>
            <wsdl:input>
                <soap12:body use="literal"/>
            </wsdl:input>
            <wsdl:output>
                <soap12:body use="literal"/>
            </wsdl:output>
            <wsdl:fault name="ServiceException">
                <soap12:fault name="ServiceException" use="literal" />
            </wsdl:fault>
        </wsdl:operation>

    </wsdl:binding>

    <wsdl:service name="Optagelsedk_ftuAnsoegning_V1">
        <wsdl:port name="Optagelsedk_ftuAnsoegning_V1_Port"
                   binding="tns:Optagelsedk_ftuAnsoegning_V1_Binding">
            <soap12:address
                    location="https://lt.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1"/>
        </wsdl:port>
    </wsdl:service>
</wsdl:definitions>

    Testvejledning og testdata til ny webservice

    For at teste den nye webservice er der oprettet en testvejledning, samt en beskrivelse af tilgængeligt testdata. 
    Se testvejledning og testdata: Hent ansøgninger for en institution


    Mapning af felter mellem ny webservice og felter i nuværende webservice

    I nedenstående tabel er properties fra den nuværende webservice FtuApplicationService og properties fra den nye webservice FtuAnsoegning beskrevet mod hinanden.

    Hvis en property fra den nuværende FtuApplicationService ikke kan findes i tabellen, er det fordi den ikke eksistere i den nye FtuAnsoegning. Nogle felter i kolonnen Property i FtuApplicationService er noteret med Findes ikke, hvilket betyder, at det er en ny indført property som ikke er tilstede i eksisterende webservice. 

    Property i
    FtuAnsoegning (ny)

    Property i
    FtuApplicationService (nuværende)

    Ansoegninger/
    Ansoegning xsi:type=Findes ikke 

    AnsoegningId 

    		FtuApplicationId

    Oprettet 

    		CreatedDate
    Underskrevet Findes ikke

    OpdateretDato 

    		ModifiedDate

    Status 

    		State
    Prioritet PriorityNumber

    AnsoegerUnderskrevet + ForaeldermyndighedEtUnderskrift  + ForaeldermyndighedToUnderskrift 


    UnderskriverCprSignatureName
    UnderskriftTidspunkt SignatureDate

    Ansoeger 


    Cpr

    		CivilRegistrationNumber

    CPR_UUID 

    		Findes ikke

    Navn 

    		PersonGivenName + PersonSurnameName

    Adresse

    		StreetAddress

    Postnummer 

    		postalCode

    By

    		PostalDistrict

    Kommunekode 

    		MunicipalityName

    NavneOgAdresseBeskyttelse

    		IsProtected 
    Email EmailAddress
    Telefon PhoneNumber
    \Ansoeger

    UddannelsesUdbud xsi:type=

    		Findes ikke 

    StudieStart

    		StudyStartDate
    SkoleAarSchoolYear

    EjerInstitution


    Navn InstitutionName
    InstitutionsNrInstitutionNumber

    UndervisningsInstitution 

    		Findes ikke 

    AnsoegningsInstitution 

    		Findes ikke
    CoesaFormaal
    CoesaFormaal CoesaformaalBetegnelseCoesa
    Betegnelse Findes ikke 
    EudGf1UddannelsesUdbud + EudGf2UddannelsesUdbud + EudGfPlusUddannelsesUdbud

    OnlineForloeb 

    		Findes ikke 
    EUXTilbydes Findes ikke
    EUXObligatorisk Findes ikke

    FagRetning 

    		SubjectAreaName   


    InternationalebUddannelsesUdbud
    Hovedomraade MainObjective 
    \UddannelsesUdbud
    ForaeldremyndighedsindehaverBase +  Foraeldremyndighedsindehaver + ForaeldremyndighedsindehaverHarUnderskrevet

    Foraeldremyndighedsindehaver xsi:type= Findes ikke 

    Cpr 

    		CivilRegistrationNumber

    Navn

    		PersonGivenName + PersonSurnameName

    Email 

    		EmailAddress

    Telefon 

    		PhoneNumber

    NavneOgAdresseBeskyttelse 

    		IsProtected
    Bilag

     Id 

    		Findes ikke 
    OriginalFilnavn ApplicantsEnclosureName
    UploadDatoTid Findes ikke
    Filtype Findes ikke
    Type Findes ikke
    FilkildeEnclosureType
    UniktFilnavn EnclosureName
    Ansoegning xsi:type="stx"
    KunstneriskFag1 ArtisticSubject
    FremmedSprog ForeignLanguageSubjec
    Ansoegning xsi:type="ToAarigStx"
    FremmedSprogForeignLanguageSubjec
    StudieretningsFag Category
    Ansoegning xsi:type="EudGf1"+ "EudGf2"
    EuxValgt EUXSelected 
    Ansoegning xsi:type="Hf"
    KunstneriskFag1 ArtisticSubjectAndSportsFirstPriority
    KunstneriskFag2 ArtisticSubjectAndSportsSecondPriority
    Ansoegning xsi:type="Hhx"
    FremmedSprog ForeignLanguageSubject
    \ansoegning

    Spørgsmål og svar


    true
    UI Expand
    expanded
    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 og opdateretDato. OpdateretDato er tidspunktet for den seneste ændring, som har formatet epoch og derfor kan anvendes som versionsnummer på ansøgningen.

    expanded
    UI Expand
    truetitleHvordan 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å ejerinstitutionen.

    Vær opmærksom på, at institutionerne selv angiver hvilken ejerinstitution, der ejer udbuddet. Det gør skolemedarbejderne på Optagelse.dk, hvor de vedligeholder deres udbud.

    Hvis der skal hentes ansøgninger på de enkelte afdelinger, skal du kalde webservicen med ejerinstitutionsnummer og institutionsnummer på den ønskede afdeling (i form af en ansøgningsinsitution).

    Læs mere om de forskellige institutionstyper og se eksempler på kald til webservicen her: Beskrivelse af institutioner

    expanded
    UI Expand
    truetitleHvordan 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.

    true
    UI Expand
    expanded
    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)
      1. Hvis det kald fejler, anbefales det, at hente xml af ansøgningerne
      i ét kald - GetAnsoegningListByIds(int institutionsNr, int[] ansøgningIDs)
      1. én af gangen med GetAnsoegningListByIds(int institutionsNr, int[] ansøgningIDs)
        1. Tilføj ansøgnings-id til en fejlliste, for den/de ansøgninger der fejler i hentningen. STIL bør informeres om, at der er fejl i afhentningen for at kunne afhjælpe problemet.
    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, som ikke tidligere er hentet af SA-systemet. Det kan afgøres ved at tjekke om SA-systemet har et bilag med UniktFilnavn).
        1. Hent bilag fra Filservice - GetURLForBilag(int insitutionsNr, 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
      1. ansøgningen uden fejl, så fjern ansøgning fra fejlliste.
    10. Gem fejllisten til næste indlæsning.
    11. Gem tidspunkt i pkt. 1 som lastRequestTime
    UI Expand
    titleHvordan kontrollerer jeg, at alle ansøgninger er hentet?

    Det er muligt at lavet et kontrolkald via GetAnsoegningIdsByInstitutionsNr(int institutionsNr), uden angivelse af lastRequestTime.

    Kaldet returnerer en liste med alle ansøgningsid'er til institutionen med ansøgningens status.
    Ud fra den liste, kan I kontrollere, at I har fået alle ansøgninger indlæst korrekt. Herunder, at slettede ansøgninger er håndteret korrekt i jeres system.

    UI Expand
    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øv igen. Opleves der forsat problemer skal du kontakte STILs support.

    true
    UI Expand
    expanded
    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.

    true
    UI Expand
    expanded
    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å.

    true
    UI Expand
    expanded
    titleEr ansøgnings-id'er unikke mellem nuværende og nyt Optagelse.dk?

    Det korte svar er nej.

    Der er ingen sammenhæng mellem ansøgnings-id'er i det nuværende Optagelse.dk og det nye Optagelse.dk. Årsagen er, at systemet opbygges forfra.

    Id'erne starter forfra i det nye Optagelse.dk. Derfor bør der være meget lav risiko for, at et SA-system allerede har et ansøgnings-id liggende, som bliver udleveret fra det nye Optagelse.dk.