- Information till huvudmän med lägre elevantal
- Om standarden SS 12000
- Alternativ 1: Skolverket hämtar data – provisionering enligt standarden SS 12000
- Alternativ 2: Data skickas till Skolverket med provisionerings-API
- Alternativ 3: Filinläsning
- Hantera och uppdatera användare
- Uppgifter som behöver överföras till Skolverket
- Autentisering vid maskinell överföring
- När behöver uppgifterna finnas tillgängliga på Skolverket?
- Skyddade personuppgifter
- Ansvar för personuppgiftsbehandling i provtjänsten
- Film: De olika metoderna för överföring av uppgifter (tid 11:52 minuter)
- Film: Föra över uppgifter via filinläsning (tid 23:22 minuter)
- Senaste uppdateringarna på den här sidan
Överföring av uppgifter till Skolverket
Innan era skolor kan genomföra digitala nationella prov behöver ni som huvudman föra över uppgifter om era användare till Skolverkets provtjänst. Här kan ni läsa om förutsättningarna för att kunna föra över uppgifterna samt om de olika lösningarna för överföring, så att ni kan välja vad som passar er verksamhet bäst.
För att lärare och elever ska kunna logga in och genomföra prov i Skolverkets provplattform måste ni som huvudman se till att deras uppgifter förs över (provisioneras) till Skolverket i god tid före provgenomförandet. Det finns tre olika sätt att föra över uppgifterna på. Ni administrerar överföringen via Skolverkets e-tjänst Administration provtjänsten.
Observera att ett krav för att kunna föra över uppgifter till Skolverket är att ni först har gett minst ett ombud för huvudmannen fullmakt att hantera skyddade personuppgifter. Ombudet måste även ha registrerat en e-postadress för mottagande av viktig information gällande skyddade personuppgifter.
Information till huvudmän med lägre elevantal
Alternativ 1 och 2 kräver kapacitet att kunna sätta upp den teknik som krävs, men uppdateringar av uppgifterna sker sedan automatiskt. Filinläsning kräver ingen teknisk lösning av huvudmannen, men en del manuellt arbete samt goda rutiner för att vid behov manuellt uppdatera uppgifterna.
Om standarden SS 12000
För att säkerställa att nödvändig information ska kunna föras över mellan huvudman och Skolverket på ett effektivt, säkert och automatiserat sätt rekommenderar Skolverket standarden SS 12000.
Alternativ 1: Skolverket hämtar data – provisionering enligt standarden SS 12000
Detta alternativ innebär att ni som huvudman samlar ihop relevanta uppgifter och tillgängliggör dem enligt datamodellen i standarden SS 12000. Då kan Skolverket automatiskt hämta data från er server. Genom en prenumeration kommer Skolverkets server att veta när det finns data att hämta. Skolverket tillämpar standarden SS 12000.
För att klienterna och servrarna ska kunna utbyta information behövs autentisering. Det sker via ömsesidig autentisering med mTLS (mutual Transport Layer Security) – en lösning som Skolverket erbjuder och vidareutvecklar kontinuerligt.
Diskussionsforum om SS 12000, eID i skolan (kräver inlogg)
Länk till annan webbplats.
Alternativ 2: Data skickas till Skolverket med provisionerings-API
Detta alternativ innebär att ni som huvudman samlar ihop de uppgifter som Skolverket behöver och som sedan skickas från er klient till Skolverkets provisionerings-API (Application Program Interface).
De uppgifter som förs över till Skolverket ska följa datamodellen i standarden SS 12000. Skolverket validerar om uppgifterna har förts över på ett korrekt sätt utifrån datamodellen.
För att klienten och servern ska kunna utbyta information behövs autentisering. Det sker via ömsesidig autentisering med mTLS.
API-specifikation för Provisionerings-API, GitHub Länk till annan webbplats.
Alternativ 3: Filinläsning
För de huvudmän som saknar möjlighet till automatiserad överföring kan manuell filinläsning vara ett alternativ. Detta alternativ kräver ingen teknisk lösning av huvudmannen men en del manuellt arbete. Det kräver även goda rutiner för att vid behov manuellt uppdatera uppgifterna. Filinläsning innebär att ni som huvudman samlar de uppgifter som krävs i en fil som sedan läses in via Skolverkets e-tjänst Administration provtjänsten. Vid varje förändring av uppgifter, till exempel om en elev eller personal tillkommer, måste filen uppdateras och läsas in manuellt igen.
Filinläsning är lämpligare om man har behov av att föra över ett lägre antal elever, till exempel en eller ett par klasser. Vid ett större antal kan den innebära risk för fel. Skolverket har ingen definition av vad ett lägre elevantal innebär. Varje huvudman måste själv utifrån sina tekniska och organisatoriska förutsättningar avgöra vilken lösning för överföring som ska väljas.
Instruktion för att föra över uppgifter med filinläsning
- Ladda ned Excel-mallen för filinläsning och fyll i den med de uppgifter som krävs. Samtliga uppgifter som krävs finns listade i fliken ”Läs mig först” i filmallen. Vissa av uppgifterna kan vara nya och behöver då tas fram av huvudmannen. Läs noga vad som gäller för respektive uppgift.
- Ombudet som har fullmakt att föra över uppgifter loggar in i Skolverkets e-tjänst Administration provtjänsten och för över den ifyllda Excel-filen.
- Vid överföringen kontrollerar Skolverket att uppgifterna i filen följer vissa formella krav. Skolverket kan dock inte kontrollera att uppgifterna är korrekta eller fullständiga. På skolverkets webbsida om Administration provtjänsten finns mer information om inläsning av fil och de eventuella felkoder som kan uppstå. Där finns även en film som visar förloppet.
- Spara filen för framtida uppdateringar. Vid varje förändring är det viktigt att ni ändrar i den befintliga filen och läser in hela filen igen.
Observera att alla elever och lärare som ska ingå i en ämnesgrupp eller undervisningsgrupp måste vara med i respektive blad vid varje inläsningstillfälle. Detta innebär att både befintliga och nya elever och lärare ska finnas i bladen "Elevinskrivningar" och "Personaltjänstgöringar" för varje inläsningstillfälle, och att uppgifterna ska spegla skolenhetens elevregister för provgenomföranden. Om klassinformation är specificerad i bladet "Klasser" ska alla elever som ingår i klassen även finnas med i bladet om elevinskrivningar vid varje inläsningstillfälle.
Hantera och uppdatera användare
Efter att ni har fört över uppgifter till Skolverket är det möjligt att hantera och uppdatera användare i provtjänsten. Men innan dess är det viktigt att känna till vad det innebär och vilka regler som ni behöver förhålla er till.
Uppgifter som behöver överföras till Skolverket
Uppgifter om vem användaren är och vilken roll den har på skolan måste finnas i provplattformen före provgenomförandet. Om uppgifterna finns på olika ställen behöver ni som huvudman sammanställa dessa innan de förs över till Skolverket. Eftersom uppgifterna behöver uppdateras vid förändringar kommer ni behöva föra över uppgifter till Skolverket upprepade gånger. Observera att provplattformen rensas från uppgifter under sommaren och att uppgifterna därför behöver föras över på nytt inför varje läsår.
Uppgifter om skolenhet
Elever kan bara tillhöra en skolenhet medan personal kan tillhöra flera skolenheter. Personal som ska hantera elever och deras prov måste dock tillhöra samma skolenhet som eleverna.
Om huvudmannen har skolverksamhet med flera skolenheter kan personalen behöva föras över med kopplingar till alla de enheter där de har tjänstgöring.
Användares personalkategori vid överföring styr vilken automatiskt tilldelad roll de får i provplattformen. När användarnas uppgifter har förts över kan skolan manuellt tilldela dem ytterligare roller i provplattformen.
Personalkategori angiven vid överföringen | Automatiskt tilldelade roller och behörigheter på skolnivå i Skolverkets provplattform |
|---|---|
Rektor | Rektor (rollen har alla behörigheter i provplattformen) |
Skoladministratör | Skoladministratör (rollen har alla behörigheter i provplattformen) |
Lärare, förstelärare | Lärare (rollen har samma behörigheter som Provledare och Bedömare. Har även behörighet att se och exportera resultat för kopplade elevgrupper) |
Alla övriga personalkategorier | Övrig skolpersonal (rollen saknar behörigheter i provplattformen) |
Du hittar mer information om roller och hur de fördelas på sidan om roller i provplattformen.
Uppgifter om ämneskoder
Om ni skickar uppgifter eller om Skolverket hämtar uppgifter från er via API behöver det administrativa systemet vara uppdaterat med korrekta id för ämneskoderna för attributet provaktivitet (parentActivity.id) innan uppgifterna överförs till Skolverket. Tillåtna värden för id och ämneskod kan hämtas från Skolverkets ”Open Data API”.
Om din skola eller dina skolor överför användaruppgifter via fil behöver du ange den specifika ämneskoden när du laddar upp filen i Administration provtjänsten. Ämneskoden anges i kolumnen provaktivitetsnamn på raden för varje ämnesgrupp.
Här hittar du en utförligare beskrivning av ämneskoderna i SO- och NO-ämnen samt Moderna språk.
En del grundskolor, sameskolor och specialskolor grupperar ämnena biologi, fysik och kemi som NO samt historia, geografi, religion och samhällskunskap som SO i sina skoladministrativa system. Dessa gruppbeteckningar kommer inte att godkännas när ni som huvudman överför uppgifter om elevernas undervisningsgrupper till provtjänsten. Det beror på att eleverna skriver prov i varje enskilt ämne. Eleverna behöver därför tillhöra undervisningsgrupper med rätt specifik ämneskod för sin årskurs. Om din skola använder gruppbeteckningarna NO och SO i dag i de årskurser som genomför betygsstödjande bedömningsstöd eller nationella prov måste dessa ändras till ämneskoder i de data som överförs till Skolverket.
Ni behöver se till att alla elever i årskurs 6 och 9 i grundskolan och sameskolan samt årskurs 7 och 10 i specialskolan tillhör undervisningsgrupper med följande ämneskoder.
Specifika ämneskoder för NO-ämnen, grundskola årskurs 6 och 9:
- Biologi årskurs 6: GRGRBIO01_6
- Biologi årskurs 9: GRGRBIO01_9
- Kemi årskurs 6: GRGRKEM01_6
- Kemi årskurs 9: GRGRKEM01_9
- Fysik årskurs 6: GRGRFYS01_6
- Fysik årskurs 9: GRGRFYS01_9
Specifika ämneskoder för SO-ämnen, grundskola årskurs 9:
- Geografi: GRGRGEO01_9
- Historia: GRGRHIS01_9
- Religionskunskap: GRGRREL01_9
- Samhällskunskap: GRGRSAM01_9
Specifika ämneskoder för SO-ämnen, specialskola årskurs 10:
- Geografi: GRSPGEO01_10
- Historia: GRSPHIS01_10
- Religionskunskap: GRSPREL01_10
- Samhällskunskap: GRSPSAM01_7, GRSPSAM01_10
Specifika ämneskoder för NO-ämnen, specialskola årskurs 10:
- Biologi: GRSPBIO01_10
- Kemi: GRSPKEM01_10
- Fysik: GRSPFYS01_10
I årskurs 9 och på gymnasiet finns det möjlighet att genomföra betygsstödjande bedömningsstöd i Moderna språk. Det har tidigare funnits en otydlighet kring ämneskoden för Tyska i årskurs 9 och Tyska steg 2 i gymnasieskolan. För att överföringen av uppgifter ska fungera behöver ni därför se till att alla elever i årskurs 9 i grundskolan samt kurs 2 i gymnasieskolan tillhör undervisningsgrupper med följande ämneskoder.
Specifika ämneskoder för Moderna språk, grundskola årskurs 9:
- Franska: GRGRMSP01FRA_9
- Spanska: GRGRMSP01SPA_9
- Tyska: GRGRMSP01DEU_9
Specifika ämneskoder för Moderna språk steg 2, gymnasiet:
- Franska: MODFRA02_GY
- Spanska: MODSPA02_GY
- Tyska: MODDEU02_GY
Attributlista
Vår attributlista för provisionering gäller för alternativ 1 och 2, det vill säga provisionering enligt standarden SS 12000 och provisionerings-API. Listan finns både som pdf och i Excelformat. I attributlistan finns federationsanvändarnamn EPPN (eduPersonPrincipalName) som är en unik identifierare som kopplar en persons inloggning i skolan till en användare i provplattformen.
För alternativ 3, Filinläsning, gäller de attribut som anges i filinläsningsmallen.
Autentisering vid maskinell överföring
För att alla uppgifter ska föras över säkert till Skolverket används autentisering mellan servrar och klienter. Vi har tagit fram ett särskilt API som utfärdar en så kallad auktoriseringstoken till klienter efter autentisering.
Du som huvudman måste uppfylla ett av följande krav för att kunna överföra uppgifter till Skolverket:
- Ansluta dig till en TLS-federation som är ansluten till Fidus och se till att ert klientcertifikat är med i TLS-federationens metadataregister.
- Skaffa ett klientcertifikat från en certifikatutfärdare som är godkänd av Fidus.
Oavsett vilket sätt du som huvudman väljer, måste klientcertifikatet ha en koppling till huvudmannens organisationsnummer. Varje huvudman måste alltså ha minst ett klientcertifikat.
När behöver uppgifterna finnas tillgängliga på Skolverket?
Skolans huvudman behöver föra över fullständiga och korrekta uppgifter för elever och personal i god tid innan ett prov ska genomföras. Det gör ni i Administration provtjänsten. Vi rekommenderar att ni för över uppgifterna cirka 60 dagar, men allra senast 30 dagar, innan provtillfället. Då får vi på Skolverket aktuella uppgifter samtidigt som det finns tid att upptäcka och rätta till eventuella fel. Det minskar också risken för att eleverna och skolpersonalen får problem när de ska logga in i provplattformen. Det är dock möjligt att föra över uppgifter samlat, till exempel i början av terminen eller en gång varje kalenderhalvår, om det passar er organisation bättre.
Om det finns särskilda skäl kan ni lämna uppgifter om en enskild elev eller skolpersonal senare än 30 dagar före provet. Särskilda skäl innebär till exempel att en elev byter skola, att skolpersonal drabbas av sjukdom eller att något oväntat händer som skolan inte har kunnat förutse. Sådana ändringar kan ni göra senast sju kalenderdagar före provtillfället.
För kommunal vuxenutbildning på gymnasial nivå är vår rekommendation att ni överför uppgifterna till Skolverket senast sju dagar före provtillfället.
Skyddade personuppgifter
Från hösten 2024 kan provtjänsten ta emot skyddade personuppgifter, samordningsnummer och tillfälliga personnummer för både elever och skolpersonal. Huvudmannen kommer att behöva göra aktiva val kring hur personuppgifter ska skyddas vid provgenomförandet. Mer information om det och vilka val som måste göras hittar ni på sidan om att hantera skyddade personuppgifter i provtjänsten.
Ansvar för personuppgiftsbehandling i provtjänsten
Eftersom huvudmännen och Skolverket har självständiga uppdrag vid digitala nationella prov har båda parterna rättsligt stöd att utföra nödvändiga personuppgiftsbehandlingar i provtjänsten. Det är viktigt att känna till hur fördelningen av ansvaret ser ut.
Ansvar för personuppgiftsbehandling i Skolverkets provtjänst
Film: De olika metoderna för överföring av uppgifter (tid 11:52 minuter)
Film: Föra över uppgifter via filinläsning (tid 23:22 minuter)
Senaste uppdateringarna på den här sidan
- 2025-04-11: Nytt avsnitt om att hantera användare i provtjänsten.
- 2025-02-18: Utförlig beskrivning av ämneskoder för moderna språk.
- 2025-02-17: Ny version (1.5.3) av mallen för överföring av uppgifter via filinläsning.
- 2025-02-03: Ny film som går igenom hur du fyller i mallen för filinläsning.
- 2025-02-03: Uppdaterat avsnittet om filinläsning med en instruktion för att underlätta för er som väljer filinläsning som metod för att föra över uppgifter.