MPASS

Se först till att fältet Statistikcentralens läroanstaltskod är ifyllt för de skolor som använder MPASS, i Information om skolan.

Aktiveringen av MPASS för Wilma sker i Inställningar-registret:

• MPASS inloggning i användning: kryssa i det här fältet för att aktivera MPASS, d.v.s. användarna kan logga in i tjänster som stöder MPASS med sina Wilma-koder.
• MPASS sökgränssnitt i användning: kryssa i fältet för att tillåta att gränssnittet används, d.v.s. att MPASS kan hämta data i JSON-format om användarna.

Testmiljö för MPASS

Det finns en testmiljö för MPASS där du bland annat kan reda ut eventuella inloggningsproblem. Mer info om tjänsten samt inloggningssidan hittar du här.

År 2023 skedde en ändring gällande MPASS-inloggningar, som förutsätter att studentnumret finns registrerat i Primus för studerande, lärare och personal.

För studerandenas del finns studentnumren i Primus i och med KOSKI-överföringarna. För lärare och personal kan de hämtas automatiskt från registret över studentnummer, såvida följande fält är ifyllda i Information om skolan för de skolor vars lärare och personal ska få studentnumren importerade:

• Studentnummerregistrets användarnamn: ange ett användarnamn som har tillräckliga rättigheter i Utbildningsstyrelsens gränssnittstjänst. I praktiken ett användarnamn som är specifikt skapat för studentnummerimporten eller så KOSKI-tjänstens användarnamn med utvidgade rättigheter.
• Studentnummerregistrets lösenord: fyll i lösenordet för användarnamnet i fråga. OBS! Det går inte att skriva in ett frågetecken (?) för hand i fältet. Ifall lösenordet innehåller ett frågetecken måste lösenordet kopieras och klistras in i fältet. På det sättet fås frågetecknet med.

Ta också fram fälten Studentnummer import ID och Studentnummer felmeddelande i registren Lärare och Personal. Fyll inte i någon data i de här fälten själv. I fältet Studentnummer import ID syns import-ID:t, ifall hämtningen ännu pågår eller att det uppstått ett fel vid importen. Om det uppstått ett fel vid importen kommer det närmare info om det i Studentnummer felmeddelande. Då allt är i skick syns inga uppgifter i fälten, utan båda är då tomma.

För att importen av studentnummer ska lyckas ska även följande vara i skick:

• Fältet Läroanstaltskod i Studieinfo är ifyllt i Information om skolan.
• Registren Lärare och Personal: de personer som använder MPASS har fälten Efternamn, Förnamnen, Tilltalsnamn och Personbeteckning ifyllda på kortet. Vid sökning används tilltalsnamnet bara om det är ett av förnamnen. Om det inte är ifyllt används det första av förnamnen.
• Lärarna och personalen har på rad 1 i sina Skola-fält en skola där de följande fälten är ifyllda: Läroanstaltskod i Studieinfo, Studentnummerregistrets användarnamn och Studentnummerregistrets lösenord.
• Fältet Testperson är ikryssat för testpersoner på deras kort i Lärare- och Personal-registren. Om fältet inte är ikryssat, uppkommer överflödig datatrafik och felmeddelanden när systemet försöker hämta studentnummer åt testpersonerna utan att lyckas. När fältet är ikryssat lämnas testpersonerna utanför studentnummerimporten. Fältet har ingen annan funktionalitet än att det används för just detta ändamål i studentnummerimporten.

När åtgärderna ovan är i skick fungerar importen av studentnumren automatiskt. Den automatiska importen körs en gång per dygn, vilket innebär att Studentnummer-fältet kompletteras i Primus för alla som saknar uppgiften i Lärare- och Personal-registren.

MPASS-inloggning är möjlig med studerandes, lärares och personalens Wilma-användarnamn.

MPASS-singelinloggning fungerar utan specialkonfigurationer också då Wilma-användarna har AD-lösen eller Wilma OpenID.

Om användaren kryssar i Kom ihåg mig på den här enheten i samband med MPASS-inloggningen, loggas användaren också automatiskt in i Wilma. Då fältet är ikryssat behöver man som användare alltså inte ange sina inloggningsuppgifter på nytt då man ska in i Wilma, förutsatt att Wilma-sessionen ännu är giltig. Fältet visas bara om användaren inte är inloggad i Wilma från förr. Observera att inställningen inte gäller OpenID-inloggning, utan endast inloggning med de vanliga Wilma-koderna.

När användaren identifieras, överförs det följande uppgifter till MPASS:

• Förnamn
• Tilltalsnamn
• Efternamn
• Roll. En användares roll inverkar på vilka funktioner och användarrättigheter användaren har.
  • För elever överförs automatiskt rollen "inlärare". För lärare överförs "lärare" och för personlen överförs
    "staff"
  • För lärare och personlamedlemmar kan du vid behov också välja en annan roll än den förvalda. I registren Lärare och Personal finns ett flerradigt fält där du kan tilldela en viss skolspecifik roll åt en person: MPASS roll på skolan. Det här fältet gäller tillsammans med Skola-fältet, alltså fungerar den valda rollen enbart med skolan på den aktuella raden. Då en användare jobbar på flera skolor, men det finns en tilldelad roll endast på en av skolorna, överförs den förvalda rollen lärare eller staff från Primus för de övriga skolorna. Om det är lärare eller staff som överförs beror på vilket register som personen står i.
• Studerandens klassuppgift (hämtas i första hand från Studerande-registrets fält Årskurs/Årsnivå, i andra hand från fältet Årskurs/Årsnivå på klassens registerkort i Klasser-registret)
• Har studeranden rätt till avgiftsfritt läromaterial eller inte (gäller endast andra stadiets studerande). Närmare detaljer om den här rätten finns längre ner i anvisningen.
• Studentnummer (för lärare, personal och studerande)
• E-postadress
• Mobilnummer
• Statistikcentralens läroanstaltskod

Hur uppgifterna överförs

• Om en användare har ett personligt Wilma-användarnamn (av ny typ), plockas förnamn, tilltalsnamn, efternamn, mobilnummer, e-postadress och studentnummer från användarens kort i Wilmas användarnamn-registret.
• Men om användaren har ett Wilma-användarnamn av gammal typ, tas informationen från personens registerkort i Lärare/Studerande/Personal-registret.
• Om situationen skulle vara den att läraren har ett personligt Wilma-användarnamn av ny typ, men studentnumret saknas på lärarens kort i Wilmas användarnamn-registret, hämtar Primus uppgifterna från lärarens kort i Lärare-registret i stället.

I samband med att andra stadiets studerande gör MPASS-inloggning överförs uppgiften om huruvida personen har rätt till avgiftsfritt läromaterial. För att uppgiften om rätten till avgiftsfrihet ska överföras, ska uppgiften finnas i Primus för de relevanta personerna. I praktiken förutsätter överföringen att följande fält är ifyllda Rätt till avgiftsfritt läromaterial börjar, Rätt till avgiftsfritt läromaterial slutar och Typ av studierätt (KOSKI).

Att fylla i uppgiften om avgiftsfrihet för studerande

1. Öppna Studerande-registret och hämta fram de relevanta personerna på andra stadiet som avgiftsfriheten gäller.
2. Rätt till avgiftsfritt läromaterial börjar: fyll i det datum från och med vilket personen har rätt till avgiftsfritt läromaterial.
3. Rätt till avgiftsfritt läromaterial slutar: Om du känner till detta datum kan du skriva in det. Lämna tomt annars.
4. Skola för avgiftsfritt läromaterial: Ange den skola där avgiftsfriheten gäller.

OBS! En studerande får inte förekomma flera gånger på en viss skola. Uppgiften om avgiftsfrihet är skolspecifik och en studerande kan inte ha flera perioder om avgiftsfrihet i en och samma skola.

Uppgiften överförs till MPASS

• I samband med MPASS-inloggning kontrollerar systemet huruvida personen är en andra stadiets studerande och om den har rätt till avgiftsfritt läromaterial.
• Systemet kontrollerar studerandens kort för att avgöra om det är fråga om en andra stadiets studerande. Om fältet Typ av studierätt (KOSKI) på studerandens kort är tomt, kontrollerar systemet sedan det motsvarande fältet på kortet för studerandens klass eller grupp. Om det också är tomt kontrolleras det motsvarande fältet på kortet för studerandens skola eller skolor. En person anses vara andra stadiets studerande om något av följande alternativ är valt i något av de ovannämnda fälten:  
  • Påbyggnad för grundläggande
  • Gymnasieförberedande
  • Yrkesinriktad
  • Gymnasium
  • IB-examen
  • Handleder för examensutbildning
• Om personen på basen av den här systemkontrollen är en andra stadiets studerande, kontrollerar Primus ännu om personen har rätt till gratis läromaterial. Den här rättigheten anses finnas om dessa två följande villkor uppfylls:
  • Det innevarande datumet (tidpunkten för MPASS-inloggningen) infaller i intervallet som bildas av fälten Rätt till avgiftsfritt läromaterial börjar och Rätt till avgiftsfritt läromaterial slutar OCH
  • den skola som står i studerandens Skola-fält också finns i fältet Skola för avgiftsfritt läromaterial. Fältet Rätt till avgiftsfritt läromaterial slutar får även stå tomt.

Färdiga funktioner som relaterar till avgiftsfriheten

I Studerande-registret finns två standardfunktioner som du kan använda för att hämta fram informationen om andra stadiet och om gratis läromaterial. Det här kan behövas t.ex. om MPASS-integrationen använder den egna AD:n och ni behöver vetskap om rätten till avgiftsfritt läromaterial för PrimusQuery-överföringarna. De två funktionerna är följande:

• Andra stadiets studerande: Hämtar fram de studerande som på basen av fältet Typ av studierätt (KOSKI) tillhör andra stadiet.
• Rätt till avgiftsfritt läromaterial på andra stadiet.Datum.Skola: Hämtar på basen av datumet och skolan fram de personer som har rätt till gratis läromaterial. Funktionen är programmerad så att den kontrollerar fälten Rätt till avgiftsfritt läromaterial börjar, Rätt till avgiftsfritt läromaterial slutar och Skola för avgiftsfritt läromaterial. Det går att lämna fältet Rätt till avgiftsfritt läromaterial slutar tomt.

Våra kunder som använder MPASS-tjänsten bestämmer själva om det överförs uppgifter om personer som har spärrmarkering från Primus till MPASS-tjänstens sökgränssnitt eller ej. För detta ändamål finns fältet Tillåt MPASS för personer med spärrmarkering i registret Information om skolan. Om man kryssar i fältet, överförs också de spärrmarkerade personernas uppgifter, dvs. även de kan använda MPASS-tjänsten. Fältet är inte skolspecifikt, dvs. det ska kryssas i endast på kort nummer 1, och samma inställning påverkar alla skolor. Som standard är fältet inte ikryssat, dvs. spärrmarkerade personer kan inte använda MPASS-tjänsten. Visma kan inte å kundens vägnar bestämma om uppgifter om spärrmarkerade personer överförs till MPASS-tjänsten eller inte.

Inställningen i fältet Tillåt MPASS för personer med spärrmarkering påverkar alla personer som har en giltig spärrmarkering antecknad i Primus. I Primus kan man alltså inte definiera att en enskild person med spärrmarkering kan använda MPASS-tjänsten och andra inte. Spärrmarkeringen kan vara antecknad för studerandena själva men därtill också för studerandens vårdnadshavare och nära anhöriga, sökande, lärare och personal.

• En studerande har spärrmarkering om fältet Spärrmarkering är ikryssat i Studeranderegistret eller om spärrmarkering är i kraft enligt datum i fälten Spärrmarkering fr.o.m. och Spärrmarkering upphör.
• Vårdnadshavares och anhörigas spärrmarkering kontrolleras enligt samma logik i fälten Anhörig har spärrmarkering, Spärrmarkering för anhörig fr.o.m. och Spärrmarkering för anhörig upphör.
• En lärare har spärrmarkering, om spärrmarkeringen är i kraft enligt datum i fälten Spärrmarkering fr.o.m. och Spärrmarkering upphör i Lärare-registret. När det gäller personal och sökande, kontrolleras spärrmarkeringen i motsvarande fält i registren Personal och Sökande.