Sidehistorik
Dokumentoplysninger
UI Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
|
Ændringshistorik
UI Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
Arkiveret ændringshistorik
UI Expand | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||
|
Indhold
Indholdsfortegnelse | ||||
---|---|---|---|---|
|
Indledning
Ungedatabasen indeholder en række oplysninger om de unge mellem 15-30 år.
...
Dette dokument beskriver strukturen for de oplysninger, som uddannelsesinstitutioner kan afhente via webservicen DataTilInstitution.
Hvem kan hente data?
Ungedatabasen udstiller flere typer data. Det vil for flere at disse datatyper være et krav, at den unge er optaget på uddannelsesinstitutionen.
En uddannelsesinstitution kan hente oplysninger for de eventuelle afdelinger, som måtte høre under skolen.
Hvilke data kan hentes?
Uddannelsesinstitutionerne kan hente tre typer af oplysninger, som beskrives nedenfor, men der kan kun hentes en type oplysninger per kald.
...
Der kan hentes data, når de endelige uddannelsesparathedsvurderinger ligger klar, hvilket typisk vil sige medio juli for nye uddannelsesparathedsvurderinger.
DataTilInstitution
Denne webservice anvendes af uddannelsesinstitutioner ved afhentning af oplysninger om de unge. Når servicen kaldes, skal det angives, hvilken institution der hentes for. Institutionen kan kalde servicen når som helst, hvorefter Ungedatabasen foretager en validering returneret i et synkront svar.
Overordnet struktur
Hent Kommune Kontaktperson
Struktur for HentKommuneKontaktRequest
Figur 1. XML-struktur for afhentning af information om kommunekontakt til uddannelsesinstitutioner.
HentKommuneKontaktRequest
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
InstitutionNummer | Integer (6) | Ja | Institutionsnummer fra den kaldende institution. | |
OpdateretSenereEnd | DateTime | Nej | Hvis anført returneres kun data oprettet efter denne dato. Kan ikke angives sammen med Elev (CPR-numre). | |
Elev | XML-element | Nej | Max 100 | Ingen, en eller flere forekomster. Repræsenterer elever der ønskes status på. Kan ikke angives sammen med OpdateretSenereEnd. |
...
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
CPRNr | String (10) | Ja | CPR-nummer på den unge, som der ønskes svar på. Der valideres på CPRnr og det returneres i ElevStatus sammen med efterspurgte data eller eventuel fejlkode og fejltekst. |
Struktur HentKommuneKontaktSvar
Figur 2. XML-struktur for svar.
...
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
KommuneInstitutionNummer | Integer(6) | Ja | Kommunens institutionsnummer. | |
KommuneInstitutionNavn | String | Ja | Kommunens institutionsnavn. | |
KontaktNavn | String(500) | Ja | Kontaktpersonens navn. | |
KontaktMail | String(100) | Ja | Kontaktpersonens email-adresse. | |
KontaktTelefon | Integer | Nej | 10 cifre | Kontaktpersonens telefonnummer. |
KontaktRegistreringstid | DateTime | Ja | Tidspunktet for hvornår informationen er registreret i kommunen. Hvis OpdateringNyereEnd er angivet i input, vil der kun være data, hvis KontaktRegistreringstid er nyere end den angivne dato. |
Hent UddannelsesParathedsVurdering (UPV)
Denne webservice anvendes af uddannelsesinstitutioner ved afhentning af oplysninger om de unges UPV.
Struktur for HentUPVRequest
Figur 3. XML for forespørgsel på unges UPV.
...
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
CPRNr | String (10) | Ja | CPR-nummer på den unge der ønskes UPV på. Der valideres på CPRnr og det returneres i ElevStatus sammen med efterspurgte data eller eventuel fejlkode og fejltekst. |
Struktur HentUPVSvar
Returnerer svar på forespørgsel om unges UPV.
...
Resultat | Parat? |
---|---|
NOT_INTERESTED | Nej |
NOT_EVALUATED | Nej |
AUTOMATIC_NOT_READY | Nej |
AUTOMATIC_READY | Ja |
MANUAL_NOT_READY | Nej |
MANUAL_READY | Ja |
HentUddPaalaegRequest
Denne webservice anvendes af uddannelsesinstitutioner ved afhentning af oplysninger om unges eventuelle uddannelsespålæg. Den unge kan blive pålagt at gennemføre en uddannelse af jobcenteret.
...
Modtages der en besked om, at den unge har et uddannelsespålæg, skal institutionen kvittere med en kontaktperson eller team på institutionen. Denne information skal sendes ind med webservicen IndberetInstitutionKontakt. Flere detaljer om denne kan findes på https://viden.stil.dk/.
Struktur for HentUddPaalaegRequest
Figur 5. XML for HentUddPaalaeg.
...
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
CPRNr | String (10) | Ja | CPR-nummer på den unge, der ønskes svar på. Der valideres på CPRnr og det returneres i ElevStatus sammen med efterspurgte data eller eventuel fejlkode og fejltekst. |
Struktur for HentUddPaalaegSvar
Figur 6. XML for HentUddPaalaegSvar.
...
Integrationsplatformen IPL står for skemavalidering af xlm, men der er for en sikkerhedsskyld ligeledes indsat validering i Ungedatabasen, som kan resultere i 'fejl 500'. Sådanne fejl vil blive returneret i elementet ServiceFaultDetailer, der ses i xsd'en.
Endpoints til testmiljø
Endpoints til testmiljø kan findes her: https://viden.stil.dk/display/OFFintegrationsplatformen/Services.
...