Grænseflade til afhentning af oplysninger om

Transkript

1 Grænseflade til afhentning af oplysninger om praktikforhold fra EASY-P Dato Version Status 1.4 Gældende fra og med den 1. december 2018 Ansvarlig Lars Ingesman

2 Side 2 af 25 Ændringshistorik Version Kapitel/afsnit Beskrivelse Dato/Init 1.1 Generelt Beskrivelser af indberetningsstruktur og web-service samlet i én grænsefladebeskrivelse. 4 Praktikforholdsoplysninger tilføjet. 5 Webservice ændret som konsekvens af tilføjede praktikforholdsoplysninger. 1.2 Afsnit 4 Lærestedsoplysninger (navn, adresse m.m.) er tilføjet til praktikforholdsoplysninger: Tilføjet i figur 3 i afsnit 4.1 Tilføjet i tabel 1 i afsnit 4.1. Afsnit 4 Tabel 1 opdateret med præcise feltdefinitioner svarende til XSD-fil , BJ , BJ Bilag 3 Tilføjet bilag med XSD for response , BJ Afsnit 4 Bilag 3 Følgende datoer er ændret til krævede felter: PeriodeStart PeriodeSlut PauseFra Opdateret i figur 3 og 4 samt i bilag Afsnit 4 Tekst opdateret, så den afspejler, at man kan hente data på basis af P-nummer , BJ , LI Afsnit 4 Figur 2: opdateret ift. ny XSD , LI Afsnit 4.1 Tabel 1: praktikinformationer opdateret , LI Afsnit 5 Links til webservice opdateret , LI Bilag 2 Opdateret med ændret XSD , LI Bilag 3 Opdateret med ændret XSD , LI Bilag 4, 5 og 6 Opdaterede eksempler på soapforespørgsler og -svar , LI

3 Side 3 af 25 Indhold 1 Indledning Hvem kan hente data? Hvad er omfattet? Hvilke oplysninger kan hentes? Praktikforhold_Resultat Pauser Fejlhåndtering Webservicen Operation/metode Udviklingsværktøjer Bilag 1. Eksempel på valide XML-response data for forespørgsel på CPR-nummer Bilag 2. XSD for ParameterList Bilag 3. XSD for Praktikforhold_Resultat Bilag 4. Eksempel på soap request Bilag 5. Eksempel på soap response Bilag 6. Eksempel på soap error response

4 Side 4 af 25 1 Indledning Dette dokument beskriver strukturen for de oplysninger om praktikforhold, som kan hentes i EASY-P til studieadministrative systemer og øvrige interessenter, og webservicen til afhentning af oplysninger vedrørende praktikforhold i EASY-P (herefter Webservicen) via eksempler. Webservicen er udviklet af KMD for Styrelsen for It og Læring. Der er tale om en system til system -integration. Det betyder i praksis, at EASY-P tilbyder og udstiller en række oplysninger ved hjælp af kald af Webservicen i EASY-P. Afhentning af oplysninger kan ske efter behov og efter forudgående aftale mellem institutionen og STIL (EASY-P) om adgang til Webservicen. 2 Hvem kan hente data? Institutioner og andre interessenter omfattet af ovenstående aftaler. 3 Hvad er omfattet? Udtrækket omfatter alle uddannelsesaftaler samt al skolepraktik og praktik i udlandet (PiU), der er registreret på et angivet personnummer, eller alle de uddannelsesaftaler, der er indgået med en angivet produktionsenhed. Aftaler, skolepraktik og PiU, som fysisk er slettet fra EASY-P, er ikke omfattet af udtrækket. 4 Hvilke oplysninger kan hentes? Der kan via angivelse af en elevs personnummer eller en virksomheds produktionsenhedsnummer hentes oplysninger om en eller flere uddannelsesaftaler, bl.a. modtaget dato, registreringsdato, periode, uddannelse, afslutningsårsag, aftaletyper, men også andre praktikrelevante registreringer, herunder om der er registeret eventuelle pauser i praktikperioden. Dette er illustreret i Figur 1: Figur 1. Skitse af informationsstruktur. Praktikforhold_Resultat Pauser I nedenstående Figur 2 er det samlede, overordnede XML-skema vist. Elementet Praktikforhold_Resultat og underelementet Pauser med tilhørende relevante udsnit af skemaet gennemgås i afsnit 4.1 og 4.2. Datoer er altid i følgende format: åååå-mm-dd.

