MPASS

Varmista ensin, että Koulun tiedot -rekisterissä on täytetty Tilastokeskuksen oppilaitoskoodi -kenttä MPASSia käyttävien koulujen rekisterikorteille.

Wilman MPASS-tuki otetaan käyttöön Asetukset-rekisterissä:

• MPASS kirjautuminen käytössä -kentän rastimalla otetaan MPASS-tuki käyttöön eli sallitaan käyttäjen kirjautuminen MPASS-tuettuihin palveluihin Wilma-tunnuksilla.
• MPASS hakurajapinta käytössä -kentän rastimalla sallitaan hakurajapinnan käyttö, eli MPASS voi hakea JSON-muotoista tietoa käyttäjistä.

MPASSin testipalvelu

MPASSilla on testipalvelu, joka mm. auttaa selvittämään mahdollisia kirjautumiseen liittyviä ongelmia. Lisätietoa palvelusta ja kirjautumissivun löydät täältä.

MPASS-kirjautumiseen tuli vuonna 2023 muutos, joka edellyttää oppijanumeron löytymistä Primuksesta opiskelijoilta, opettajilta ja henkilökunnalta.

Oppijanumerot löytyvät Primuksesta opiskelijoilta Koski-siirron vuoksi. Opettajille ja henkilökunnalle ne saa automaattisen haun kautta Oppijanumerorekisteristä, kunhan Koulun tiedot -rekisterissä on täytettynä seuraavat kentät niille kouluille, joiden opettajille ja henkilökunnalle oppijanumerot halutaan hakea:

• Oppijanumerorekisteri tunnus -kenttään tulee täyttää tunnus, jolla on riittävät oikeudet OPH:n rajapintapalveluun, eli käytännössä oppijanumerohakua varten luotu tunnus tai Koski-palvelun tunnus, jonka oikeuksia on laajennettu (lisätietoa Communityssä).
• Oppijanumerorekisteri salasana -kenttään tulee täyttää kyseisen tunnuksen salasana. Huom. Kenttään ei voi käsin täyttää kysymysmerkkiä (?), joten jos salasanassa on kysymysmerkki, tulee salasana kopioida ja liittää kenttään. Tällöin kysymysmerkki tulee mukaan.

Lisäksi Opettajat- ja Henkilökunta-rekistereissä tulee ottaa esiin kentät Oppijanumero tuontitunnus ja Oppijanumero virheviesti. Näihin kenttiin ei kuitenkaan pidä täyttää itse käsin mitään. Oppijanumero tuontitunnus -kentässä näkyy tuontitunnus, jos oppijanumerohaku on kesken tai haussa on tapahtunut jokin virhe. Mahdollisesta virheestä tulee lisätietoa Oppijanumero virheviesti -kenttään. Normaalitilanteessa molemmat kentät ovat tyhjiä.

Muut oppijanumerohaun edellyttämät vaatimukset:

• Koulun tiedot -rekisterin Oppilaitoksen tunniste Opintopolkuun -kenttä on täytetty.
• Opettajat- ja Henkilökunta-rekisterissä on täytettynä MPASSia käyttävien henkilöiden korteille kentät Sukunimi, Etunimet, Kutsumanimi ja Henkilötunnus. Kutsumanimeä käytetään haussa vain, jos se on yksi etunimistä. Jos se on täyttämättä, käytetään ensimmäistä etunimeä.
• Opettajien ja henkilökunnan korttien Koulu-kentän 1. riviltä löytyy koulu, jolla kentät Oppilaitoksen tunniste Opintopolkuun, Oppijanumerorekisteri tunnus ja Oppijanumerorekisteri salasana on täytetty.
• Opettajat- ja Henkilökunta-rekistereissä on rastittu Testihenkilö-kenttä testihenkilöiden korteille. Jos kenttää ei ole rastittu, aiheutuu järjestelmiin tarpeetonta datansiirtoa ja virheilmoituksia, kun testihenkilöille yritetään turhaan hakea oppijanumeroita. Kun kenttä on rastittu, testihenkilöt jätetään oppijanumerohausta pois. Kenttä ei vaikuta muuhun kuin oppijanumerohakuun.

Yllä mainittujen toimenpiteiden myötä oppijanumeroiden automaattihaku on käytössä. Automaattinen haku ajetaan kerran vuorokaudessa, jolloin oppijanumerot täydentyvät Opettajat- ja Henkilökunta-rekisterien Oppijanumero-kenttään niille, joilta se vielä puuttuu Primuksesta.

MPASS-kirjautuminen onnistuu opiskelijoiden, opettajien ja henkilökunnan Wilma-tunnuksilla.

MPASS-kertakirjautuminen toimii ilman erityiskonfiguraatiota silloinkin, kun Wilma-käyttäjillä on AD-tunnukset tai kun käytössä on Wilma OpenID -palvelu.

