Dokumentation af optagelse.dk



Relaterede dokumenter
Dokumentation af optagelse.dk

Grænseflade til afhentning af FTU-ansøgninger på Optagelse.dk

Dokumentation af optagelse.dk

Dokumentation af optagelse.dk

ftuapplicationservice _03_27

Grænseflade til afhentning af FTU-ansøgninger fra Optagelse.dk

Grænseflade til afhentning og indberetning af prøvekarakterer i dansk og matematik på Optagelse.dk

Grænseflade til afhentning af grundskoleprøvekarakterer fra Optagelse.dk

Grænseflade til afhentning af FTU-ansøgninger fra Optagelse.dk

18/ VERSION 1.1

UNI Login. Eksport webservice. WS17 v1

ELEKTRONISK INDBERETNING HEPATITIS 18/ VERSION 1.0

UNI Login. Eksport webservice. WS17 v1

Grænseflade til afhentning af oplysninger om

Vejledning til SLS webservice Timebank regnskab

ELEKTRONISK INDBERETNING OPFØLGNING EFTER UDSKRIVNING 14/ VERSION 1.0

21/ VERSION 1.1

Ansøgeren klikker på søg videregående uddannelse

Eksport Portalen. Vejledning til API. Christian Holm 30. June Progressive A/S. Lyskær 3B DK-2730 Herlev Tel

AuthorizationCodeService

Guide til SOAP-servicen i Plandata.dk.

ELEKTRONISK INDBERETNING ABORT 23/ VERSION 1.1

Grænseflade til afhentning af oplysninger om

ELEKTRONISK INDBERETNING IVF VERSION 2 21/ VERSION 1.3

Competencies Webservice

Civilstyrelsen. Lovtidende. Generisk webservice til søgning af afgørelser - Vejledning. Version:

ELEKTRONISK INDBERETNING BØRNEDATABASEN VIA DGWS 13/ VERSION 1.02

31/ VERSION 1.00

Anmodning om begravelse

Grænseflade til afhentning af oplysninger om

Ungebasen. Dokumentation af webservices til udveksling af data mellem Ungebasen og et kommunalt vejledningssystem PUBLICPUBLIC PUBLICPUBLICX

ELEKTRONISK INDBERETNING CANCER 10/ VERSION 1.4

D INTEGRATIONSDESIGN FOR DATAAFTAGERE

ELEKTRONISK INDBERETNING SIB 5/ VERSION 1.21

ELEKTRONISK INDBERETNING INJICERBAR HEROIN 20/ VERSION 1.0

FMK-online's brug af SmartFraming

ELEKTRONISK INDBERETNING ADMIN 24/ VERSION (Bemærk! Denne snitflade omlægges i 2018 til nyt format i forbindelse med SEI2 projektet)

Den Gode Sårjournal Service MedCom, version W 1

Vejledning til afhentning af ansøgninger for ungdomsuddannelser og 10.klasses skoler.

Forløbs publicering. Indledning. Funktionalitet

UNI Login. UNI Login webservice. ws-04

Brugervejledning Optagelse.dk. Afhentning af ansøgninger til de videregående uddannelser

Modtagelse af ansøgninger for institutionsmedarbejdere på videregående uddannelser

Brugervejledning til databrowseren

for institutionsmedarbejdere på ungdomsuddannelser og 10.klasse

Anvenderguide til Stamdatamodulet KOMBIT

Afhentning af ansøgninger til de videregående. Brugervejledning Optagelse.dk

Vejledning. 1 Indledning. 2 Kontakt Webservicen. Webservice til Optagelse.dk

Specifikationsdokument for servicen PID-CPR

Webservice til AMU-indberetning til Datavarehuset

for institutionsmedarbejdere på ungdomsuddannelser og 10.klasse

Webservice til EUD-indberetning til DVH

Kompetencefonde webservice API beskrivelse

Anmodning om begravelse

ITD ecmr WEB Services. Af Allan Wisborg, IT Udvikler

Specifikationsdokument for servicen PID-CPR

ELEKTRONISK INDBERETNING POST 23/ VERSION 1.13

