PUBLICPUBLICX Ungebasen Løsningsbeskrivelse Åbne interfaces mellem Datacontaineren/Tilbagemelding.dk og kommunale vejledningssystemer 14.09.2012 A414.44.4 [Status] Side 1 af 9
Indhold 1. Formål... 3 2. Webservice 1: Levering af data fra Ungebasen/Tilbagemelding.dk til et kommunalt vejledningssystem... 3 2.1 Beskrivelse data... 3 2.2 Teknisk implementering... 4 3. Webservice 2: Indberetning af kontakt- og tilbudstid fra kommunalt vejledningssystem til Ungebasen/datacontaineren... 4 3.1 Særlige situationer... 5 3.2 Teknisk implementering... 7 4. Webservice 3: Indberetning af hændelser fra kommunalt vejledningssystem til Ungebasen/datacontaineren... 7 4.1 Teknisk implementering... 8 5. Implementering af sikkerhed og Logning... 8 Historik Dokumentid. Dato Udarb. af Ændringer A414.44.1 A414.44.2 24.02.2011 31.08.2011 A414.44.3 30.10.2011 Jan Gaardboe Jan Gaardboe Henrik Skjødt Jan Gaardbo 1 version Udvidet LB så den udover åbent interface til Tilbagemelding.dk også beskriver åbent interface til datacontaineren. Endvidere er implementeringen af sikkerhed omkring overførsel af data mellem Ungebasen og et kommunalt vejledningssystem beskrevet Opdateret ud fra kommentarer fra UNI-C og indført præciseringer affødt af uviklingen af de åbne interfaces A414.44.3 14.09.2012 Henrik Skjødt Jan Gaardboe Feltændringer til webservice 1 og 2. Webservice 3 ændres til at være en webservice der udstilles af ungebasen, og kan dermed implementeres. 14.09.2012 A414.44.4 [Status] Side 2 af 9
1. Formål Ungebasen stiller følgende muligheder til rådighed for at der kan udveksles data mellem Ungebasen og et vejledningssystem i en kommune: 1. Levering af data fra Ungebasen/Tilbagemelding.dk til et kommunalt vejledningssystem 2. Indberetning af kontakt- og tilbudstid fra kommunalt vejledningssystem til Ungebasen/datacontaineren via Tilbagemelding.dk 3. Indberetning af udvalgte aktiviteter på unge fra et kommunalt vejledningssystem til Ungebasen/datacontaineren via Tilbagemelding.dk 4. 2. Webservice 1: Levering af data fra Ungebasen/Tilbagemelding.dk til et kommunalt vejledningssystem Formålet med snitfladen er at levere data fra Tilbagemelding.dk til et kommunalt vejledningssystem. Der leveres kun data/hændelser på de personer, der geografisk bor i UU-centrets kommuner, som er mellem 15-24 år på udtrækstidspunktet og ikke tidligere hentet af et UU-center. Når en given hændelse for en person hentes fra Tilbagemelding.dk af et UU center, registreres det i tilbagemelding.dk, at hændelsen er overført til UU, og den vil ikke kunne hentes igen. Flytter en person fra et UU-center til et andet, sker der således ikke en genforsendelse af hændelserne, da løsningen ikke håndterer flyttehistorik 2.1 Beskrivelse data Der overføres nedenstående data fra Ungebasen/Tilbagemelding.dk pr. hændelse: Felter Datatype Noter CPR String CPR-nummer på den den unge Institutionskode Integer Refererer til UVM's institutionsregisterkode. Optræder der negative koder, er der tale om koder, som skulle specialoprettes til dette projekt. Det drejer sig om Forsvar, SU, SKAT og AMS. Sidstnævnte koder er oprettet af UVdata med et negativt fortegn. -99995 = SKAT -99996 = SU-styrelsen -99997 = Forsvaret -99998 = AMS Startdato Date Startdato på hændelsen Slutdato Date Slutdato på uddannelsen/hændelsen. Der kan være tale om en forventet slutdato. Er der tale om at den unge har afbrudt, vil slutdatoen være afbrudsdatoen. Såfremt slutdato ikke er angivet fra systemleverandøren returneres 31.12.9999 Afbrudsaarsag Integer -1 = Ukendt / ikke oplyst 6 = Fravær 9 = P.g.a sygdom 20 = Uddannelsen ikke påbegyndt 21 =Ændret uddannelse 22 = Skiftet skole 23 = Skiftet skole og ændret uddannelse 24 = Faglige krav 25 = Andet 14.09.2012 A414.44.4 [Status] Side 3 af 9
Status Integer 26 = Ukendt 27 = Uddannelsesaftale ophævet 28 = Død 29 = Ikke praktikpladssøgende Kodeværdi for årsag til afbrud. 1 = Gennemført (afsluttet) 2 = Afbrudt 3 = I gang TilbagemeldingId Integer Nøgle, der identificerer indberetningen CosaFormal String Refererer til UVM's uddannelsesmodel CosaVersion String Refererer til UVM's uddannelsesmodel CosaSpecial String Refererer til UVM's uddannelsesmodel Aktivitetsgruppekode String Referer til UVM's uddannelsesmodel SuUddannelseskode String Referer til SU's uddannelseskode AmsAktivitet Integer Aktiviteter under Vejledning og opkvalificering iflg. LAB-loven SKAT Integer 1 = Fuldtidsbeskæftiget 2 = Deltidsbeskæftiget 3 = Offentlig forsørgelse UnderaktivitetKode String Dummyfelt. Vil ikke indeholde nogen værdi. Registreringstidspunkt DateTime Registreringstidspunktet i Tilbagemelding.dk Haendelsesdato DateTime Hændelsesdatoen er systembestemt og ikke obligatorisk. Frafaldstruet DateTime Dato, der angiver om institutionen har meddelt, at personen er frafaldstruet. Status vil altid være I gang på disse personer. 2.2 Teknisk implementering Der etableres en webservice, der kan kaldes for at hente data fra Tilbagemelding.dk. Data hentes ved at kalde metoden "HentTilbagemeldingerTilUU" og leveres kun en gang. Webservicen udvikles i Microsoft.NET og eksponeres via en WSDL. Løsningen er baseret på WCF (Windows Communication Foundation). Af hensyn til datamængden anvendes der NetTCP port 8016. Der anvendes almindelige datatyper dvs. string, DateTime, Int. 3. Webservice 2: Indberetning af kontakt- og tilbudstid fra kommunalt vejledningssystem til Ungebasen/datacontaineren Af bekendtgørelse om vejledning om valg af ungdomsuddannelse og erhverv 25 følger, at UUcentrene skal indberette tidspunkterne for: 14.09.2012 A414.44.4 [Status] Side 4 af 9
1. hvornår kommunen bliver bekendt med, at en 15-17-årige ikke følger sin uddannelsesplan 2. hvornår kommunen tager kontakt med en 15-17-årig, som ikke følger sin uddannelsesplan 3. hvornår kommunen giver et tilbud om aktivitet til en 15-17-årig, som ikke følger sin uddannelsesplan Der indberettes data om unge, der har bopæl i UU-centrets geografiske område, og som er mellem 15-17 år. Der indberettes dagligt ændringer i forhold til sidste kørsel, idet der dog er mulighed for at foretage genindberetninger. I praksis vil proceduren for indberetning af, at en ung ikke følger sin uddannelsesplan, være, at UU-vejlederen i sit sagsbehandlingssystem modtager en hændelse fra Tilbagemelding.dk om, at en ung har afbrudt et uddannelsesforløb. Når denne hændelse importeres i sagsbehandlingssystemet, vil det udløse en markering, der angiver, at systemet skal indberette hændelsestidspunktet til den passive datacontainer. Ungedatabasen modtager dagligt beskeder fra Tilbagemelding om afbrudte elever; fra det kommunale vejledningssystem sendes data om en række udvalgte hændelser til ungedatabasen, som ikke indberettes til ungedatabasen. Den dag, UU-vejlederen kontakter den unge, opfattes som kontaktdatoen. Dette kan ske ved brug af forskellige kontaktformer (mail, SMS, telefon, brev etc.). Proceduren for, at en ung modtager et tilbud om ny aktivitet, er, at UU-vejlederen sammen med den unge og dennes forældre opretter en uddannelsesplan i vejledningssystemet. Uddannelsesplanen indeholder aftalte aktiviteter, der skal gøre den unge uddannelsesparat, og som skal afvikles i løbet af et år. Når UU-vejlederen godkender uddannelsesplanen, har den unge modtaget et tilbud. Dato for godkendt uddannelsesplan betragtes som tilbudsdatoen, der indberettes til den passive datacontainer. Dette tilbud skal være afgivet senest 30 dage efter den unges afbrud. Ungedatabasen udstiller en webservice via tilbagemelding.dk, der gør det muligt for det enkelte UU-center at foretage en indberetning. Et UU-center må kun foretage indberetning på borgere med bopæl i UU-centrets geografiske område.(kommune) Hvorvidt et UU-center overholder de i loven fastsatte kontakttidspunkter, afgøres i statistikmodulet, der udvikles i tilknytning til den passive datacontainer, og påvirker ikke selve indberetningskomponenten. 3.1 Særlige situationer Flytter en ung, der ikke følger sin uddannelsesplan, til en anden kommune, og skal den unge vejledes af et nyt UU-center, har UVM meddelt, at det nye UU-center får yderligere 5 dage til at kontakte personen og 30 dage til at give et nyt tilbud. Unge, der er lære- og praktikpladssøgende i længere end 2 måneder, men som har gennemført et grundforløb, anses også som afbrudte. UNI-C har i sommeren 2012 gjort det muligt for UU_centrene igen at modtage hændelser om lære- og praktikpladssøgende for at undgå denne 14.09.2012 A414.44.4 [Status] Side 5 af 9
problemstilling. EASY indberetter afbrud, når den unge ikke længere er lære- og praktikpladssøgende. Et UU-center skal dagligt indberette følgende data om afbrudte 15-17 årige til ungedatabasen/datacontaineren: Felt Datatype Beskrivelse CPR String Angiver den unges CPR-nummer. Skal være et gyldigt CPR-nummer i formatet ddmmååxxxx. Indberetningstype Integer 1 = Kontakttidspunkt Tid Date 2 = Tilbudstidspunkt Institutionskode Integer Institutionskoden på indberetteren dvs. UU-centret TransaktionsId Integer Entydig identifikation af transaktionen i det kommunale vejledningssystem Tilbagemeldingsid Integer Nøgle der identificerer indberetningen oplyst fra webservice 1. Det være muligt at indberette en null værdi, for at kunne håndtere den situation hvor de UUcentret taget kontakt eller giver tilbud og ikke findes en hændelse fra Tilbagemelding.dk, eller i den situation, hvor det af tekniske årsager ikke er muligt at lave en sammenkobling mellem afbrudog kontakttidspunkt/tilbudstidspunkt. Hvis der indberettes en Tilbagemeldingsid skal det verificeres, at dette er gyldigt. Der indberettes dagligt ændringer fra vejledningssystemet til ungedatabasen/datacontaineren. Kombinationen af UU-center samt transaktionsident er unik. Indberettes samme institutionskode og transaktionsident, overskrives data i ungedatabasen, og det antages, at der er tale om en korrektion. Der bevares ikke historik om sådanne korrektioner. Oplysninger om den unges afbrud sendes dagligt fra Tilbagemelding.dk samt med udvalgte koder fra det kommunale vejledningssystem til ungedatabasen. Snitfladen kan ikke garantere, at et UU-center indberetter alle indberetningstyperne. Det er derfor ungedatabasens opgave at sikre, at det korrekte datagrundlag er til stede i forbindelse med dannelse af statistik. 14.09.2012 A414.44.4 [Status] Side 6 af 9
3.2 Teknisk implementering Der etableres en webservice, der kan kaldes for at indberette data tilungebasen/datacontaineren. Data indberettes ved at kalde metoden " IndberetUuOrientering Webservicen udvikles i Microsoft.NET og eksponeres via en WSDL. Løsningen er baseret på WCF (Windows Communication Foundation). Der kommunikeres via NetTCP. Der anvendes almindelige datatyper dvs. string, DateTime, Int. Der skal foretages et webservicekald pr. person og al trafik krypteres. Selve sikkerhedsmodellen følger det øvrige i denne løsning nemlig brug af certifikater jf. pkt. 5. 4. Webservice 3: Indberetning af hændelser fra kommunalt vejledningssystem til Ungebasen/datacontaineren Et UU-center skal dagligt indberette forekomster af hændelser for en række udvalgte aktiviteter. Nye vejledningssystemer skal anvende nedenstående service. MBU/UNI-C sikrer at UU centrene er løbende informeret om, hvilke aktiviteter, der skal indberettes hændelser for. For en hændelse skal der indberettes følgende oplysninger til Ungebasen/dtacontaineren: Felt Datatype Beskrivelse CPR String Angiver den unges CPRnummer Startdato Date Angiver startdatoen Slutdatoen Date Angiver slutdatoen eller den estimerede slutdato Status Integer 1=Gennemført(Afsluttet) 2=Afbrudt 3=I gang Institutionskode Integer Refererer til 6-cifret institutionskode fra UNI-C's institutionsregister UnderaktivitetsKode String Niveau 4 i MBUs aktivitetshierarki. Det skal verificeres at den indberettede kode ligger i den delmængde af Underaktivitets niveau 4, som UUerne står for indberetning af. Registreringsdato DateTime Dato for modtagelse af hændelsen, hvis den stammer fra Tilbagemelding.dk. Er data født i vejledningssystemet, er datoen oprettelsesdatoen Kildesystem String Navn på vejledningssystem. Frafaldsårsagskode Integer -1 = Ukendt / ikke oplyst 6 = Fravær 9 = P.g.a sygdom 20 = Uddannelsen ikke påbegyndt 21 =Ændret uddannelse 14.09.2012 A414.44.4 [Status] Side 7 af 9
Markering af om en ung er frafaldstruet Datetime 22 = Skiftet skole 23 = Skiftet skole og ændret uddannelse 24 = Faglige krav 25 = Andet 26 = Ukendt 27 = Uddannelsesaftale ophævet 28 = Død 29 = Ikke praktikpladssøgende 4.1 Teknisk implementering Der etableres en webservice, der kan kaldes for at indberette data til Ungebasen/datacontaineren. Data indberettes ved at kalde metoden " IndberetUuHaendelser Der oprettes en tabel i datacontaineren som indeholder den delmængde af Underaktivitets niveau 4, som UUerne står for indberetning af. Tabellen anvendes ved validering af de underaktivitetskoder som indberettes fra UUcentrene. Webservicen udvikles i Microsoft.NET og der genereres en WSDL, der beskriver snitfladen. Løsningen er baseret på WCF (Windows Communication Foundation). Der kommunikeres via NetTCP. Der anvendes almindelige datatyper dvs. string, DateTime, Int. Der skal foretages et webservicekald pr. person og al trafik krypteres. Selve sikkerhedsmodellen følger det øvrige i denne løsning nemlig brug af certifikater jf. pkt. 5. 5. Implementering af sikkerhed og Logning Kommunikationen med Ungedatabasen sker ved hjælp af SSL-krypterede webservices. Der anvendes OCES-certifikater til at foretage autorisation, idet hvert UU-center skal autoriseres med et certifikat for at få adgang til at hente og indberette data. Der anvendes server/funktions certifikater og ikke medarbejdercertifikater. Det er en forudsætning, at UVM/UNI-C/dataleverandøren kan levere et certifikat fra en trusted udbyder. Certifikatet må ikke være selvsigneret, det må ikke være udløbet og UVM/UNI-C skal aflevere den offentlige del af certifikatet, så leverandøren kan udlede thumbprint for at certifikatet kan blive godkendt til datatransmission samt verificere hvem certifikatet tilhører. Det bemærkes, at der er omkostninger i forbindelse med udstedelse af certifikater til dette formål. Tilbagemelding.dk/Ungedatabasen sørger for, at der foretages logning af de enkelte transaktioner: Transaktionstype Levering af data fra Ungebasen/Tilbagemelding.dk til et kommunalt vejledningssystem Indberetning af kontakt- og tilbuds- Loging Der logges følgende: Transaktiontype Hvem der har foretaget kaldet (identifikation af det pågældende UU center). Det er således ikke en navngiven bruger fra UUcentret der logges, men derimod et thumbprint Tidspunkt for kaldet. Der logges ikke hvilke data der er udleveret, men udelukkende transaktionstypen samt hvilket UUcenter der hentes data for(søgekriterium). Det skal bemærkes at det ud fra dette ikke er muligt at fremsøge de udleverede data. Der logges følgende 14.09.2012 A414.44.4 [Status] Side 8 af 9
tid fra kommunalt vejledningssystem til Ungebasen/datacotaineren Transaktiontype Hvem har foretaget kaldet (identifikation af det pågældende UU-center). Det er således ikke en navngiven bruger fra UU-centret der logges, da der er tale om en maskinel overførelse. Vejledningssystemet må evt. detaillogge hvem der har afgivet kontakten eller godkendt uddannelsestilbuddet. Tidspunkt for kaldet. Loggen opbevares i 6 måneder, hvorefter den slettes. Ugyldige kald vil ikke kunne gennemføres. Der foretages registrering af alle afviste adgangsforsøg, men løsningen har ikke mulighed for at blokere for en given arbejdsstation. Såfremt certifikatet er udløbet, eller certifikatet er selv-signet, eller certifikatet ikke er aktivt/ukendt i vores brugerdatabase, afvises forbindelsen, dog foretages logning af certifikatets thumbprint. Leverandøren anbefaler, at UNI-C retter henvendelse til Datatilsynet for at sikre, at løsningen er tilstrækkelig hvad angår logning 14.09.2012 A414.44.4 [Status] Side 9 af 9