Introduktion
Skolon har stöd för att läsa in användare, skolmedlemskap och gruppmedlemskap via en IMS formaterad XML-fil. För att det ska fungera korrekt behöver filen schemaläggas att skickas in till Skolon efter önskad tidsintervall och vara formaterad enligt IMS formatet.
Filen ska innehålla tre typer av objekt:
Personobjekt: Innehåller all information om en användare
Gruppobjekt: Innehåller gruppnamn och id
Gruppmedlemskapsobjekt: Innehåller en lista på id som ska vara kopplade till en grupp.
Skolons användarprovisioneringsspecifikation
Person
Beskrivning
En person representerar en lärare (eller liknande befattning) eller en elev. Användare måste tillhöra minst en klass eller undervisningsgrupp (via gruppmedlemskapsobjektet) för att läsas in till Skolon. Elever kan bara tillhöra en (1) klass.
Egenskaper
Namn | Beskrivning | Krav |
sourcedid.id | Ett unikt ID för en person | Ja |
name.fn | Hela formaterade namnet | Ja |
name.n.family | Efternamn | Ja |
name.n.given | Förnamn | Ja |
Epost | Ja | |
tel | Telefonnummer | Nej |
tel.telType | Vilken typ av telefon. Antingen Voice, Mobile eller Work | Nej |
adr.street | Gatuadress | Nej |
adr.locality | Stad | Nej |
adr.pcode | Postnummer | Nej |
institutionrole.primaryrole | Är detta personens huvudroll, Yes eller No | Nej |
institutionrole.institutionroletype | Personens roll. Antingen Staff, Instructor eller Student | Ja |
extension.birthdate | Födelsedatum | Nej |
extension.yeargroups | Skolform och årskurs | Nej, men krävs för DNP |
| extension.ssn | Födelsedatum enligt format yyyyMMDDxxxx | Nej, men krävs för DNP |
| extension.eppn | eduPersonPrincipalName. Se närmare information om eppn på Skolverkets hemsida | Nej, men krävs för DNP |
| extension.educationcode | Studievägskod. Skall vara 2-9 tecken. Exempel: NBVAMVL. Endast för gymnasie. | Nej, men krävs för DNP (gymnasieskolor). |
Värdeförråd
yeargroup
Giltiga värden för yeargroup är 0-10.
schoolType
FS Förskola
FKLASS Förskoleklass
FTH Fritidshem
OPPFTH Öppen fritidsverksamhet
GR Grundskola
GRS Anpassad grundskola
SP Specialskola
SAM Sameskola
GY Gymnasieskola
GYS Anpassad gymnasieskola
KOMVUX Kommunal vuxenutbildning på grundläggande och gymnasial nivå
SARVUX Särskild utbildning för vuxna
SFI Kommunal vuxenutbildning i svenska för invandrare
KU Kulturskola
YH Yrkeshögskola
FHS Folkhögskola
STF Studieförbund
KKU Konst- och kulturutbildning
HS Högskola
ABU Arbetsmarknadsutbildning
AU Annan undervisning
Grupp
Beskrivning
En grupp kan vara antingen en skola, klass, undervisningsgrupp eller någon annan form av användargupp. Varje grupp måste tillhöra en skola.
Egenskaper
Namn | Beskrivning | Krav |
sourcedid.id | Ett unikt ID för gruppen | Ja |
description.short | Gruppens namn | Ja |
grouptype.typevalue | Gruppens typ.
| Ja |
relationship.sourcedid.id | sourcedid.id beskriver ägaren av gruppen. Oftast en skola. | Ja |
Gruppmedlemskap
Beskrivning
Ett gruppmedlemskapsobjekt beskriver vilka personobjekt som tillhör en grupp. Ett medlemskapsobjekt kan (och borde) innehålla flera medlemmar (members).
Egenskaper
Namn | Beskrivning | Krav |
sourcedid.id | ID för det gruppobjekt vilket detta medlemsobjekt beskriver medlemmarna för | Ja |
member.sourcedid.id | ID för personobjektet som ska vara medlem i gruppen | Ja |
Svenska