5 Figur 2. Overordnet XML-skema Side 5 af 25

6 Side 6 af Praktikforhold_Resultat Dette element indeholder oplysninger om praktikforhold inkl. uddannelsesaftaler for den angivne elev eller produktionsenhed. Der er kun en lille forskel i det returnerede resultat, afhængig af om man spørger på CPR-nummer eller P-nummer: hvis man spørger på produktionsenheders aftaler, får man ikke CPR-numre med i resultatet. Alle andre data er identiske. Tabel 1. Praktikinformationer Felt Beskrivelse Felttype AftaleIdGlobal Entydigt id for uddannelsesaftalen Tekst, 10 Akpa PraktikType CPRNummer Praktikforholdets status Aktiv eller Passiv (A/P) Typen af praktikforholdet: A = Aftale på praktiksted S = Skolepraktik P = Praktik i udlandet Elevens CPR-nummer uden adskillelses NB: CPR-nummeret udelades, hvis man spørger på aftaler under produktionsenheder, dvs. angiver et P-nummer som parameter Tekst, 1 Tekst, 1 Tekst, 10 Uddannelse CØSA-formål for praktikforholdet Tekst, 4 Version Version af uddannelsen for praktikforholdet Tekst, 4 UddBeelse Versionsbeelse Tekst, 50 Speciale Speciale for praktikforholdet Tekst, 2 SpecialeBeelse Beskrivelse for Speciale Tekst, 50 GodkId Praktikforholdets godkendelses interne nøgle Tal, 10 OblAftaletype Obligatorisk aftaletype Se bilag 3 Aftaletyper for eksempler Tekst, 4 OblAftTypeTekst Beelse for den obligatoriske aftaletype Tekst, 50 SupplAftaletype1 1. supplerende aftaletype Tekst, 4 SupplAftType1Tekst Beelse for den 1. supplerende aftaletype Tekst, 50 SupplAftaletype2 2. supplerende aftaletype Tekst, 4

7 Side 7 af 25 Felt Beskrivelse Felttype SupplAftType2Tekst Beelse for den 2. supplerende aftaletype Tekst, 50 SupplAftaletype3 3. supplerende aftaletype Tekst, 4 SupplAftType3Tekst Beelse for den 3. supplerende aftaletype Tekst, 50 SupplAftaletype4 4. supplerende aftaletype Tekst, 4 SupplAftType4Tekst Beelse for den 4. supplerende aftaletype Tekst, 50 SupplAftaletype5 5. supplerende aftaletype Tekst, 4 SupplAftType5Tekst Beelse for den 5. supplerende aftaletype Tekst, 50 Adgangsvej Elevens adgangsvej Tekst, 2 AdgangsvejBeelse Beskrivelse af adgangsvej Tekst, 50 Elevtype Elevens elevtype i aftaleperioden Tekst, 10 ElevtypeBeelse Beskrivelse af elevtype Tekst, 50 ArrangerendeSkole ArrangerendeSkole- Easy ArrangerendeSkole- Navn ArkivSkole ArkivSkoleEasy ArkivSkoleNavn DS-nummer for elevens arrangerende skole (den skole, der har ansvaret for eleven) EASY-nummer for elevens arrangerende skole (den skole, der har ansvaret for eleven) Navn på elevens arrangerende skole (den skole, der har ansvaret for eleven) DS-nummer for arkivskolen (den skole, der har aftalen i arkivet) EASY-nummer for arkivskolen (den skole, der har aftalen i arkivet) Navn på arkivskolen (den skole, der har aftalen i arkivet) Tekst, 10 Tekst, 4 Tekst, 50 Tekst, 10 Tekst, 4 Tekst, 50 Modtaget Dato for, hvornår aftalen er modtaget på skolen Dato PeriodeStart Startdato for praktikforholdet Dato PeriodeSlut Slutdato for praktikforholdet Dato Underskrevet Underskriftdato Dato Faerdigregistreret Færdigregistreringsdato Dato ForventetUdlaert Forventet udlært-dato Dato FormodetAfbrudt Formodet afbrudt-dato Dato AnsoegtFU Dato for ansøgt fagligt udvalg Dato

