NB! Moniarvoisten attribuuttien käsittelysäännöt astuvat voimaan 4.1.2022 lähtien muiden MPASSid-tietomallimuutosten kanssa!
1) Koulutustoimijan MPASSid:lle välittämät moniarvoiset tiedot:
Koulutustoimijan käyttäjärekisteristä moniarvoisina attribuutteina MPASSid:lle voidaan toimittaa alla listatut attribuutit. NB! Muita kuin alla listattuja, ei käsitellä moniarvoisina attribuutteina.
- Koulukoodi
- Luokka
- Rooli
Koulutustoimijan käyttäjärekisteristä MPASSid:ssä moniarvoiset attribuutit käsitellään seuraavien sääntöjen mukaisesti.
- Koulukoodina voidaan toimittaa yksi tai useita koulukoodeja. Tilastokeskuksen koulukoodi ja koulukoodiattribuutti on viisinumeroinen merkkijono.
- Luokkana voidaan toimittaa nolla tai yhtä monta luokkaa, kun koulukoodeja on. Luokka-attribuutin arvo on merkkijono, joka voi olla myös tyhjä.
- Rooleja voidaan toimittaa yksi tai useita rooleja. Rooliattribuutin arvo on merkkijono.
- Attribuuttien tulkinnassa käytetään seuraavia sääntöjä:
- Koulukoodi-attribuutin arvojen määrä on yhtä suuri kuin luokka-attribuutin arvojen ja rooli-attribuutin arvojen määrä.
Koulukoodi-attribuutin arvoja on useita ja luokka-attribuutin arvoja ei ole ollenkaan.
- Koulukoodi-attribuutin arvoja useita ja rooli-attribuutin arvoja on yksi.
- NB! Mikäli moniarvoisissa attributteissa kirjautumisen yhteydessä saadaan jokin muu kuin hyväksytty kombinaatio, ei MPASSid-rooliattribuuttia generoida.
- Mikäli kotiorganisaation käyttäjähakemistona integraatiossa on käytössä AzureAD, ADFS tai Google, moniarvoisen attribuutin arvot erotellaan puolipisteellä ( ; )
- Yhden moniarvoisen attribuutin yksi arvo ei saa sisältää erotinmerkkiä ( ; ), muuten arvo tulkitaan kahdeksi eri arvoksi.
2) MPASSid:n palvelulle välittämät moniarvoiset tiedot
MPASSid luo koulutustoimijan moniarvoisten attribuuttien pohjalta palvelulle välitettävät moniarvoiset attribuutit:
- Koulukoodi (urn:mpass.id:schoolCode)
- Lisäksi koulukoodin perusteella MPASSid hakee ja välittää OPH:n organisaatiopalvelusta palvelulle attribuutit, jotka voivat olla moniarvoisia.
- Koulun nimi (urn:mpass.id:school)
- Koulukoodi ja nimi (urn:mpass.id:schoolInfo)
- Opetuksen tai koulutuksen järjestäjän OID-tunniste (urn:mpass.id:educationProviderId)
- Opetuksen tai koulutuksen järjestäjän nimi (urn:mpass.id:educationProvider)
- Opetuksen tai koulutuksen järjestäjän OID-tunniste ja nimi: urn:mpass.id:educationProviderInfo
- NB! Luokka (urn:mpass.id:class) ei ole moniarvoinen.
- Palvelulle välitetään koulutustoimijan rekisteristä ensimmäinen luokkatieto.
- Rooli (urn:mpass.id:role)
- koostuu koulutuksen järjestäjän OID-tunnisteesta, koulukoodista, luokasta, roolista.
3) Esimerkkejä tulkinnasta
Kotiorganisaatiosta MPASSid:hen välitetty tieto | MPASSid:n palvelulle välittämät tiedot | |||||||
Koulukoodi | Luokka | Rooli | Rooli urn:mpass.id:role | Esimerkki | Koulukoodi urn:mpass.id:schoolCode | Luokka urn:mpass.id:class | Koulukoodi ja nimi urn:mpass.id:schoolInfo | Opetuksen- tai koulutuksen järjesäjän OID-tunniste ja nimi urn:mpass.id:educationProviderInfo |
---|---|---|---|---|---|---|---|---|
<koulukoodi_1> | <luokka_1> | <rooli_1> | <koulutuksenjärjestäjän_oid_1>;<koulukoodi_1>;<luokka_1>;<rooli_1> | 1.2.246.562.10.12345678907;12345;9B;oppilas | <koulukoodi_1> | <luokka_1> | <koulukoodi_1>;<koulun_nimi_1> | <koulutuksenjärjestäjän_oid_1>;<okj_nimi_1> |
<koulukoodi_1>;<koulukoodi_2>;<koulukoodi_n> | <rooli_1> | <koulutuksenjärjestäjän_oid_1>;<koulukoodi_1>;;<rooli_1> <koulutuksenjärjestäjän_oid_2>;<koulukoodi_2>;;<rooli_1> <koulutuksenjärjestäjän_oid_n>;<koulukoodi_n>;;<rooli_1> | 1.2.246.562.10.12345678907;12345;;opettaja 1.2.246.562.10.12345678907;23456;;opettaja 1.2.246.562.10.23456789017;34567;;opettaja | <koulukoodi_1> <koulukoodi_2> <koulukoodi_n> | <koulukoodi_1>;<koulun_nimi_1> <koulukoodi_2>;<koulun_nimi_2> <koulukoodi_3>;<koulun_nimi_3> | <koulutuksenjärjestäjän_oid_1>;<okj_nimi_1> <koulutuksenjärjestäjän_oid_2>;<okj_nimi_2> <koulutuksenjärjestäjän_oid_3>;<okj_nimi_3> | ||
<koulukoodi_1>;<koulukoodi_2>;<koulukoodi_n> | ;<luokka_2>;<luokka_n> | <rooli_1>;<rooli_2>;<rooli_n> | <koulutuksenjärjestäjän_oid_1>;<koulukoodi_1>;;<rooli_1> <koulutuksenjärjestäjän_oid_2>;<koulukoodi_2>;<luokka_2>;<rooli_2> <koulutuksenjärjestäjän_oid_n>;<koulukoodi_n>;<luokka_n>;<rooli_n> | 1.2.246.562.10.12345678907;12345;;opettaja 1.2.246.562.10.12345678907;23456;4B;sijaisopettaja 1.2.246.562.10.23456789017;34567;6C;sijaisopettaja | <koulukoodi_1> <koulukoodi_2> <koulukoodi_n> | <koulukoodi_1>;<koulun_nimi_1> <koulukoodi_2>;<koulun_nimi_2> <koulukoodi_3>;<koulun_nimi_3> | <koulutuksenjärjestäjän_oid_1>;<okj_nimi_1> <koulutuksenjärjestäjän_oid_2>;<okj_nimi_2> <koulutuksenjärjestäjän_oid_3>;<okj_nimi_3> | |
<koulukoodi_1>;<koulukoodi_2>;<koulukoodi_n> | <luokka_1>;<luokka_2>;<luokka_n> | <rooli_1> | <koulutuksenjärjestäjän_oid_1>;<koulukoodi_1>;<luokka_1>;<rooli_1> <koulutuksenjärjestäjän_oid_2>;<koulukoodi_2>;<luokka_2>;<rooli_1> <koulutuksenjärjestäjän_oid_n>;<koulukoodi_n>;<luokka_n>;<rooli_1> | 1.2.246.562.10.12345678907;12345;9A;opettaja 1.2.246.562.10.12345678907;23456;4B;opettaja 1.2.246.562.10.12345678907;34567;6C;opettaja | <koulukoodi_1> <koulukoodi_2> <koulukoodi_n> | <luokka_1> | <koulukoodi_1>;<koulun_nimi_1> <koulukoodi_2>;<koulun_nimi_2> <koulukoodi_3>;<koulun_nimi_3> | <koulutuksenjärjestäjän_oid_1>;<okj_nimi_1> |
<koulukoodi_1>;<koulukoodi_2>;<koulukoodi_n> | <luokka_1>;<luokka_2>;<luokka_n> | <rooli_1>;<rooli_2>;<rooli_n> | <koulutuksenjärjestäjän_oid_1>;<koulukoodi_1>;<luokka_1>;<rooli_1> <koulutuksenjärjestäjän_oid_2>;<koulukoodi_2>;<luokka_2>;<rooli_2> <koulutuksenjärjestäjän_oid_n>;<koulukoodi_n>;<luokka_n>;<rooli_n> | 1.2.246.562.10.12345678907;12345;9A;opettaja 1.2.246.562.10.23456789017;23456;4B;sijaisopettaja 1.2.246.562.10.23456789017;23456;6C;sijaisopettaja | <koulukoodi_1> <koulukoodi_2> <koulukoodi_n> | <luokka_1> | <koulukoodi_1>;<koulun_nimi_1> <koulukoodi_2>;<koulun_nimi_2> | <koulutuksenjärjestäjän_oid_1>;<okj_nimi_1> <koulutuksenjärjestäjän_oid_2>;<okj_nimi_2> |
<koulukoodi_1>;<koulukoodi_2>;<koulukoodi_n> | <luokka_1>;; | <rooli_1>;<rooli_2>;<rooli_n> | <koulutuksenjärjestäjän_oid_1>;<koulukoodi_1>;<luokka_1>;<rooli_1> <koulutuksenjärjestäjän_oid_2>;<koulukoodi_2>;;<rooli_2> <koulutuksenjärjestäjän_oid_n>;<koulukoodi_n>;;<rooli_n> | 1.2.246.562.10.12345678907;12345;9A;opettaja 1.2.246.562.10.12345678907;23456;;henkilöstö 1.2.246.562.10.23456789017.6;34567;;henkilöstö | <koulukoodi_1> <koulukoodi_2> <koulukoodi_n> | <luokka_1> | <koulukoodi_1>;<koulun_nimi_1> <koulukoodi_2>;<koulun_nimi_2> <koulukoodi_3>;<koulun_nimi_3> | <koulutuksenjärjestäjän_oid_1>;<okj_nimi_1> <koulutuksenjärjestäjän_oid_2>;<okj_nimi_2> <koulutuksenjärjestäjän_oid_3>;<okj_nimi_3> |