Unilogin SkoleGrunddata Importformat anvendes i forbindelse med import via webservicen ws10/wsaIMPORT. WSDL definitionen for wsaIMPORT (ws10) rummer den formelle definition i XML Schema format.
Nedenfor er vist en skitse af den overordnede struktur i importformatet. Lister af elementer er angivet med stiplet ramme.
Tabellen beskriver de felter med tilhørende attributter, der kan importeres med de regler der gælder for hvert felt. Bemærk konventionen: Feltnavne er med stort begyndelsesbogstav og attributnavne er med lille.
Angivelser af feltlængde for felter af typen ”String” er i forhold til utf8 tegnsætkodning, dvs. at visse tegn fylder to felter.
Felt | Type | Antal | Beskrivelse |
sourceDateTime | DateTime | 1 | Tid for eksport af data fra kildesystemet Fx: 2011-11-10T17:00:00 Tidspunktet skal være nyere end tidspunktet for sidste eksport der er indlæst |
source | String | 1 | Navn på kildesystem. Navnet bruges sammen institutionens registreringsnummer til identifikation af importen |
schoolYear | String | 1 | Skoleår angivet på formatet YYYY-YYYY Fx: ”2016-2017” |
sourceVersion | String | 0-1 | Versionsnummer på kildesystem. Kun information. Gemmes ikke i SkoleGrunddata |
Institution | Institution | 1 | Institution |
Felt | Type | Antal | Beskrivelse |
InstitutionNumber | String | 1 | Seks-tegns registreringsnummer, som identificerer en institution (kan indeholde både bogstaver og tal) |
InstitutionName | String | 0-1 | Institutionsnavn |
Group | Group | 0-n | Grupper på institutionen |
InstitutionPerson | InstitutionPerson | 0-n | Ansatte og elever på institutionen |
Grupper bruges til samling af personer på en institution. Både elever og lærere kan tilknyttes grupper. En gruppe kan fx være klasser i grundskolen, hold, fag, studiegrupper eller lærerteams. Der er i gruppebegrebet ingen begrænsninger i forhold til hvad den enkelte institution vil bruge det til.
Felt | Type | Antal | Beskrivelse |
GroupId | String | 1 | GroupId kan bruges i skolernes infrastruktur (fx AD) og af udbydere i forbindelse med tildeling af adgang til tjenester. Det er derfor vigtigt at koordinere GroupId på tværs importkilder for at der ikke oprettes flere grupper med samme navn og for ikke at risikere at miste adgangen til tjenester ved skifte af importleverandør. Eksisterende grupper på en institution kan kortlægges med wsiEKSPORT Elever og lærere kan tilknyttes gruppen ved at angive MainGroupId eller GroupId på personen Gruppeid er unikt og uforanderligt i hele sin levetid på institutionen Fx: "2016a" |
GroupName | String | 0-1 | Gruppenavn, som vises til brugere |
GroupType | Enum | 1 | Gruppetypen En af værdierne: Hovedgruppe, Årgang, Retning, Hold, SFO, Team eller Andet |
GroupLevel | Enum | 0-1 | Hovedgruppens trin En af værdierne: DT, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, U1, U2, U3, U4, VU eller Andet DT er dagtilbud 1 svarer til 1. klassetrin i grundskolen U1 er første trin på en ungdomsuddannelse VU er voksenuddannelse Skal angives for grupper med groupType ”Hovedgruppe” og kun da |
Line | String | 0-1 | Spor, linje, studieretning eller lign. for hovedgruppen Skal angives for grupper med groupType ”Hovedgruppe” og kun da For grundskoler fx: ”B” |
FromDate | Date | 0-1 | Gruppens startdato på formen YYYY-MM-DD |
ToDate | Date | 0-1 | Gruppens slutdato på formen YYYY-MM-DD |
Felt | Type | Antal | Beskrivelse |
LocalPersonId | String | 1 | Den lokale identifikation af personen på institutionen. Identifikationen bruges til at genkende personer fra en import til den næste. Identifikationen skal derfor være unik inden for en import, således at <institutionNumber><source><LocalPersonId> skal være unik. Identifikationen skal være uforanderlig, således at en person der en gang er importeret med et LocalPersonId skal have det samme LocalPersonId i alle fremtidige importer. Dette ID må ikke være personens CPR-nummer |
Person | Person | 1 | Personoplysninger |
Student | Student | 0-1 | Elevoplysninger om personen Student, Employee og Extern udelukker gensidigt hinanden |
Employee | Employee | 0-1 | Ansat person Student, Employee og Extern udelukker gensidigt hinanden |
| Extern | Extern | 0-1 | Ikke-ansat person Student, Employee og Extern udelukker gensidigt hinanden |
Felt | Type | Antal | Beskrivelse |
| Role | Enum | 1-n | Den ansattes roller Vælges blandt følgende værdier: Lærer, Pædagog, Vikar, Leder, Ledelse, TAP eller Konsulent |
ShortName | String | 0-1 | Initialer |
Occupation | String | 0-1 | Stilling |
Location | String | 0-1 | Afdeling, bygning eller værelsesnummer på kostskoler |
GroupId | String | 0-n | De grupper medarbejderen er tilknyttet Feltet skal indeholde gruppernes unikke id på institutionen |
Felt | Type | Antal | Beskrivelse |
| Role | Enum | 1 | Den ikke-ansattes rolle En af værdierne: Ekstern eller Praktikant |
GroupId | String | 0-n | De grupper den eksterne medarbejder er tilknyttet Feltet skal indeholde gruppernes unikke id på institutionen |
Felt | Type | Antal | Beskrivelse |
| Role | Enum | 1 | Elevens Rolle En af værdierne: Barn, Elev eller Studerende |
StudentNumber | String | 0-1 | Elevens studienummer fra lokalt administrativt system |
Level | Enum | 1 | Elevens trin En af værdierne: DT, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, U1, U2, U3, U4, VU eller Andet DT er dagtilbud 1 svarer til 1. klassetrin i grundskolen U1 er første trin på en ungdomsuddannelse VU er voksenuddannelse |
Location | String | 0-1 | Afdeling, bygning eller værelsesnummer på kostskoler |
MainGroupId | String | 1 | Elevens hovedgruppe. For grundskoler elevens klasse og kan for andre institutioner for eksempel studieretning eller stamhold Feltet skal indeholde gruppens unikke id på institutionen MainGroiupId må kun referere til grupper med groupType ”Hovedgruppe” |
GroupId | String | 0-n | Yderligere grupper eleven er tilknyttet, ud over tilknytningen via MainGroupId. Feltet skal indeholde gruppernes unikke id på institutionen - GroupId. |
ContactPerson | Contact-Person | 0-10 | Kontaktperson |
Felt | Type | Antal | Beskrivelse |
relation | Enum | 1 | Kontaktpersonens relation til eleven En af værdierne: Mor, Far, Andet eller Officielt tilknyttet person |
childCustody | Bool | 1 | Har personen forældremyndighed? |
| accessLevel | Enum | 1 | Bruges til autorisation i tjenester En af værdierne: 1 eller 0 accessLevel=1 gives automatisk, hvis childCustody=yes Hvis childCustody=no, skal hjemmel opnås på anden vis |
Person | Person | 1 | Personoplysninger på kontaktpersonen |
Felt | Type | Antal | Beskrivelse |
protected | Bool | 1 | Har personen navne- og adressebeskyttelse |
verificationLevel | Enum | 1 | Er informationen vedrørende personen verificeret i CPR-registret En af værdierne: 1=CPR-verificeret, 0=uverificeret |
FirstName | String | 1 | Fornavne. Feltet skal mindst indeholde et bogstav - Særlige forhold ved unavngivne børn |
FamilyName | String | 1 | Efternavn. Feltet skal mindst indeholde et bogstav - Særlige forhold ved unavngivne børn |
CivilRegistrationNumber | String | 1 | Personnummer på formen DDMMYYXXXX |
EmailAddress | RegEx | 0-1 | |
BirthDate | String | 0-1 | Fødselsdato på formen YYYY-MM-DD |
Gender | Enum | 0-1 | Personens køn. En af værdierne: M eller K |
PhotoId | String | 0-1 | Reference til foto i kildesystemet |
Address | Address | 0-1 | Adresse |
HomePhoneNumber | PhoneNumber | 0-1 | Hjemmetelefon |
WorkPhoneNumber | PhoneNumber | 0-1 | Arbejdstelefon |
MobilePhoneNumber | PhoneNumber | 0-1 | Mobiltelefon |
AliasFirstName | String | 0-1 | Alias-fornavne som importeres i SkoleGrunddata ved navne og adresse-beskyttelse Feltet skal mindst indeholde et bogstav ved navne- og adressebeskyttelse Er feltet tomt, indsættes Alias-fornavn ved navne og adresse-beskyttelse ifm. importen |
AliasFamilyName | String | 0-1 | Alias-efternavn som importeres i SkoleGrunddata ved navne og adresse-beskyttelse Feltet skal mindst indeholde et bogstav ved navne- og adressebeskyttelse Er feltet tomt, indsættes Alias-efternavn ved navne og adresse-beskyttelse ifm. importen |
Felt | Type | Antal | Beskrivelse |
protected | Bool | 1 | Er telefonnummeret beskyttet |
(element value) | RegEx | 1 | Telefonnummer |
Felt | Type | Antal | Beskrivelse |
StreetAddress | String | 0-1 | Adressens vejnavn, nr. og etage |
PostalCode | String | 0-1 | Postnummer |
PostalDistrict | String | 0-1 | By |
CountryCode | String | 0-1 | Adressens landekode. i to tegn efter standarden ISO 3166-1 alpha-2. Fx DK |
Country | String | 0-1 | Adressens land |
MunicipalityCode | String | 0-1 | Kommunekode |
MunicipalityName | String | 0-1 | Kommunenavn |