Tredjepart webservices

UNI Login. Licens webservice. ws-03

STS Fejlsituationer. STS Fejlsituationer

for institutionsmedarbejdere på videregående uddannelser

/05/2013 Tilføjet dokumentation af bvn input for GetEngagementDetailed

Den Gode PatoBank Webservice MedCom, version 1.0

Bruger v1.0 QUICK GUIDE. Green Glass Software V/ Dan Feld-Jakobsen Lojovej Aabenraa /

DPR Viderestilling. Grænseflade for klient applikation

Digital post Snitflader Bilag A5 - REST HTTP returkoder Version 6.3

Brugervejledning. Optagelse.dk. Afhentning af ansøgninger for ungdomsuddannelser og skoler med 10. klasse

Indberetning af elev-trivselsdata på erhvervsuddannelserne 2016: Webservice.

SOSI STS Testscenarier

Ændringer Webservice

XML webservice for deklarationsgebyrer. Version 1.0 Final

Bilag til standardaftale om delegering af brugerrettigheder mellem lokale identitetsudbydere og serviceudbydere ved anvendelse af SAML-billetter

Typografidefinition: Typografi1: Skrifttype: 10 pkt, (intet) DKAL Snitflader REST Afhentningssystem

Webservice til upload af produktionstilladelser

Brugervejledning i Optagelse.dk. Afhentning af ansøgninger for ungdomsuddannelser og skoler med 10. klasse

Digital post Snitflader Bilag A2 - REST Register Version 6.3

Webservice til EUD-indberetning til Datavarehuset

1.1 Formål Webservicen gør det muligt for eksterne parter, at fremsøge informationer om elevers fravær.

Grænseflade til indberetning af elev- og medarbejderoplysninger til Elevplan

CENTRAL VEJ- OG STIFORTEGNELSE (CVF)

SKYHOST WEB API VERSION 8 (OFFENTLIGT)

ABM standard arbejdsgruppen nedsat af Statens Arkiver, Biblioteksstyrelsen og Kulturarvsstyrelsen

DKAL Snitflader REST HTTP returkoder

Indholdsfortegnelse. Version Serviceplatformen - opsætningsguide (Eksterne testmiljø) Indledning... 2

Vejledning til Retsinformation web services test stubs

EDH-dokumenter. - på eksterne hjemmesider der ikke hostes af C&B Systemer

SOSIGW. - Administrationskonsol for SOSIGW Indeks

Vejledning til brug af Y s Men s klubintranet administrator guide

Dokumentation af optagelse.dk. Dato Version Udarbejdet af Godkendt af Ændringsbeskrivel se BBJ CLFR Officiel version 1(Release 21)

Version 1.0. Side 1 af 18

Brugervejledning Optagelse.dk. Oprettelse af udbud til de videregående uddannelser

Grænseflade til indberetning af elev- og svendeprøveoplysninger til EASY-P

Bilag WebService LoginModule (BSKAuth)

Webservice til UNI-Login import WS10

XML webservice for pensionsordninger. Version 1.0 Draft A

FESD-standardiseringsgruppen Att: Palle Aagaard IT- og Telestyrelsen IT-strategisk kontor Holsteinsgade København Ø

Vejledning til registrering som bruger til EudraCT results

Kommunale integrationsløsninger i SkoleIntra v/ Ole Windeløv

Rationel VinduesDesigner TM Brugervejledning

Transkript:

ApplicationService Indhold Versionsstyring Introduktion Navn URL Formål Sikkerhed Operationer echo() findftuapplicationids(...) findftuapplicationbyid(...) findftuapplicationpdfbyid(...) findftuapplicationenclosurezipurlbyid(...) findkotapplicationids(...) findkotapplicationbyid(...) findkotapplicationpdfbyid findkotapplicationenclosurezipurlbyid findkotapplicationenclosureurlbyfileid Eksempler Hent FTU-ansøgninger Eksempel på søgning ved hjælp af operationen findftuapplicationids(...): Eksempel på søgning ved hjælp af operationen findftuapplicationbyid(...): Eksempel på søgning ved hjælp af operationen findftuapplicationpdfbyid(...): Eksempel på et udsnit af en XML ftu uddannelses plan med digitale bilag Eksempel på søgning ved hjælp af operationen findftuapplicationenclosurezipurlbyid(...): Hent KOT-ansøgninger Eksempel på søgning ved hjælp af operationen findkotapplicationids(...): Eksempler på søgning ved hjælp af operationerne findkotapplicationbyid(...) : Eksempel på søgning ved hjælp af operationen findkotapplicationbyid(...): Eksempel på søgning ved hjælp af operationen findkotapplicationpdfbyid(...): Eksempel på et udsnit af en XML kot ansøgning med digitale bilag Eksempel på søgning ved hjælp af operationen findkotapplicationenclosurezipurlbyid(...): Eksempel på søgning ved hjælp af operationen findkotapplicationenclosureurlbyfileid(...): Fejlrapportering Versionsstyring Bruges til at skrive betydelige ændringer til dokumentationen Dato Version Udarbejdet af Godkendt af Ændringsbeskrivel se 22-12-2011 1.00 PISK CLFR Officiel version 1(Release 21) Introduktion Side1

Gennemgang af service der henter FTU og KOT-ansøgninger i Optagelse.dk. Navn ApplicationService er implementeret i ApplicationServiceImpl, som findes i modulet security-proxy. URL Tjenesten på Optagelse.dk kan findes via følgende webservice beskrivelse (kræver også login): Test: https://brui.optagelsetest.uni-c.dk/security-proxy/webservice/applicationservice?wsdl Præprod: https://pp.optagelse.dk/security-proxy/webservice/applicationservice?wsdl Produktion:https://www.optagelse.dk/security-proxy/webservice/ApplicationService?wsdl Formål Tjeneste til udlæsning af ansøgninger fra Optagelse.dk. Tjenesten er forsøgt opbygget efter samme mønster som den oprindelige tjeneste i det gamle optagelse.dk, hvor svaret er en tekststreng indeholdende XML. Den største forskel ligger i autentifikationen og opsplitningen mellem KOT og FTU. Sikkerhed Tjenesten er beskyttet af UNI-Login og kræver rollen opt_receiver_applications. I webservice sammenhæng betyder det, at brugernavn og kodeord skal udfyldes som basic authentication i forespørgslens http-header. Derudover kræver adgang til metoderne, at brugeren har ret til at afhente ansøgninger for den angivne institution. En ret som tildeles af institutionens lokale administrator. Operationer Tjenesten består af følgende operationer 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. echo() echo findftuapplicationids findftuapplicationbyid findftuapplicationpdfbyid findftuapplicationenclosureziplinkbyid findkotapplicationids findkotapplicationbyid findkotapplicationpdfbyid findkotapplicationenclosurezipurlbyid findkotapplicationenclosureurlbyfileid Side2

echo operationen er en simpel operation til at afprøve en klient. Den er opsat med samme restriktioner som find* operationerne, men returnerer blot et simpelt svar på en hello parameter. Paramter: hello String* Simpel parameter til test formål * = Krævet felt findftuapplicationids(...) Denne metode fremsøger en liste af FTU-ansøgnings-ID'er. Fremsøgningen foregår primært via institutionsnummer. De returnerede ID'er kan derefter benyttes til at kalde metoden findftuapplicationbyid(...) for at få returneret hver enkelt ansøgning. institutionnumber String* Modtagende institution/postkasse for ansøgningerne. Hvis der også ønskes ansøgninger for underinstitutioner, markeres det med flaget alsosubinstitutions, som beskrevet nedenfor. fromdate Date Hvis sat hentes kun ansøgninger fra og med denne dato og fremad. Må ikke være tom. todate Date Hvis sat hentes kun ansøgninger frem til og med denne dato. Må ikke være tom. educationtype Enum Beskriver den type af uddannelser man kan forespørge efter. Hvis værdien udelades spørges der efter alle typer. Læg mærke til at kun TENTH_GRADE, UPPER_SECONDARY, VOCATIONAL og OTHER_ACTIVITIES værdierne understøttes. onlynew boolean Hvis true så hentes kun ikke allerede afhentede ansøgninger. Standardværdi er false. Side3