8 Side 8 af 25 Felt Beskrivelse Felttype SvarFU Svar fra fagligt udvalg deres dato Dato FagligtUdvalg Fagligt Udvalg Tekst, 2 FagligtUdvalgNavn Navn på Fagligt Udvalg Tekst, 100 Afslutningsaarsag Afslutningsårsag Tekst, 4 Afslutningstekst Afslutningstekst Tekst, 50 CvrNummer CVR-nummer for praktikstedet Tekst, 8 LoenNummer LaerestedLbnr Det SE-nummer, som der skal afregnes AUB på for pågældende aftale Løbenummer under CVR-nummer på det lærested, som aftalen er tilknyttet Tekst, 8 Tal 4 cifre PNummer Produktionsenhedsnummer for praktikstedet Tal, 10 cifre LstedId Praktikforholdets godkendelses læresteds interne nøgle Tal, 10 cifre LstedNavn Godkendelseslærestedets navn Tekst, 50 LstedAdresse Godkendelseslærestedets adresse (gade) Tekst, 50 LstedSted Godkendelseslærestedets stednavn Tekst, 50 LstedPostnr Godkendelseslærestedets postnummer Tekst, 4 LstedBy Godkendelseslærestedets bynavn Tekst, 50 Lsted Godkendelseslærestedets -adresse Tekst, 50 PraktikCenter DS-nummer for praktikcenter Tekst, 10 PraktikCenterEasy EASY-nummer for praktikcenter Tekst, 4 PraktikCenterNavn Navn på praktikcenter Tekst, 50 DsAfdPraktikCenter Evt. DS-afdelingsnummer for udlagt skole Tekst, 6 DsAfdPraktikCenter- Navn Evt. navn på udlagt skole Tekst, 50 UdlagtSkole DS-nummer for evt. udlagt skole Tekst, 10

9 Side 9 af 25 Felt Beskrivelse Felttype UdlagtSkoleEasy EASY-nummer for evt. udlagt skole Tekst, 4 UdlagtSkoleNavn Navn på evt. udlagt skole Tekst, 50 DsAfdUdlagtSkole Evt. DS-afdelingsnummer for udlagt skole Tekst, 6 DsAfdUdlagtSkoleNavn Evt. navn på udlagt skole Tegn, 50 LandeKode Landekode for praktik i udlandet (PiU) Tekst, 4 LandBeelse Landebeelse for praktik i udlandet (PiU) Tekst, 50 PiUSkole DS-nummer for evt. PiU-skole Tekst, 10 PiUSkoleEasy EASY-nummer for evt. PiU-skole Tekst, 4 PiUSkoleNavn Evt. navn på PiU-skole Tekst, 50 DsAfdPiUSkole Evt. DS-afdelingsnummer for PiU-skole Tekst, 6 DsAfdPiUSkoleNavn Evt. navn på PiU-skole Tekst, 50 DigUddAftReference Aftalens referencenummer som digital uddannelsesaftale SenestAendretDato Dato for seneste ændring af praktikforholdet Dato SenestAendretSkole Evt. DS-nummer for seneste ændring af praktikforholdet SenestAendretSkole- Easy SenestAendretSkole- Navn SenestAendretInit Tal Tekst, 10 Evt. EASY-skolenummer for seneste ændring Tekst, 4 Evt. navn for seneste ændring af praktikforholdet Evt. initialer for seneste ændring af praktikforholdet Tekst, 50 Tekst, Pauser Her er indeholdt eventuelle pauser i praktikperioden.

10 Side 10 af 25 Figur 3. Pause. Tabel 1. Pause Felt Beskrivelse Felttype PauseFra Startdato for pause Dato PauseTil Slutdato for pause Dato Bemaerkning Evt. bemærkning til pause Tekst, Fejlhåndtering Hvis der opstår en fejl ved afhentning af Praktikforhold, vil der blive returneret en fejlmeddelelse. Ellers returneres Errorcode = 0 og Errortext = OK. Figur 4. Fejl (Error) Tabel 2. Fejl (Error). Felt Beskrivelse Felttype Errorcode Fejlnummer Tekst 50 Errortext Beskrivelse af fejl Tekst 500 Eksempler på fejlbeskeder er beskrevet i nedenstående tabel. Tabel 3. Fejlmeddelelser. Fejlkode Tekst på fejl WS_136 CPR nummeret er ikke validt c43 WS_137 CPR-nummer findes ikke i EASY-P WS_184 PNUMMER findes ikke i EASYP

