Import webservicen anvendes til at overføre data om brugere og grupper på en institution til SkoleGrunddata.
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.
Tabel over felter og attributter
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.
UNILoginImport
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
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
Group
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
Student, Employee og Extern kan tilknyttes gruppen ved at angive MainGroupId eller GroupId på personens aktør
Gruppeid'et er unikt og uforanderligt i hele sin levetid på institutionen
Fx: "2016a"
Må ikke indeholde personnavne
GroupName
String
0-1
Gruppens navn
Vises til brugere
Må ikke indeholde personnavne
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”
Må ikke indeholde personnavne
FromDate
Date
0-1
Gruppens startdato på formen YYYY-MM-DD
ToDate
Date
0-1
Gruppens slutdato på formen YYYY-MM-DD
InstitutionPerson
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
Employee
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
Extern
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
Student
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
ContactPerson
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
Person
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
Som led i importen straksoprettes brugerne i Unilogin IdP og de vil kunne anvende andre IdP'er via Unilogin Broker.
Oprettede grupper anvendes i skolernes infrastruktur og af udbydere i forbindelse med tildeling af adgang til tjenester. Det er derfor vigtigt at koordinere grupper 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 brugeroplysninger og grupper på en institution kan kortlægges med ws17/wsiEKSPORT, som importleverandører automatisk har adgang til, når der er givet adgang til ws10/wsaIMPORT.
Fuld import til SkoleGrunddata. Anvendes første gang der importeres data, eller når man vil sikre sig, at data er fuldstændig i synk. Her overføres alle brugere hver gang.
Delta-import til SkoleGrunddata. Det kan enten være nye brugere eller ændringer til eksisterende brugere. Der overføres kun de ændrede brugere. Anvendes som den primære importmetode.
Delta-sletning af Brugere i SkoleGrundata. Anvendes sammen med delta-import til vedligehold af brugerbasen. Alternativt kan brugere slettes via fuld import.