Jos käyttäjä rastii MPASS-kirjautumisen yhteydessä Muista minut tällä laitteella -kentän, käyttäjä kirjataan samalla automaattisesti sisään Wilmaan. Käyttäjän ei siis tarvitse syöttää Wilmaan mennessään tunnuksiaan uudelleen, kunhan Wilma-istunto on vielä voimassa. Kenttä näkyy vain, jos käyttäjä ei ole kirjautumishetkellä valmiiksi sisäänkirjautuneena Wilmaan. Tämä asetus ei koske OpenID-kirjautumista vaan pelkästään tavallisilla Wilma-tunnuksilla kirjautumista.

Käyttäjästä siirtyy MPASSiin tunnistuksen yhteydessä seuraavia tietoja:

• Etunimi
• Sukunimi
• Rooli (oppilas/opettaja/henkilökunta). Rooli siirtyy automaattisesti oikein sen perusteella, missä rekisterissä henkilön tiedot ovat Primuksessa. Lisäksi Opettajat- ja Henkilökunta-rekistereissä on MPASS rooli koululla -kenttä, johon voi valita koulukohtaisen roolin käyttäjälle, mutta tästä kentästä ei vielä toistaiseksi siirry tieto MPASSiin.
• Opiskelijan luokkatieto (ensisijaisesti katsotaan Opiskelijat-rekisterin Luokka-aste/Vuositaso-kentästä, toissijaisesti opiskelijan Luokat-rekisteristä opiskelijan luokan kortilta kentästä Luokka-aste/Vuositaso)
• Tieto siitä, onko opiskelijalla oikeus maksuttomaan oppimateriaaliin vai ei (koskee vain toisen asteen opiskelijoita). Lisätietoa oikeuden siirtymisestä on alempana tässä ohjeessa.
• Oppijanumero (opettajilta, henkilökunnalta ja opiskelijoilta)
• Henkilötunnus (salattuna)
• Sähköpostiosoite
• Matkapuhelinnumero
• Tilastokeskuksen oppilaitoskoodi

Tietojen siirtyminen

• Jos käyttäjällä on uudentyyppinen Wilma-tunnus, katsotaan etunimi, sukunimi, matkapuhelinnumero, sähköpostiosoite, henkilötunnus ja oppijanumero Wilman käyttäjätunnukset -rekisteristä käyttäjän kortilta.
• Jos taas käyttäjällä on vanhantyyppinen Wilma-tunnus, tiedot katsotaan henkilön kortilta Opettajat/Opiskelijat/Henkilökunta-rekistereistä.
• Jos kuitenkin esim. opettajalla olisi uudentyyppinen Wilma-tunnus, mutta hänen kortiltaan Wilman käyttäjätunnukset -rekisteristä puuttuisi henkilötunnus ja oppijanumero, Primus osaa katsoa nämä tiedot Opettajat-rekisteristä opettajan kortilta.

Toisen asteen opiskelijoiden MPASS-kirjautumisen yhteydessä siirtyy tieto siitä, onko opiskelijalla oikeus maksuttomaan oppimateriaaliin vai ei. Jotta tieto maksuttomuusoikeudesta siirtyisi, on maksuttomuustieto merkittävä ensin Primukseen niille opiskelijoille, joilla on oikeus maksuttomaan oppimateriaaliin. Käytännössä maksuttomuustiedon siirtyminen edellyttää kenttien Oikeus maksuttomaan oppimateriaaliin alkaa, Maksuttoman oppimateriaalin koulu ja Opiskeluoikeuden tyyppi (KOSKI) täyttämistä.

Maksuttomuustiedon merkitseminen opiskelijoille

1. Hae Opiskelijat-rekisterissä esiin ne toisen asteen opiskelijat, joille haluat täyttää tiedon oikeudesta maksuttomaan oppimateriaaliin.
2. Merkitse opiskelijoille Oikeus maksuttomaan oppimateriaaliin alkaa -kenttään päiväys, josta eteenpäin opiskelijalla on oikeus maksuttomaan oppimateriaaliin.
3. Jos on tiedossa päiväys, jolloin oikeus päättyy, merkitse se Oikeus maksuttomaan oppimateriaaliin päättyy -kenttään. Muussa tapauksessa jätä kenttä tyhjäksi.
4. Merkitse Maksuttoman oppimateriaalin koulu -kenttään se koulu, jota maksuttomuus koskee.

Huom. Samalla koululla ei saa olla useampaa riviä edellä mainituissa kentissä. Maksuttomuus on koulukohtainen tieto, eli opiskelijalla ei voi olla useampaa maksuttomuusjaksoa samassa koulussa.

Tiedon siirtyminen MPASSiin

• MPASS-kirjautumisen yhteydessä tarkistetaan, onko opiskelija toisen asteen opiskelija ja onko hänellä oikeus maksuttomaan oppimateriaaliin.
• Tieto siitä, onko opiskelija toisen asteen opiskelija, katsotaan Opiskeluoikeuden tyyppi (KOSKI) -kentästä opiskelijan kortilta. Jos kenttä on tyhjä, tieto katsotaan toissijaisesti opiskelijan luokan/ryhmän kortilta vastaavasta kentästä, ja jos sekin on tyhjä, tieto katsotaan opiskelijan koulun/koulujen korteilta vastaavasta kentästä. Opiskelijan katsotaan olevan toisen asteen opiskelija, jos kentästä löytyy jostain edellä mainituista sijainneista jokin seuraavista vaihtoehdoista:
  • Perusopetuksen lisäopetus
  • Lukioon valmistava
  • Ammatillinen
  • Lukio
  • IB-tutkinto
  • Tutkintokoulutukseen valmentava
• Jos opiskelija on yllä kuvatun perusteella toisen asteen opiskelija, tarkistetaan Primuksesta vielä, onko hänellä oikeus maksuttomaan oppimateriaaliin. Oikeus katsotaan olevan, jos nykyinen päiväys (MPASS-kirjautumisen ajankohta) sijoittuu opiskelijalla Opiskelijat-rekisterin Oikeus maksuttomaan oppimateriaaliin alkaa- ja Oikeus maksuttomaan oppimateriaaliin päättyy -kentissä määriteltyyn aikaväliin ja Maksuttoman oppimateriaalin koulu -kentässä on opiskelijan kortin Koulu-kentästä löytyvä koulu. Oikeus maksuttomaan oppimateriaaliin päättyy -kenttä voi olla tyhjänäkin.

Aiheeseen liittyvät funktiot

Opiskelijat-rekisterissä on kaksi funktiota, joilla voi tarvittaessa hakea tiedon siitä, onko opiskelija toisen asteen opiskelija ja onko hänellä oikeus maksuttomaan oppimateriaaliin. Tällainen tarve voi olla esim. silloin, jos MPASS-integraatio on toteutettu oman AD:n kautta ja tarvitaan PrimusQuery-siirtoa varten tieto oikeudesta maksuttomaan oppimateriaaliin.

• Toisen asteen opiskelija -funktiolla voi hakea ne opiskelijat, jotka ovat Opiskeluoikeuden tyyppi (KOSKI) -kentän perusteella toisen asteen opiskelijoita.
• Oikeus maksuttomaan oppimateriaaliin toisella asteella.Pvm.Koulu -funktiolla voi hakea päiväyksen ja koulun perusteella opiskelijat, joilla on oikeus maksuttomaan oppimateriaaliin. Funktio tarkastelee kenttiä Oikeus maksuttomaan oppimateriaaliin alkaa, Oikeus maksuttomaan oppimateriaaliin päättyy ja Maksuttoman oppimateriaalin koulu. Oikeus maksuttomaan oppimateriaaliin päättyy -kenttä voi olla tyhjänäkin.

MPASS-palvelua käyttävät asiakkaamme päättävät itse, siirretäänkö turvakiellossa olevien henkilöiden tiedot Primuksesta MPASS-palvelun hakurajapintaan vai ei. Koulun tiedot -rekisterissä on tätä varten kenttä Salli MPASS-palvelu turvakiellossa oleville. Jos kentän rastii, siirretään myös turvakiellossa olevien henkilöiden tiedot eli hekin voivat käyttää MPASS-palvelua. Kenttä ei ole koulukohtainen, eli se rastitaan tarvittaessa vain korttinumeron 1 koululle, ja sama asetus vaikuttaa kaikkiin kouluihin. Kentässä ei ole rastia oletuksena eli turvakiellossa olevat eivät voi käyttää MPASS-palvelua. Visma ei voi päättää asiakkaiden puolesta, siirretäänkö turvakiellossa olevien henkilöiden tietoja MPASS-palveluun vai ei.

Salli MPASS-palvelu turvakiellossa oleville -kentän asetus vaikuttaa kaikkiin henkilöihin, joilla on voimassa oleva turvakielto kirjattuna Primukseen. Primuksessa ei siis voi määrittää, että yksittäinen turvakiellossa oleva henkilö voisi käyttää MPASS-palvelua ja muut eivät. Turvakielto voi olla opiskelijoiden itsensä lisäksi kirjattuna opiskelijan huoltajilla ja lähiomaisilla, hakijoilla, opettajilla ja henkilökunnalla.

• Opiskelijalla on turvakielto, jos Opiskelijat-rekisterissä on rastittuna Turvakielto-kenttä tai jos turvakielto on voimassa Turvakiellon alkamispäivä- ja Turvakiellon päättymispäivä -kenttiin täytettyjen päivämäärien perusteella.
• Huoltajien ja lähiomaisten osalta turvakielto katsotaan vastaavalla logiikalla kentistä Huoltajalla turvakielto, Huoltajan turvakiellon alkamispäivä, Huoltajan turvakiellon päättymispäivä, Lähiomaisella turvakielto, Lähiomaisen turvakiellon alkamispäivä ja Lähiomaisen turvakiellon päättymispäivä.
• Opettajalla on turvakielto, jos turvakielto on voimassa Opettajat-rekisterin Turvakiellon alkamispäivä- ja Turvakiellon päättymispäivä -kenttiin täytettyjen päivämäärien perusteella. Henkilökunnan ja hakijoiden osalta turvakielto katsotaan vastaavista kentistä Henkilökunta- ja Hakijat-rekisteristä.