11 Side 11 af 25 5 Webservicen Web servicen kan findes via følgende links: Test: Produktion: Servicen ligger bag firewall og er beskyttet af login. Brugernavn og kodeord, samt åbning i firewall kan tildeles ved henvendelse til STIL's support. 5.1 Operation/metode Tjenesten består operationen/metoden WSCallEasyA. Denne operation/metode er den korrekte måde at hente XML-data fra EASY-P praktikaftaler på. Tabel 4. Parametre. Felt Beskrivelse Felttype Lovlige værdier Obligatorisk modulnummer Nummeret på modulet Tekst P006 Ja Ja dsnr Institionsnummeret Tal, 6 cifre ParameterList XML indeholdende data Tekst Ja Nej Version Version på service Tal, 2 cifre adgangskode Den tildelte adgangskode for institutionen Tekst, 50 Ja Nøglefelt Nej 1 Ja Nej Ja Nej 6 Udviklingsværktøjer Webservicen er udviklet i PL/SQL og kan umiddelbart tilgås i web-browser ved at tilføje WSDL som service reference. Følgende gratis udviklingsværktøjer kan anbefales til test og debugging: soupui ( kan bl.a. oprette soap requests, der kan sendes mod webservicen. Fiddler ( analyserer webservicekald og -svar. Bilag 3, 4 og 5 er eksempler på hhv. soap request, tilhørende soap response og tilhørende soap error response, når XML-data i bilag 1 anvendes.

12 Side 12 af 25 Bilag 1. Eksempel på valide XML-response data for forespørgsel på CPR-nummer. <?xml version="1.0" encoding="utf-8"?> <Result> <TimeStamp> T14:45:41</TimeStamp> <DSNumber>999878</DSNumber> <ParameterList> <CPRNummer>070687XXXX</CPRNummer> </ParameterList> <Praktikforhold_Result> <Praktikforhold> <AftaleIdGlobal>123</AftaleIdGlobal> <PraktikType>str1234</PraktikType> <CPRNummer>070687XXXX</CPRNummer> <Uddannelse>1139</Uddannelse> <Version>3</Version> <UddBeelse> Tekstil- og beklædningsteknikeruddannelsen</uddbeelse> <Speciale>12</Speciale> <SpecialeBeelse>Konfektionstekniker</SpecialeBeelse> <OblAftaletype>1002</OblAftaletype> <OblAftTypeTekst>str1234</OblAftTypeTekst> <SupplAftaletype1>1016</SupplAftaletype1> <SupplAftType1Tekst>str1234</SupplAftType1Tekst> <SupplAftaletype2>1017</SupplAftaletype2> <SupplAftType2Tekst>str1234</SupplAftType2Tekst> <SupplAftaletype3>1018</SupplAftaletype3> <SupplAftType3Tekst>str1234</SupplAftType3Tekst> <SupplAftaletype4>1019</SupplAftaletype4> <SupplAftType4Tekst>str1234</SupplAftType4Tekst> <SupplAftaletype5>1021</SupplAftaletype5> <SupplAftType5Tekst>str1234</SupplAftType5Tekst> <Adgangsvej>SP</Adgangsvej> <AdgangsvejBeel-se>Specialundervisning</AdgangsvejBeelse> <Elevtype>ELTY_1</Elevtype> <ElevtypeBeelse>BETEG_ELTY_1</ElevtypeBeelse> <ArrangerendeSkole>123</ArrangerendeSkole> <ArkivSkole>123</ArkivSkole> <Modtaget> </Modtaget> <PeriodeStart> </PeriodeStart> <PeriodeSlut> </PeriodeSlut> <Underskrevet> </Underskrevet> <Faerdigregistreret> </Faerdigregistreret> <ForventetUdlaert> </ForventetUdlaert> <FormodetAfbrudt> </FormodetAfbrudt> <AnsoegtFU> </AnsoegtFU> <SvarFU> </SvarFU> <Afslutningsaarsag>12</Afslutningsaarsag> <Afslutningstekst>str1234</Afslutningstekst> <CvrNummer>123</CvrNummer> <PNummer>123</PNummer> <PraktikCenter>123</PraktikCenter> <DsAfdPraktikCenter>123</DsAfdPraktikCenter> <UdlagtSkole>123</UdlagtSkole> <DsAfdUdlagtSkole>123</DsAfdUdlagtSkole> <LandeKode>878</LandeKode> <LandBeelse>str1234</LandBeelse> <PiUSkole>str1234</PiUSkole> <DsAfdPiUSkole>str1234</DsAfdPiUSkole> <SenestAendretDato> </SenestAendretDato> <SenestAendretDSNummer>751401</SenestAendretDSNummer> <SenestAendretEasyNr>401</SenestAendretEasyNr> <SenestAendretDSNavn>AARHUS TECH</SenestAendretDSNavn> <SenestAendretInit>AKO</SenestAendretInit> <Pauser> <PauseFra> </PauseFra> <PauseTil> </PauseTil> <Bemaerkning>str1234</Bemaerkning> </Pauser> <Pauser> <PauseFra> </PauseFra> <PauseTil> </PauseTil> <Bemaerkning>str1234</Bemaerkning> </Pauser>