alsosubinstitutions boolean Hvis true så hentes også ansøgninger for underinstitutioner. Standardværdi er false. * = Krævet felt findftuapplicationbyid(...) Denne metode fremsøger en FTU-ansøgning på baggrund af et ansøgnings-id og et institutionsnummer. Dette institutionsnummer repræsenterer den institution, der er ved at afhente ansøgninger. Listen af FTU-ansøgnings-ID'er hentes ved at kalde metoden findftuapplicationids(...). institutionnumber String* Modtagende institution for ansøgningerne. ftuapplicationid Integer* Det unikke ID for en FTU-ansøgning * = Krævet felt findftuapplicationpdfbyid(...) Denne metode fremsøger en FTU-ansøgnings-PDF på baggrund af et ansøgnings-id og et institutionsnummer. Dette institutionsnummer repræsenterer den institution, der er ved at afhente ansøgninger. Listen af FTU-ansøgnings-ID'er hentes ved at kalde metoden findftuapplicationids(...). institutionnumber String* Modtagende institution/postkasse for ansøgningerne. ftuapplicationid Integer* Det unikke ID for en FTU-ansøgning * = Krævet felt findftuapplicationenclosurezipurlbyid(...) Denne metode returnerer en url til afhentning af en zip fil med bilagene til en uddannelses plan. Zip filen vil også indeholde selve ansøgning i pdf og xml format. Samtidig vil ansøgningen også blive markeret som afhentet, hvis brugeren (kalderen af denne web service metode) er berettiget til det. institutionnumber String* Modtagende institution/postkasse for ansøgningerne. Side4

ftuapplicationis Integer* Det unikke ID for en FTU-ansøgning Bilagene følger fil formattet <cpr> - <applicantid> - <bid>.pdf og ansøgning <cpr> - <appid>.pdf og <cpr> - <appid>.xml. Endeligt følger zip filen formattet <cpr>-<appid>.zip, hvor cpr: ansøgerens cpr nummer applicantid: ansøgerens id appid: uddanelses plan unikke id (se under 'Eksempel på et udsnit af en XML ftu uddannelses plan med digitale bilag') bid: bilagens unikke id (også benyttet som fil id). For ftu vil applicantid og appid være det samme. Dette vil ikke gælde kot, da ansøgninger betragtes enkeltvis. Eksempel for bilag: 0101759090-123456-654321.pdf. Eksempel for ansøgning: 0101759090-123456.pdf og 0101759090-123456.xml. Eksempel for zip filen: 0101759090-123456.zip. findkotapplicationids(...) Denne metode fremsøger en liste af KOT-ansøgnings-ID'er og tilstande. Fremsøgningen foregår primært via institutionsnummer. De returnerede ID'er kan derefter benyttes til at kalde metoden findkotapplicationbyid(...) eller findkotapplicationpdfbyid(...) for at få returneret hver enkelt ansøgning. institutionnumber String* Modtagende institution for ansøgningerne. Hvis der også ønskes ansøgninger for underinstitutioner, markeres det med flaget alsosubinstitutions, som beskrevet nedenfor. admissionareanumber String Filtrering på KOT-nummer. fromdate Date Hvis sat hentes kun ansøgninger fra og med denne dato og fremad. Må ikke være tom. todate Date Hvis sat hentes kun ansøgninger frem til og med denne dato. Må ikke være tom. onlynew boolean Hvis true så hentes kun ikke allerede afhentede ansøgninger. Standardværdi er false. Side5

alsosubinstitutions boolean Hvis true så hentes også ansøgninger for underinstitutioner. Standardværdi er false. * = Krævet felt findkotapplicationbyid(...) Denne metode fremsøger en KOT-ansøgning i standardformat på baggrund af et ansøgnings-id og et institutionsnummer. Dette institutionsnummer repræsenterer den institution, der er ved at afhente ansøgninger. Listen af KOT-ansøgnings-ID'er hentes ved at kalde metoden findkotapplicationids(...). institutionnumber String* Modtagende institution/postkasse for ansøgningerne. kotapplicationid String* Det unikke ID for en KOT-ansøgning * = Krævet felt findkotapplicationpdfbyid Denne metode fremsøger en KOT-ansøgning i PDF-format på baggrund af et ansøgnings-id og et institutionsnummer. Dette institutionsnummer repræsenterer den institution, der er ved at afhente ansøgninger. Listen af KOT-ansøgnings-ID'er hentes ved at kalde metoden findkotapplicationids(...). institutionnumber String* Modtagende institution/postkasse for ansøgningerne. kotapplicationid String* Det unikke ID for en KOT-ansøgning * = Krævet felt findkotapplicationenclosurezipurlbyid Denne metode returnerer en url til afhentning af en zip fil med bilagene til en ansøgning. Zip filen vil også indeholde selve ansøgning i pdf og xml format. Samtidig vil ansøgningen også blive markeret som afhentet, hvis brugeren (kalderen af denne web service metode) er berettiget til det. Navn Type Besskrivelse institutionnumber String Modtagende institution/postkasse for ansøgningerne. Side6

kotapplicationid String Det unikke ID for en KOT-ansøgning Bilagene følger fil formattet <cpr> - <applicantid> - <bid>.pdf og ansøgning <cpr> - <appid>.pdf og <cpr> - <appid>.xml. Endeligt følger zip filen formattet <cpr>-<appid>.zip, hvor cpr: ansøgerens cpr nummer applicantid: ansøgerens id appid: ansøgnings unikke id. bid: bilagens unikke id (også benyttet som fil id, se under 'Eksempel på et udsnit af en XML kot ansøgning med digitale bilag'). Eksempel for bilag: 0101759090-12340000-654321.pdf. Eksempel for ansøgning: 0101759090-123456.pdf og 0101759090-123456.xml. Eksempel for zip filen: 0101759090-123456.zip. findkotapplicationenclosureurlbyfileid Denne metode returnerer en url til afhentning af en enkelt bilag i pdf format. FileId findes i den XML der hentes via findkotapplicationbyid(...) institutionnumber String Modtagende institution/postkasse for ansøgningerne. kotapplicationid String Det unikke ID for en KOT-ansøgning fileid String Bilagens unikke fil id. Eksempler Hent FTU-ansøgninger For at hente FTU-ansøgninger skal man først hente en liste af FTU-ansøgnings ID'er( findftuapplicationids(...) ) og herefter hentes hver ansøgning på baggrund af et FTU-ansøgnings-ID ( findftuapplicationbyid(...) ). Eksempel på søgning ved hjælp af operationen findftuapplicationids(...): Side7

<soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://optagelse.dk/2009/02/06"> <soapenv:header/> <soapenv:body> <ns:findftuapplicationids> <ns:institutionnumber>101206</ns:institutionnumber> <ns:fromdate>2009-03-30</ns:fromdate> <ns:todate>2010-12-12</ns:todate> <ns:educationtype>upper_secondary</ns:educationtype> <ns:onlynew>false</ns:onlynew> <ns:alsosubinstitutions>true</ns:alsosubinstitutions> </ns:findftuapplicationids> </soapenv:body> </soapenv:envelope> Resultatet: <ns1:findftuapplicationidsresponse xmlns:ns1="http://optagelse.dk/2009/02/06"> <return xmlns="http://optagelse.dk/2009/02/06"> <listofapplicationids>70700</listofapplicationids> <listofapplicationids>93519</listofapplicationids> <listofapplicationids>45323</listofapplicationids> <listofapplicationids>75596</listofapplicationids> <listofapplicationids>89188</listofapplicationids> </ns1:findftuapplicationidsresponse> Eksempel på søgning ved hjælp af operationen findftuapplicationbyid(...): <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://optagelse.dk/2009/02/06"> <soapenv:header/> <soapenv:body> <ns:findftuapplicationbyid> <ns:ftuapplicationid>70700</ns:ftuapplicationid> <ns:institutionnumber>101206</ns:institutionnumber> </ns:findftuapplicationbyid> </soapenv:body> </soapenv:envelope> Format på resultatet: Et svar som enten er en fejlmarkering eller en FTU-ansøgning opbygget efter følgende skema: Side8

<xs:complextype name="applicationservicefindresult"> <xs:sequence> <xs:element minoccurs="0" name="error" type="tns:error"/> <xs:element minoccurs="0" name="ftuapplicantforms" type="xs:string"/> </xs:sequence> </xs:complextype> Operationen returnerer en FTU-ansøgning som tekst indeholdende XML specificeret i XML-skemaet FtuEducationPlanList.xsd. Eksempel på svar fra tjenesten (hvor indmaden er fjernet og erstattet med...) <ns1:findftuapplicationbyidresponse xmlns:ns1="http://optagelse.dk/2009/02/06"> <return xmlns="http://optagelse.dk/2009/02/06"> <ftuapplicantforms> <![CDATA[<?xml version="1.0" encoding="utf-8"?><ftueducationplanlist xmlns="http://rep.oio.dk/uvm.dk/xml/schemas/2005/01/01/"><ftueducationplan xmlns="urn:optagelse.dk:ftu:1.0.0">...</ftueducationplan></ftueducationplanlist>]]> </ftuapplicantforms> </ns1:findftuapplicationbyidresponse> Eksempel på søgning ved hjælp af operationen findftuapplicationpdfbyid(...): <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://optagelse.dk/2009/02/06"> <soapenv:header/> <soapenv:body> <ns:findftuapplicationbyid> <ns:ftuapplicationid>70700</ns:ftuapplicationid> <ns:institutionnumber>101206</ns:institutionnumber> </ns:findftuapplicationbyid> </soapenv:body> </soapenv:envelope> Format på resultatet: Et svar som enten er en fejlmarkering eller FTU-ansøgning som PDF opbygget efter følgende skema: Side9

<xs:complextype name="applicationservicefindresult"> <xs:sequence> <xs:element minoccurs="0" name="error" type="tns:error"/> <xs:element minoccurs="0" name="ftuapplicantpdf" type="xs:base64binary"/> </xs:sequence> </xs:complextype> Operationen returnerer en FTU-ansøgning som Base64 encodede bytes. Eksempel på svar fra tjenesten (hvor indmaden er fjernet og erstattet med...) <ns1:findftuapplicationbyidresponse xmlns:ns1="http://optagelse.dk/2009/02/06"> <return xmlns="http://optagelse.dk/2009/02/06"> <ftuapplicantpdf>jvbe...</ftuapplicantpdf> </ns1:findftuapplicationbyidresponse> Eksempel på et udsnit af en XML ftu uddannelses plan med digitale bilag <EnclosureList> <Enclosure> <EnclosureType>DIGITAL_FILE</EnclosureType> <EnclosureName>0312750000-12859698-12859708.pdf</EnclosureName> <ApplicantsEnclosureName>bilag1</ApplicantsEnclosureName> <UploadDate>2011-11-29</UploadDate> </Enclosure> <Enclosure> <EnclosureType>DIGITAL_FILE</EnclosureType> <EnclosureName>0312750000-12859698-12859713.pdf</EnclosureName> <ApplicantsEnclosureName>bilag2</ApplicantsEnclosureName> <UploadDate>2011-11-29</UploadDate> </Enclosure> </EnclosureList> Eksempel på søgning ved hjælp af operationen findftuapplicationenclosurezipurlbyid(...): Side10

<soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://optagelse.dk/2009/02/06"> <soapenv:header/> <soapenv:body> <ns:findftuapplicationenclosurezipurlbyid> <ns:ftuapplicationid>12839234</ns:ftuapplicationid> <ns:institutionnumber>157027</ns:institutionnumber> </ns:findftuapplicationenclosurezipurlbyid> </soapenv:body> </soapenv:envelope> Resultat: <findftuapplicationenclosurezipurlbyidresponse xmlns="http://optagelse.dk/2009/02/06"> <return> <fileurl>http://localhost/file-upload-service/services/fileservice/file?token=cbb199 69-a5e3-4094-9ca9-8fa7d28895ac</fileURL> </findftuapplicationenclosurezipurlbyidresponse> Hent KOT-ansøgninger For at hente KOTansøgninger skal man først hente en liste af KOT-ansøgnings-ID'er( findkotapplicationids(...) ) og herefter hentes hver ansøgning på baggrund af et KOT-ansøgnings-ID ( findkotapplicationbyid(...) ). Eksempel på søgning ved hjælp af operationen findkotapplicationids(...): <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://optagelse.dk/2009/02/06"> <soapenv:header/> <soapenv:body> <ns:findkotapplicationids> <ns:institutionnumber>147406</ns:institutionnumber> <ns:admissionareanumber></ns:admissionareanumber> <ns:onlynew>false</ns:onlynew> <ns:alsosubinstitutions>true</ns:alsosubinstitutions> </ns:findkotapplicationids> </soapenv:body> </soapenv:envelope> Resultatet: Side11

<ns1:findkotapplicationidsresponse xmlns:ns1="http://optagelse.dk/2009/02/06"> <return xmlns="http://optagelse.dk/2009/02/06"> <listofapplicationidandstates> <id>85375#262578</id> <state>original</state> </listofapplicationidandstates> <listofapplicationidandstates> <id>12833288#12833292</id> <state>updated</state> </listofapplicationidandstates> <listofapplicationidandstates> <id>77077#244838</id> <state>enclosure_updated</state> </listofapplicationidandstates> <listofapplicationidandstates> <id>94065#285232</id> <state>original</state> </listofapplicationidandstates> </ns1:findkotapplicationidsresponse> Eksempler på søgning ved hjælp af operationerne findkotapplicationbyid(...) : Format på resultatet: Et svar som enten er en fejlmarkering eller en KOT-ansøgning opbygget efter følgende skema: <xs:complextype name="applicationservicefindresult"> <xs:sequence> <xs:element minoccurs="0" name="error" type="tns:error"/> <xs:element minoccurs="0" name="kotapplicantforms" type="xs:string"/> </xs:sequence> </xs:complextype> Eksempel på søgning ved hjælp af operationen findkotapplicationbyid(...): Operationen returnerer en KOT-ansøgning som tekst indeholdende XML specificeret i XML-skemaet ApplicantForms.xsd Eksempel på svar fra tjenesten (hvor indmaden er fjernet og erstattet med...) Side12

<ns1:findkotapplicationbyidresponse xmlns:ns1="http://optagelse.dk/2009/02/06"> <return xmlns="http://optagelse.dk/2009/02/06"> <kotapplicantforms> <![CDATA[<?xml version="1.0" encoding="utf-8"?> <ApplicantForms> <ns1:applicantformwrapper> <ns1:applicantform xmlns="http://rep.oio.dk/uvm.dk/xml/schemas/2004/03/11/">...</ns1:applicantform> <ns1:outfetch>...</ns1:outfetch> </ns1:applicantformwrapper> </ApplicantForms>]]> </kotapplicantforms> </ns1:findkotapplicationbyidresponse> I svaret ovenfor er data indkapslet med CDATA tags, men det er afhængig af klienten, man laver forespørgslen med. Med en helt rå http forespørgsel ser data således ud: <kotapplicantforms><?xml version="1.0" encoding="utf-8"?> <ApplicantForms xmlns="http://rep.oio.dk/uvm.dk/xml/schemas/2004/03/11/"><applicantf ormwrapper><... Eksempel på søgning ved hjælp af operationen findkotapplicationpdfbyid(...): <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://optagelse.dk/2009/02/06"> <soapenv:header/> <soapenv:body> <ns:findkotapplicationpdfbyid> <ns:kotapplicationid>43714#1</ns:kotapplicationid> <ns:institutionnumber>751470</ns:institutionnumber> </ns:findkotapplicationpdfbyid> </soapenv:body> </soapenv:envelope> Format på resultatet: Et svar som enten er en fejlmarkering eller KOT-ansøgning som PDF opbygget efter følgende skema: Side13

