OneRoster är en standard som tagits fram och underhålls av IMS Global. OneRoster är, enligt IMS Global, en omarbetning av LIS - Learning Information Services för att även inkludera behov inom grund- och gymnasieutbildning. Jämfört med LIS så har datamodellen förenklats, vilket kan vara både en fördel och en nackdel. Teknologimässigt så innebär OneRoster en övergång till REST-tjänster isället för LIS SOAP-tjänster.
OneRoster har specifierat två olika typer av interaktioner. Dels en asynkron batchorientera överföring av CSV-filer och dels ett REST-API.
APIet är specificerat som ett traditionellt REST-API och bygger på HTTP som protokoll och JSON som format.
De definierad REST-resurserna inom OneRoster är grupperade i tre grupper; Rosterning, Resources och Gradebook. Inom respektive grupp är det specificerat vilka REST-resurser som ingår i respektive grupp samt vilka HTTP-metoder som ska stödjas för respektive resurs. Noterbart är att man enbart specificerat implementation av GET-metoden för samtliga resurse inom gruppen Rostering. OneRoaster-specifikation inkluderar vilka säkerhetsmekanisker som ska implementeras som del av APIet. Av integritets skäl ska Transaction Layer Security (TLS) användas samt OAUTH för autentisering och signering.
Specifikationen av CSV-interaktionen beskriver formatet för de olika filtyperna samt att dessa ska levereras i form av ZIP-filer. CSV-specifikationer inkluderar inga specifika krav på hur själva filöverföringen ska gå till. Det är det upp till de integrerande system att komma överens om.
OneRoster tillhandahåller inga tekniska artefakter i form av scheman, swagger-definitioner eller liknande. Specifikationerna består endast av textuell dokumentation. Dokumentationen är, i likhet med LIS, inte helt lättläst och det kan vara svårt att ta till sig innehållet. Frånvaron av tekniska artefacter som definerar de ingående interfacen kan försvåra en implementation.
OneRoster-specifikationen beskriver hur utökningar ska hanteras. Dessa utökningar placeras i attributet "metadata", vilket ingår i basklassen som samtliga klasser ärver. I "metadata" representeras utökningarna, i likhet med LIS, som en lista av nyckel-värde par med de begränsningar som detta innebär med avseende på repeterande element etc. Denna utökningsbarhet är dock endast applicerbar på REST-implementationen. För CSV-implementationen finns ingen utökningsbarhet definierad.
OneRoster har på entitetsnivå en relativt god täckningsgrad, med ett viktigt undantag, jämfört med behovet ur ett Ladok-perspektiv. Det viktiga undantaget är att det inte finns någon godtagbar representation av nivån studieperiod inom ett utbildningstillfälle. På attribut nivå är det relativt tydligt att målgruppen för standarden inte i huvudsak är högre utbildning utan utbildning på grund- och gymansieskolenivå.
Document/reference | Link |
---|---|
UML Class diagram (Visio) | OneRoster UML ClassDiagram.vsdx |
Web site | https://www.imsglobal.org/activity/onerosterlis |
Ladok entity mapping | LadokEntityMapping OneRoster.vsdx |