13 Side 13 af 25 </Praktikforhold> <Praktikforhold> <AftaleIdGlobal>1234</AftaleIdGlobal> <PraktikType>str1234</PraktikType> <CPRNummer>070687XXXX</CPRNummer> <Uddannelse>1139</Uddannelse> <Version>3</Version> <UddBeelse>Tekstil- og beklædningsteknikeruddannel-sen</uddbeelse> <Speciale>3</Speciale> <SpecialeBeelse>Konfektionstekniker</SpecialeBeelse> <OblAftaletype>1002</OblAftaletype> <OblAftTypeTekst>str1234</OblAftTypeTekst> <SupplAftaletype1>1016</SupplAftaletype1> <SupplAftType1Tekst>str1234</SupplAftType1Tekst> <SupplAftaletype2>1017</SupplAftaletype2> <SupplAftType2Tekst>str1234</SupplAftType2Tekst> <SupplAftaletype3>1018</SupplAftaletype3> <SupplAftType3Tekst>str1234</SupplAftType3Tekst> <SupplAftaletype4>1019</SupplAftaletype4> <SupplAftType4Tekst>str1234</SupplAftType4Tekst> <SupplAftaletype5>1021</SupplAftaletype5> <SupplAftType5Tekst>str1234</SupplAftType5Tekst> <Adgangsvej>SP</Adgangsvej> <AdgangsvejBeel-se>Specialundervisning</AdgangsvejBeelse> <Elevtype>ELTY_1</Elevtype> <ElevtypeBeelse>BETEG_ELTY_1</ElevtypeBeelse> <ArrangerendeSkole>123</ArrangerendeSkole> <ArkivSkole>123</ArkivSkole> <Modtaget> </Modtaget> <PeriodeStart> </PeriodeStart> <PeriodeSlut> </PeriodeSlut> <Underskrevet> </Underskrevet> <Faerdigregistreret> </Faerdigregistreret> <ForventetUdlaert> </ForventetUdlaert> <FormodetAfbrudt> </FormodetAfbrudt> <AnsoegtFU> </AnsoegtFU> <SvarFU> </SvarFU> <Afslutningsaarsag>12</Afslutningsaarsag> <Afslutningstekst>str1234</Afslutningstekst> <AfslAarsagTIlfoejelse>str1234</AfslAarsagTIlfoejelse> <CvrNummer>123</CvrNummer> <PNummer>123</PNummer> <PraktikCenter>123</PraktikCenter> <DsAfdPraktikCenter>123</DsAfdPraktikCenter> <UdlagtSkole>123</UdlagtSkole> <DsAfdUdlagtSkole>123</DsAfdUdlagtSkole> <LandeKode>878</LandeKode> <LandBeelse>str1234</LandBeelse> <PiUSkole>str1234</PiUSkole> <DsAfdPiUSkole>str1234</DsAfdPiUSkole> <SenestAendretDato> </SenestAendretDato> <SenestAendretDSNummer>751401</SenestAendretDSNummer> <SenestAendretEasyNr>401</SenestAendretEasyNr> <SenestAendretDSNavn>AARHUS TECH</SenestAendretDSNavn> <SenestAendretInit>AKO</SenestAendretInit> <Pauser> <PauseFra> </PauseFra> <PauseTil> </PauseTil> <Bemaerkning>str1234</Bemaerkning> </Pauser> <Pauser> <PauseFra> </PauseFra> <PauseTil> </PauseTil> <Bemaerkning>str1234</Bemaerkning> </Pauser> </Praktikforhold> </Praktikforhold_Result> </Result>

