Tietomalli 1.4
Tietomallin tarkoitus
Tietoluettelon tarkoituksena on kuvata MPASSid:n kautta välitettäviä tietosisältöjä opetuksen- ja koulutuksen järjestäjän henkilörekisteristä MPASSid:n kautta digitaalisten palveluiden tarjoajille. Tietoluetteloa ylläpitää Opetushallitus.
Opetuksen tai koulutuksen järjestäjän välittämät tiedot MPASSid:lle
Opetuksen ja koulutuksen järjestäjä, MPASSid:n luottamusverkoston jäsenenä, vastaa ja ylläpitää rekisterinpitäjänä loppukäyttäjien henkilötietoja, joita välitetään MPASSid:n kautta.
Organisaatiopalvelun kautta MPASSid:n välittämät tiedot
Kunkin opetuksen ja koulutuksen järjestäjän tietoja ylläpidetään Opetushallituksen Organisaatiopalvelussa. MPASSid:n välittämät tiedot opetuksen- ja koulutuksen järjestäjästä saadaan Organisaatiopalvelusta koulutuksen järjestäjän käyttäjän kirjautumisessa välittämän Tilastokeskuksen oppilaitostunnuksen avulla.
Taulukon sarakkeiden sisällöt
- Versio
- v1.0
- v1.1 käyttöönotto 1.9.2020 lähtien
- v.1.2 käyttöönotto 4.1.2022 lähtien
- v.1.3. käyttöönotto 2.8.2022 lähtien
- v. 1.4 käyttöönotto 1/2024 lähtien
- Tieto: tietokentän nimi
- Esimerkki: malli kentän sisällöstä
- Attribuuttinimi: tietokentän nimi, jota käytetään SAML ja OIDC -protokollissa
- Lukumäärä: kuvaa tiedon pakollisuutta
- Moniarvoinen attribuutti
- x-merkityt attribuutit voivat sisältää useamman kuin yhden arvon. Esimerkiksi silloin kun opettaja työskentelee useamman kunnan alueella.
- Tutustu moniarvoisten attribuuttien käsittelysääntöihin https://wiki.eduuni.fi/x/ya-gDQ*
- Moniarvoinen attribuutti
- Kuvaus: sisällön selitys, linkki koodistoon ja tarkempiin ohjeisiin
- Lähde: kuvaa tiedon muodostumisen tapaa eli toimitetaanko attribuutti suoraan koulutustoimijan rekisteristä sellaisenaan palveluntarjoajalle vai muodostaako MPASSid tiedon koulutustoimijan välittämien tietojen perusteella.*
- Kotiorganisaation rekisteri
- MPASSid:n muodostama
Tietomalli 1.4 - 1/2024 alkaen
Versio | Tieto | Esimerkki | Attribuuttinimi (SAML ja OIDC) | Moniarvoinen attribuutti | Kuvaus | Lähde |
1.0 | Sukunimi | Laitinen | urn:oid:2.5.4.4 (SAML) family_name (OIDC) | Käyttäjän sukunimi | Kotiorganisaation rekisteri | |
1.0 | Etunimi | Mari | urn:oid:2.5.4.42 (SAML) given_name (OIDC) | Käyttäjän etunimi. | Kotiorganisaation rekisteri | |
1.4. Uusi! | Kutsumanimi | Maiju | urn:mpass.id:nickname (SAML) nickname (OIDC) | Käyttäjän kutsumani. | Kotiorganisaation rekisteri. | |
1.0 | Käyttäjän tunniste käyttäjähakemistossa | MPASSOID.c6329e82913e265b3a79c11a043fdab8b06b1a9e | urn:mpass.id:uid | Käyttäjän yksilöivä tunniste käyttäjähakemistossa, jonka MPASSid muodostaa ks. esimerkki. Kotiorganisaatioiden välittämät käyttäjän yksilöivät tunnisteet vaihtelevat käyttäjähakemistoittain. HUOM! Tunniste todennäköisesti muuttua silloin, kun käyttäjä siirtyy toiseen käyttäjähakemistoon. Opetushallitus suosittelee käyttämään oppijanumeroa käyttäjän yksilöintiä varten. | Kotiorganisaation rekisteri | |
1.4 Nimi on muuttunut ja muutoksia sisällössä! | Oppilaitostiedot | 00000;Mansikkalan testi peruskoulu ja 1.2.246.562.99.00000000002;Mansikkalan testi peruskoulu | urn:mpass.id:schoolInfo | x |
Tilastokeskuksen oppilaitostunnukset: https://www.stat.fi/tup/oppilaitosrekisteri/index.html
| MPASSid:n muodostama |
1.0 | Vuosiluokka | 8 tai 3. | urn:mpass.id:classLevel | Käyttäjän vuosiluokka (0–10). Ks. https://www.stat.fi/meta/kas/vuosiluokka.html. Tieto välitetään ainoastaan esi- ja perusasteen oppimäärää suorittavilta oppilailta vuosiluokilla 0-9. Katso kuvaus vuosiluokasta opetus-ja koulutussanastosta: https://termipankki.fi/tepa/fi/haku/vuosiluokka Tietoa vuosiluokasta ei välitetä lukio tai ammatillisen koulutuksen opiskelijoilta. | Kotiorganisaation rekisteri | |
1.4 Muutoksia sisällössä! | Oppimateriaalien maksullisuus | 0;00000 ja 0;1.2.246.562.99.00000000003 | urn:mpass.id:learningMaterialsCharge | x | Toisen asteen opiskelijan oppimateriaalien maksullisuus* MPASSid:n maksullisuusattribuutti koostuu kahdesta osasta eroteltu puolipisteellä (;) oppimateriaalien maksullisuudesta kertovasta koodiarvosta yhdistettynä Tilastokeskuksen oppilaitostunnukseen. MPASSid:n sallimat koodiarvot maksullisuudesta:
MPASSid muodostaa maksullisuusattribuutin käyttäjälle ainoastaan, mikäli käyttäjän rooli on "oppilas". Lisätietoa maksullisuustiedon pilotoinnista ja käyttöönotosta MPASSid:n teknisessä vuosikellossa: Maksullisuudesta kertovan attribuutin käyttöönotto | MPASSid:n muodostama |
1.4 Muutoksia sisällössä! | Rooli | 1.2.246.562.99.00000000001;00000;1A;Oppilas;1;1.2.246.562.99.00000000003; | urn:mpass.id:role | x | Käyttäjän rooliattribuutti, joka koostuu eri arvojen joukosta. Huomio palveluntarjoajille! Rooliattribuutin sisältö ja pituus voi muuttua tietomallikehityksen myötä. Tietomalliversiossa 1.4. MPASSid:n rooliattribuutin sisältö koostuu seuraavista arvoista puolipisteellä ";" erotettuna.
Tutustu sallittuihin rooleihin: Sallitut roolit
| MPASSid:n muodostama |
1.1 | Kansallinen oppijanumero | 1.2.246.562.24.10000000008 | urn:oid:1.3.6.1.4.1.16161.1.1.27 | Oppijanumero on pakollinen ja pakollinen tunniste henkilön yksilöintiä varten. Sen käyttäminen on pakollista kaikilla käyttäjillä MPASSid-tunnistuksenvälityspalvelussa. Opetushallitus vastaa oppijanumerorekisteristä ja oppijanumeron generoinnista koulutustoimijoille lakisääteisiin tehtäviinsä. Lisätietoa: Oppijanumero Teknisesti oppijanumero rakentuu osaksi JHS 159:n ohjeistamaa ISO OID -yksilöintitunnusta (International Standard Organization: Object Identifier). Oppijanumeron loppuosa on 11 numeroa pitkä luku, jonka viimeinen numero on tarkistusmerkki. | Kotiorganisaation rekisteri | |
1.2 | Koulutustoimijan tiedot | 1.2.246.562.10.494695390410;Virallinen nimi | urn:mpass.id:educationProviderInfo | x | Opetuksen tai koulutuksen järjestäjän organisaatio-OID-tunniste ja tunnisteeseen liittyvä virallinen nimi. | MPASSid:n muodostama |
1.4 Uusi! | Tietojen välittäjäorganisaatio | 1.2.246.562.10.00000000000 | (SAML) urn:mpass.id:originalIssuer (OIDC) urn:mpass.id:originalIssuer | Opetushallituksen lisäämä attribuutti käyttäjälle. Toimitetaan tieto käyttäjän kotiorganisaatiosta, joka välittää käyttäjän attribuutit. Attribuutin arvona välitetään koulutuksenjärjestäjän OID -tunniste. | MPASSid:n muodostama |
Koulutustoimijan toimittamiin attribuutteihin muutokset
Näet koko taulukon koulutustoimijan MPASSid:lle toimittamista attribuuteista täällä: Koulutustoimijan attribuutit
- Uutta! Kutsumanimi
- Koulutustoimija voi ilmoittaa OPH:lle attribuutin, jossa toimitetaan käyttäjän kutsumanimi.
- Attribuutin toimittaminen aloitetaan 2.1.2024 alkaen.
Vaihtoehtoja sisältöön! Organisaation tunniste
- 3.1.2024 alkaen koulutustoimija voi toimittaa tilastokeskuksen oppilaitostunnuksen rinnalla organisaatio OID-tunnistetta.
- Samassa attribuutissa, jossa toimitetaan nykyisin Tilastokeskuksen oppilaitostunnusta, koulutustoimija voi toimittaa varhaiskasvatuksen organisaatio OIDia taikka ammatillisen toimipaikan OID-tunnistetta.
- Uusia rooleja! Käyttäjän rooli
- 3.1.2024 alkaen koulutustoimija voi alkaa käyttämään uusia käyttäjärooleja:
- koulunkäynninohjaaja
- koulunkäyntiavustaja
- 3.1.2024 alkaen koulutustoimija voi alkaa käyttämään uusia käyttäjärooleja: