Sidehistorik
...
Elevdatabasen er et nyt grunddatasystem i Styrelsen for It og Læring (STIL), indeholdende grunddata om elever på uddannelser under Børne- og Undervisningsministeriets (BUVM) ressortområde. De konkrete grunddata omfatter oplysninger om elevers aktuelle tilknytning til institutioner og uddannelser, herunder trin, start- og slutdatoer mv. De overordnede dataområder, Elevdatabasen opererer med, er persondata, institutionsdata og uddannelsesdata.
I dag indhenter en række fagsystemer i STIL helt eller delvist egne elevdata. Hertil kommer også månedlige og kvartalsvise statistikindberetninger til Datavarehuset. Elevdatabasen vil minimere antallet af indberetningsprocesser fra institutionerne til STIL's systemer, således indberetningen af grunddata om elever fremover kun sker til ét sted. Dette skal medvirke til at STIL's fagsystemer fremover trækker elevdata fra Elevdatabasen. Den skal således udgøre et fælles datagrundlag for elevdata, som understøtter datakvalitet og de administrative og statistiske opgaver på tværs af STIL. Det er derfor nødvendigt, at Elevdatabasen leverer et højaktuelt billede af hvilke elever, som går på hvilke gymnasiale uddannelser. Dette sikres gennem højfrekvente indberetninger af elevdata fra uddannelsesinstitutionerne.
Indberetninger til Elevdatabasen sker fra uddannelsesinstitutionernes studieadministrative systemer (SA-systemer) via en webservice udstillet på STIL’s integrationsplatform (Integrationsplatformen). Integrationsplatformen er knudepunktet for STIL’s eksternt rettede webservices. Den er en infrastrukturkomponent som via autentificering, autorisering, logning og kryptering (https) understøtter en sikker, ensartet og effektiv udveksling af data mellem STIL's centrale systemer og de eksterne systemer i sektoren. Yderligere oplysninger om tilslutning samt tekniske detaljer kan findes på STIL’s supportside for Integrationsplatformen. Det overordnede flow kan ses i diagrammet nedenfor:
...
Da beskeder kan skifte rækkefølge i både netværk og på Integrationsplatformen (IPL), giver det en risiko for , at ændringer kan bliver blive overhalet, og dermed bliver data i Elevdatabasen forskellig fra den faktiske data i SA-systemet.
Rækkefølgen af indberetninger bliver først gjort endelig idet beskeden modtages af Elevdatabasen, og det er derfor ikke tilladt at indberette 2 ændringer på samme CPR-nummer i parallel.
Alle indberetninger på samme CPR-nummer skal således ske sekventielt - dvs. at næste indberetning først sendes, når svar er modtaget fra Elevdatabasen på første indberetningden sidste indberetning for det pågældende CPR-nummer.
Ønsker man at parallelisere indberetningerne, er det der derfor vigtigt at paralleliseringen sker grupperet på CPR-nummer.
...
Se tabellen i afsnittet Fejlhåndtering for yderligere detaljer om hvornår SA-systemet forventes at gensende en indberetning på et IndberetningsId.
Webservice
...
Elevdatabasens webservice udstilles på STIL's integrationsplatform (Integrationsplatformen). Integrationsplatformen anvender STIL's system Tilslutning til brug for oprettelse, administration og vedligehold af tilslutninger til services og dataadgange mellem institutioner og systemleverandører.
For at kunne indberette til Elevdatabasen er det påkrævet, at der er indgået en aftale om udveksling af data (dataadgang) mellem det studieadministrative system og den konkrete uddannelsesinstitution via Tilslutning. Dataadgangen skal oprettes på hovedinstitutionen, hvis der skal indberettes for en afdeling under en hovedinstitution.
Operationer
Der findes 3 4 operationer i Elevdatabasens indberetningswebservice.
...
Anvendes til at slette alle indberetninger for en elev på en institution. Operationen er udelukkende tiltænkt situationer hvor der er indberettet elevdata på et forkert personnummer eller en forkert uddannelse. I situationer hvor der er indberettet forkerte data om en elevs skoleperioder, laves der en ny almindelig indberetning med elevens korrekte skoleperiodehistorik skoleperioder og data på institutionen.
Ping
Anvendes til at pinge Elevdatabasen og angiver om Elevdatabasen kan modtage indberetninger.
...
Elevdatabasen opererer med 3 typer af fejlkoder, ElevdbElevdb-XXXX, Indb-XXXX og Pers-XXXX. Elevdb-XXXX fejlkoderne dækker over interne fejl på Elevdatabasen. Indb-XXXX fejlkoderne dækker over fejl i indberetningen fra de studieadministrative systemer til Elevdatabasen. Pers-XXXX dækker over fejl i ved valideringen af personoplysninger mod CPR-oplysninger.
Tabellen nedenfor indeholder en oversigt over de enkelte fejlkoder og information om, hvordan disse fejl skal håndteres.
...
Elevdatabasen returnerer både interne tekniske fejl og datafejl som SoapFaults. Elevdatabasens SoapFaults er bygget op omkring 2 overordnede elementer:
...
<soap:Detail> - Indeholder en mere detaljeret beskrivelse af fejlen (ErrorMessage) samt ErrorCode. I tilfælde af valideringsfejl indeholder fejlbeskeden en liste af valideringsfejlkoder og dertilhørende fejlbeskrivelser.
Parametre for SoapFault-besked ved interne fejl
Ved interne tekniske fejl benyttes følgende format
Felt | Datatype | Begrænsninger | Krævet | Kardinalitet | Beskrivelse |
---|---|---|---|---|---|
ErrorCode | String | Ingen/Ikke relevant | J | 1 | Fejlkode |
ErrorMessage | String | Ingen/Ikke relevant | J | 1 | Beskrivelse af fejlen |
Parametre for SoapFault-besked ved valideringsfejl
Ved valideringsfejl benyttes ved følgende format
...
Ved brud på valideringsregler, returneres en liste af valideringsfejl som Indberetningsdetaljer i en SoapFault.
...
Uddannelsesdata
Fejlkode | Fejltekst |
---|---|
Udd-01 | Den indberettede kombination af uddannelseskode, uddannelsesversion, speciale og skoleperioder er ikke gyldig |
Udd-02 | Uddannelseskoden #uddannelseskode findes ikke i Uddannelsesmodellen. |
Udd-03 | Versionen #uddannelsesversion findes ikke for uddannelsen #uddannelseskode |
Udd-04 | Skoleperioderne #skoleperioder gælder ikke for uddannelsen #uddannelseskode i version #version. |
Udd-05 | Specialet #specialekode gælder ikke for uddannelsen #uddannelseskode i version #version med skoleperioderne #skoleperioder |
Udd-07 | Tidligste registrering af eleven #tidligsteSkoleperiodeStartdato ligger før startdato for uddannelsen med uddannelseskoden #uddannelseskode i version #Version |
Udd-10 | Elevskoleperiodens startdato #elevskoleperiodestart skal være før elevskoleperiodens slutdato #elevskoleperiodeslut |
Udd-13 | Adgangsvejen #adgangsvej på skoleperiode #skoleperiode er ikke tilknyttet uddannelsen #uddannelseskode" med version #Version |
Udd-15 | Skoleperiode #skoleperiode på uddannelsen #uddannelseskode i version #version mangler en adgangsvej |
Udd-16 | Elevtypen #elevtype på skoleperiode #skoleperiode er ikke tilknyttet specialet #speciale på uddannelsen #Uddannelseskode |
Teknisk beskrivelse af operationer
...
UI Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
|
UI Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
|
Status
Status-operationen er stadig under udarbejdelse, og vi forventer at response-strukturen kommer til at matche Indberet-operationen
Parametre for request
...
StatusRequest
...
StatusRequest
...
StatusRequest
...
Institutionsoplysninger
...
Institutionsnummeret for afdelingen hvor eleven modtager undervisning
Er institutionen en selvstændig institution uden hovedinstitution skal samme institutionsnummer angives i Hovedinstitution og Afdeling.
Parametre for response
...
StatusResponse
...
StatusResponse
...
StatusResponse
...
CREATED,
RECEIVED,
DUPLICATE,
PROCESSING,
COMPLETE,
FAILED
...
Status for behandling af indberetningen.
Se afsnittet Fejlhåndtering for information om status FAILED.
I tilfælde at status er andet end FAILED, COMPLETE eller DUPLICATE betyder, det at indberetningen er endt i en ugyldig tilstand.
...
|
UI Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
|
Status
Status-operationen er stadig under udarbejdelse, og vi forventer at response-strukturen kommer til at matche Indberet-operationen
Parametre for request
Felt | Datatype | Begrænsninger | Krævet | Kardinalitet | Beskrivelse |
---|---|---|---|---|---|
StatusRequest | StatusRequest | Ingen/Ikke relevant | J | 1 | Request på status for indberetning. Se beskrivelsen i afsnittet StatusRequest herunder. |
StatusRequest
...
Felt | Datatype | Begrænsninger | Krævet | Kardinalitet | Beskrivelse |
---|
Institutionsoplysninger |
Institutionsoplysninger | Ingen/Ikke relevant | J | 1 |
Oplysninger om den indberettende institution | |
IndberetningsId | GUID |
Ingen/Ikke relevant | J | 1 |
UI Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
|
UUID for indberetningen der ønskes status for |
Institutionsoplysninger
Felt | Datatype | Begrænsninger | Krævet | Kardinalitet | Beskrivelse |
---|---|---|---|---|---|
Hovedinstitution | Heltal | Max cifre: 6 | J | 1 | Hovedinstitutionen for den afdeling hvor eleven modtager undervisning |
Afdeling | Heltal | Max cifre: 6 | J | 1 | Institutionsnummeret for afdelingen hvor eleven modtager undervisning Er institutionen en selvstændig institution uden hovedinstitution skal samme institutionsnummer angives i Hovedinstitution og Afdeling. |
Parametre for response
Felt | Datatype | Begrænsninger | Krævet | Kardinalitet | Beskrivelse |
---|---|---|---|---|---|
StatusResponse | StatusResponse | Ingen/Ikke relevant | J | 1 | Response på status. Se beskrivelsen i afsnittet StatusResponse herunder. |
StatusResponse
Felt | Datatype | Begrænsninger | Krævet | Kardinalitet | Beskrivelse |
---|---|---|---|---|---|
Status | Enum | CREATED, RECEIVED, DUPLICATE, PROCESSING, COMPLETE, FAILED | J | 1 | Status for behandling af indberetningen. I tilfælde at status er andet end FAILED, COMPLETE eller DUPLICATE betyder, det at indberetningen er endt i en ugyldig tilstand. |
Indberetningsdetaljer | List<Indberetningsdetalje> | Ingen/Ikke relevant | N | Unbounded | Udspecificeret liste med fejlkoder og beskrivelser |
Indberetningsdetalje
Felt | Datatype | Begrænsninger | Krævet | Kardinalitet | Beskrivelse |
---|---|---|---|---|---|
Fejlkode | String | Ingen/Ikke relevant | J | 1 | Elevdatabasens valideringsfejlkode |
Fejlbeskrivelse | String | Ingen/Ikke relevant | J | 1 | Beskrivelse af valideringsfejlen |
UI Expand | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
| ||||||||||||||||||
UI Expand | ||||||||||||||||||
| ||||||||||||||||||
|
UI Expand | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
|
Slet
Denne operation benyttes kun hvis der er indberettet data på et forkert CPR-nummer eller en forkert uddannelse.
Bemærk | ||
---|---|---|
| ||
Interface til operationen Slet er implementeret (skal anvendes ved fejloprettelse af elever), funktionaliteten er endnu ikke implementeret. |
Operationen har følgende struktur for request og response:
Parametre for request
Felt | Datatype | Begrænsninger | Krævet | Kardinalitet | Beskrivelse |
---|---|---|---|---|---|
SletRequest | SletRequest | Ingen/Ikke relevant | J | 1 | Request på Slet Se beskrivelsen i afsnittet SletRequest herunder. |
SletRequest
Felt | Datatype | Begrænsninger | Krævet | Kardinalitet | Beskrivelse |
---|---|---|---|---|---|
CPRNummer | String | Længde:10 | J | 1 | CPR-nummer (personnummer) på elevenhvis elevdata skal slettes. |
Hovedinstitution | Heltal | Max cifre: 6 | J | 1 | Institutionsnummeret for hovedinstitutionen hvor elevdata skal slettes. |
Afdeling | Heltal | Max cifre: 6 | J | 1 | Institutionsnummeret for afdelingen hvor elevdata skal slettes. Er institutionen en selvstændig institution uden hovedinstitution, skal samme institutionsnummer angives i Hovedinstitution og Afdeling. |
Uddannelseskode | String | Minimum længde: 1, max længde: 4, ingen whitespace tegn | J | 1 | Den officielle uddannelseskode (CØSA-formål) for uddannelsen hvor elevdata skal slettes. |
Parametre for response
Felt | Datatype | Begrænsninger | Krævet | Kardinalitet | Beskrivelse |
---|---|---|---|---|---|
SletStatus | Enum | Værdimængde: DELETED | J | 1 | Response på slet |
UI Expand | |||||
---|---|---|---|---|---|
| |||||
|
Slet
Operationen har følgende struktur for request og response:
Parametre for request
...
Felt
...
Datatype
...
Begrænsninger
...
Krævet
...
Kardinalitet
...
Beskrivelse
...
SletRequest
...
SletRequest
...
SletRequest
...
Felt
...
Datatype
...
Begrænsninger
...
Krævet
...
Kardinalitet
...
Beskrivelse
...
Institutionsnummeret for afdelingen hvor elevdata skal slettes.
Er institutionen en selvstændig institution uden hovedinstitution, skal samme institutionsnummer angives i Hovedinstitution og Afdeling.
...
Parametre for response
...
Felt
...
Datatype
...
Begrænsninger
...
Krævet
...
Kardinalitet
...
Beskrivelse
...
SletStatus
...
Enum
...
UI Expand | |||||
---|---|---|---|---|---|
| |||||
|
UI Expand | |||||
---|---|---|---|---|---|
| |||||
(Operationen er endnu ikke implementeret)
|
Ping
Operationen har følgende struktur for request og response
...
UI Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
UI Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
|