14 Side 14 af 25 Bilag 2. XSD for ParameterList. <xs:schema xmlns:xs=" <xs:complextype name="parameterlisttype"> <xs:sequence> <xs:choice> <xs:element name="cprnummer" type="xs:string" /> <xs:element name="pnummer" type="xs:string" /> </xs:choice> </xs:sequence> </xs:complextype> </xs:schema> Bilag 3. XSD for Praktikforhold_Resultat. <xs:complextype name="p006resulttype"> <xs:sequence> <xs:element name="praktikforhold_resultat" minoccurs="0" maxoccurs="unbounded"> <xs:complextype> <xs:sequence> <xs:element name="aftaleidglobal" minoccurs="1" <xs:maxlength value="10" /> <xs:minlength value="1" /> <xs:element name="akpa" minoccurs="1" <xs:maxlength value="1" /> <xs:minlength value="1" /> <xs:element name="praktiktype" minoccurs="1" <xs:minlength value="1" /> <xs:maxlength value="1" /> <xs:element name="cprnummer" minoccurs="0" <xs:minlength value="10" /> <xs:maxlength value="10" /> <xs:element name="uddannelse" minoccurs="1" <xs:minlength value="1" /> <xs:element name="version" minoccurs="1" <xs:element name="uddbeelse" minoccurs="1"

15 <xs:minlength value="1" /> <xs:element name="speciale" minoccurs="0" <xs:maxlength value="2" /> <xs:element name="specialebeelse" minoccurs="0" <xs:element name="godkid" minoccurs="0" <xs:restriction base="xs:int"> <xs:totaldigits value="10" /> <xs:element name="oblaftaletype" minoccurs="1" <xs:element name="oblafttypetekst" minoccurs="1" <xs:element name="supplaftaletype1" minoccurs="0" <xs:element name="supplafttype1tekst" minoccurs="0" <xs:element name="supplaftaletype2" minoccurs="0" <xs:element name="supplafttype2tekst" minoccurs="0" Side 15 af 25

16 <xs:element name="supplaftaletype3" minoccurs="0" <xs:element name="supplafttype3tekst" minoccurs="0" <xs:element name="supplaftaletype4" minoccurs="0" <xs:element name="supplafttype4tekst" minoccurs="0" <xs:element name="supplaftaletype5" minoccurs="0" <xs:element name="supplafttype5tekst" minoccurs="0" <xs:element name="adgangsvej" minoccurs="0" <xs:maxlength value="2" /> <xs:element name="adgangsvejbeelse" minoccurs="0" <xs:element name="elevtype" minoccurs="0" <xs:maxlength value="10" /> <xs:element name="elevtypebeelse" minoccurs="0" Side 16 af 25

17 <xs:element name="arrangerendeskole" minoccurs="1" <xs:maxlength value="10" /> <xs:element name="arrangerendeskoleeasy" minoccurs="1" <xs:element name="arrangerendeskolenavn" minoccurs="1" <xs:element name="arkivskole" minoccurs="0" <xs:maxlength value="10" /> <xs:element name="arkivskoleeasy" minoccurs="0" <xs:element name="arkivskolenavn" minoccurs="0" <xs:element name="modtaget" type="xs:date" minoccurs="0" maxoccurs="1" /> <xs:element name="periodestart" type="xs:date" maxoccurs="1" /> <xs:element name="periodeslut" type="xs:date" maxoccurs="1" /> <xs:element name="underskrevet" type="xs:date" minoccurs="0" maxoccurs="1" /> <xs:element name="faerdigregistreret" type="xs:date" minoccurs="0" maxoccurs="1" /> <xs:element name="forventetudlaert" type="xs:date" minoccurs="0" maxoccurs="1" /> <xs:element name="formodetafbrudt" type="xs:date" minoccurs="0" maxoccurs="1" /> <xs:element name="ansoegtfu" type="xs:date" minoccurs="0" maxoccurs="1" /> <xs:element name="svarfu" type="xs:date" minoccurs="0" maxoccurs="1" /> <xs:element name="fagligtudvalg" minoccurs="0" <xs:maxlength value="2" /> <xs:element name="fagligtudvalgnavn" minoccurs="0" Side 17 af 25