<xs:complextype name="applicationservicefindresult"> <xs:sequence> <xs:element minoccurs="0" name="error" type="tns:error"/> <xs:element minoccurs="0" name="kotapplicantpdf" type="xs:base64binary"/> </xs:sequence> </xs:complextype> Operationen returnerer en KOT-ansøgning som Base64 encodede bytes. Eksempel på svar fra tjenesten (hvor indmaden er fjernet og erstattet med...) <ns1:findkotapplicationpdfbyidresponse xmlns:ns1="http://optagelse.dk/2009/02/06"> <return xmlns="http://optagelse.dk/2009/02/06"> <kotapplicantpdf>jvberi0xljcnj...</kotapplicantpdf> </ns1:findkotapplicationpdfbyidresponse> Eksempel på et udsnit af en XML kot ansøgning med digitale bilag <EnclosureList> <Enclosure> <EnclosureType>DIGITAL_FILE</EnclosureType> <FileId>12729566</FileId> <EnclosureName>0312750000-12729545-12729566.pdf</EnclosureName> <ApplicantsEnclosureName>bilag1</ApplicantsEnclosureName> <UploadDate>2011-11-28</UploadDate> </Enclosure> <Enclosure> <EnclosureType>DIGITAL_FILE</EnclosureType> <FileId>12729567</FileId> <EnclosureName>0312750000-12729545-12729567.pdf</EnclosureName> <ApplicantsEnclosureName>bilag2</ApplicantsEnclosureName> <UploadDate>2011-11-28</UploadDate> </Enclosure> </EnclosureList> Eksempel på søgning ved hjælp af operationen findkotapplicationenclosurezipurlbyid(...): Side14

<soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://optagelse.dk/2009/02/06"> <soapenv:header/> <soapenv:body> <ns:findkotapplicationenclosurezipurlbyid> <ns:kotapplicationid>12839628#12839632</ns:kotapplicationid> <ns:institutionnumber>101604</ns:institutionnumber> </ns:findkotapplicationenclosurezipurlbyid> </soapenv:body> </soapenv:envelope> Resultat: <findkotapplicationenclosurezipurlbyidresponse xmlns="http://optagelse.dk/2009/02/06"> <return> <fileurl>http://localhost/file-upload-service/services/fileservice/file?token=71b8bf ba-0a8b-4bad-870c-60f008cff064</fileurl> </findkotapplicationenclosurezipurlbyidresponse> Eksempel på søgning ved hjælp af operationen findkotapplicationenclosureurlbyfileid(...): <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://optagelse.dk/2009/02/06"> <soapenv:header/> <soapenv:body> <ns:findkotapplicationenclosureurlbyfileid> <ns:kotapplicationid>12839628#12839632</ns:kotapplicationid> <ns:institutionnumber>101604</ns:institutionnumber> <ns:fileid>121212</ns:fileid> </ns:findkotapplicationenclosureurlbyfileid> </soapenv:body> </soapenv:envelope> Resultat: Side15

<ApplicationServiceDownloadFileURLResult xmlns="http://optagelse.dk/2009/02/06"> <return> <fileurl>http://localhost/file-upload-service/services/fileservice/file?token=71b8bf ba-0a8b-4bad-870c-60f008cff064</fileurl> </findkotapplicationenclosurezipurlbyidresponse> Fejlrapportering Ved fejlsituationer returneres fejlelement efter følgende skema: <xs:complextype final="extension restriction" name="error"> <xs:sequence> <xs:element minoccurs="0" name="code" type="xs:string"/> <xs:element minoccurs="0" name="text" type="xs:string"/> </xs:sequence> </xs:complextype> Code NO_DATA INVALID_INPUT ILLEGAL_ACCESS INSTITUTION_NOT_FOUND SYSTEM_ERR Beskrivelse Hvis søgningen intet finder Hvis input data ikke er gyldigt Hvis authentifikation eller autorisationen ikke lykkes. Dette er ekstra kontrol som foretages efter UNI-Login. Denne fejl angiver, at brugeren enten ikke har den korrekte rolle eller ikke har adgang til at afhente den angivne institutions ansøgninger. Det angivne institutionsnummer matcher ikke institution i Optagelse.dk Fejl i tjenesten Side16