18 <xs:maxlength value="100" /> <xs:element name="afslutningsaarsag" minoccurs="0" <xs:element name="afslutningstekst" minoccurs="0" <xs:element name="cvrnummer" minoccurs="0" <xs:maxlength value="8" /> <xs:element name="loennummer" minoccurs="0" <xs:maxlength value="8" /> <xs:element name="laerestedlbnr" minoccurs="0" <xs:restriction base="xs:int"> <xs:totaldigits value="4" /> <xs:element name="pnummer" minoccurs="0" <xs:restriction base="xs:int"> <xs:totaldigits value="10" /> <xs:element name="lstedid" minoccurs="0" <xs:restriction base="xs:int"> <xs:totaldigits value="10" /> <xs:element name="lstednavn" minoccurs="0" <xs:element name="lstedadresse" minoccurs="0" <xs:element name="lstedsted" minoccurs="0" Side 18 af 25

19 <xs:element name="lstedpostnr" minoccurs="0" <xs:element name="lstedby" minoccurs="0" <xs:element name="lsted " minoccurs="0" <xs:element name="praktikcenter" minoccurs="0" <xs:maxlength value="10" /> <xs:element name="praktikcentereasy" minoccurs="0" <xs:element name="praktikcenternavn" minoccurs="0" <xs:element name="dsafdpraktikcenter" minoccurs="0" <xs:maxlength value="6" /> <xs:element name="dsafdpraktikcenternavn" minoccurs="0" <xs:element name="udlagtskole" minoccurs="0" <xs:maxlength value="10" /> <xs:element name="udlagtskoleeasy" minoccurs="0" Side 19 af 25

20 <xs:element name="udlagtskolenavn" minoccurs="0" <xs:element name="dsafdudlagtskole" minoccurs="0" <xs:maxlength value="6" /> <xs:element name="dsafdudlagtskolenavn" minoccurs="0" <xs:element name="landekode" minoccurs="0" <xs:element name="landbeelse" minoccurs="0" <xs:element name="piuskole" minoccurs="0" <xs:maxlength value="10" /> <xs:element name="piuskoleeasy" minoccurs="0" <xs:element name="piuskolenavn" minoccurs="0" <xs:element name="dsafdpiuskole" minoccurs="0" <xs:maxlength value="6" /> <xs:element name="dsafdpiuskolenavn" minoccurs="0" Side 20 af 25

21 Side 21 af 25 <xs:element name="diguddaftreference" minoccurs="0" <xs:restriction base="xs:int" /> <xs:element name="senestaendretdato" type="xs:date" minoccurs="0" maxoccurs="1" /> <xs:element name="senestaendretskole" minoccurs="0" <xs:restriction base="xs:int"> <xs:totaldigits value="10" /> <xs:element name="senestaendretskoleeasy" minoccurs="0" <xs:element name="senestaendretskolenavn" minoccurs="0" <xs:element name="senestaendretinit" minoccurs="0" <xs:maxlength value="3" /> <xs:element name="pause" minoccurs="0" maxoccurs="unbounded"> <xs:complextype> <xs:sequence> <xs:element name="pausefra" type="xs:date" maxoccurs="1" /> <xs:element name="pausetil" type="xs:date" minoccurs="0" maxoccurs="1" /> <xs:element name="bemaerkning" minoccurs="0" <xs:maxlength value="200" /> </xs:sequence> </xs:complextype> </xs:sequence> </xs:complextype> </xs:sequence> </xs:complextype> <xs:element type="xs:string" name="errorcode" /> <xs:element name="errorcode" substitutiongroup="errorcode"/> <xs:element type="xs:string" name="errortext" /> <xs:element name="errortext" substitutiongroup="errortext"/> <xs:complextype name="errortype">

22 Side 22 af 25 <xs:sequence> <xs:element ref="errorcode" /> <xs:element ref="errortext" minoccurs="0" maxoccurs="1" /> </xs:sequence> </xs:complextype> <xs:group name="resulttype"> <xs:sequence> <xs:element type="parameterlisttype" name="parameterlist" /> <xs:element type="xs:int" name="dsnumber" minoccurs="0" maxoccurs="1" /> <xs:element type="xs:byte" name="version" minoccurs="0" maxoccurs="1" /> <xs:element type="p006resulttype" name="p006result" minoccurs="0" maxoccurs="1"/> <xs:element type="errortype" name="error" minoccurs="0" maxoccurs="1"/> </xs:sequence> </xs:group> <xs:group name="resulttypeerr"> <xs:sequence> <xs:element type="xs:int" name="dsnumber" /> <xs:element type="parameterlisttype" name="parameterlist" /> <xs:element type="xs:byte" name="version" minoccurs="0" maxoccurs="1" /> <xs:element type="p006resulttype" name="p006result" minoccurs="0" maxoccurs="1"/> <xs:element type="errortype" name="error" minoccurs="0" maxoccurs="1"/> </xs:sequence> </xs:group> <xs:complextype name="resultchoice"> <xs:sequence> <xs:element type="xs:datetime" name="timestamp" minoccurs="0" maxoccurs="1" /> <xs:choice> <xs:group ref="resulttype" /> <xs:group ref="resulttypeerr" /> </xs:choice> </xs:sequence> </xs:complextype> <xs:element name="result" type="resultchoice" /> </xs:schema>

23 Side 23 af 25 Bilag 4. Eksempel på soap request. <soapenv:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soapenv=" xmlns:eas="easyieasywv13"> <soapenv:header/> <soapenv:body> <eas:wscalleasya soapenv:encodingstyle=" <modulnummer xsi:type="xsd:string">p006</modulnummer> <dsnr xsi:type="xsd:string">999878</dsnr> <parameterlist xsi:type="xsd:string"> <ParameterList> <CPRNummer>051078XXXX</CPRNummer> </ParameterList> </parameterlist> <version xsi:type="xsd:string">2</version> <adgangskode xsi:type="xsd:string">1234</adgangskode> </eas:wscalleasya> </soapenv:body> </soapenv:envelope>

24 Side 24 af 25 Bilag 5. Eksempel på soap response. <env:envelope env:encodingstyle=" xmlns:env=" xmlns:enc=" xmlns:ns0="easyieasywv13" xmlns:xsd=" xmlns:xsi=" <env:body> <ans1:wscalleasyaresponse env:encodingstyle="" xmlns:ans1="easyaws"> <return env:encodingstyle=" xsi:type="xsd:string"> <![CDATA[<Result> <TimeStamp> T13:25:12</TimeStamp> <ParameterList> <CPRNummer> </CPRNummer> </ParameterList> <DSNumber>999878</DSNumber> <Version>2</Version> <P006Result> <Praktikforhold_Resultat> <AftaleIdGlobal>691669</AftaleIdGlobal> <PraktikType>A</PraktikType> <CPRNummer>051078XXXX</CPRNummer> <Uddannelse>1139</Uddannelse> <Version>3</Version> <UddBeelse>Tekstil- og beklædningsteknikeruddannelsen</uddbeelse> <Speciale>3</Speciale> <SpecialeBeelse>Konfektionstekniker</SpecialeBeelse> <OblAftaletype>1002</OblAftaletype> <OblAftTypeTekst>Praktikvej</OblAftTypeTekst> <Adgangsvej>SP</Adgangsvej> <AdgangsvejBeelse>Specialundervisning</AdgangsvejBeelse> <ArkivSkole>388</ArkivSkole> <Modtaget> </Modtaget> <PeriodeStart> </PeriodeStart> <PeriodeSlut> </PeriodeSlut> <Faerdigregistreret> </Faerdigregistreret> <Afslutningsaarsag>1108</Afslutningsaarsag> <CvrNummer> </CvrNummer> <PNummer> </PNummer> <SenestAendret> </SenestAendret> <Pauser> <PauseFra> </PauseFra> <PauseTil> </PauseTil> <Bemærkning>sygdom</Bemærkning> </Pauser> <Pauser> <PauseFra> </PauseFra> <PauseTil> </PauseTil> <Bemærkning>barsel</Bemærkning> </Pauser> </Praktikforhold_Resultat> </P006Result> </Result> ]]></return> </ans1:wscalleasyaresponse> </env:body> </env:envelope>

25 Side 25 af 25 Bilag 6. Eksempel på soap error response. <env:envelope env:encodingstyle=" xmlns:env=" xmlns:enc=" xmlns:ns0="easyieasywv13" xmlns:xsd=" xmlns:xsi=" <env:body> <ans1:wscalleasyaresponse env:encodingstyle="" xmlns:ans1="easyaws"> <return env:encodingstyle=" xsi:type="xsd:string"> <![CDATA[<Result> <TimeStamp> T09:13:27</TimeStamp> <ParameterList> <CPRNummer> </CPRNummer> </ParameterList> <DSNumber>999855</DSNumber><Version>2</Version> <Error> <Errorcode>WS_137</Errorcode> <Errortext>CPR-nummer findes ikke i EASY-P </Errortext> </Error> </Result>]]></return> </ans1:wscalleasyaresponse> </env:body> </env:envelope>