-
Created by
Juho Mikkonen, last updated on Apr 01, 2025
2 minute read
Taulun kuvaus:
KOSKI-raporttikannan r_henkilo-taulu sisältää tietyt henkilötiedot jokaisesta sellaisesta oppijasta, joilta löytyy vähintään yksi opiskeluoikeus (joka voi olla myös mitätöity) KOSKI-palvelusta. Taulun sisältämät tiedot ovat peräisin Opintopolun oppijanumerorekisteristä.
HUOM! Oppijanumerorekisterissä syntyy tilanteita, joissa samasta henkilöstä on luotu oppijanumerorekisteriin enemmän kuin yksi oppija. Aina, kun tällainen tilanne havaitaan, nämä henkilöt teknisesti linkitetään oppijanumerorekisterissä, jolloin yhdestä oppijasta tulee niin sanottu primäärioppija ja siihen linkitetyistä muista oppijoista ns. duplikaattioppijoita. Linkitystilanteissa KOSKI-opiskeluoikeus säilyy aina sillä oppijalla, jolle se alun perin luotu, vaikka tästä tulisikin linkityksen kautta ns. duplikaattioppija. Näin samasta henkilöstä voi olla oppijanumerorekisterissä usempi kuin yksi oppija ja tätä kautta KOSKI-raporttikannan r_henkilo-taulussa useampi kuin yksi rivi, ja KOSKI-palvelussa taas voi olla samalla henkilöllä opiskeluoikeuksia useammalla kuin yhdellä oppijanumerolla. Näitä tapauksia on kuitenkin vain murto-osa oppijanumerorekisterin ja KOSKI-palvelun datasta, ja niissä on aina kyse tilanteesta, jossa henkilöllä ei ole suomalaista henkilötunnusta tai hän on saanut henkilötunnuksen vasta sen jälkeen, kun hänen tietojaan on ensimmäistä kertaa tallennettu Opintopolku-palvelukokonaisuuden johonkin palveluun. Nämä duplikaattioppijat saa aina yhdistettyä yhden henkilön alle hyödyntämällä r_henkilo-taulun master_oid-kenttää.
Tietuekuvaukset:
Alla olevasta taulukosta löytyy jokaisen tietueen tarkempi kuvaus sisältäen esimerkiksi tietueeseen liittyvät relevantit ohjeet (esimerkiksi tieto siitä, miten tietoa voi hyödyntää suhteessa muihin tietueisiin, Opintopolun koodistopalvelun tietoihin tai Opintopolun organisaatiopalvelun tietoihin).
| Sarake/tietue | Sisältää henkilötietoja, erityisiä henkilötietoja tai salassa pidettäviä tietoja | Kuvaus |
|---|---|---|
| oppija_oid | Kyllä | Oppijan ns. oppijanumero, joka luodaan Opintopolun oppijanumerorekisterissä, kun henkilön tietoja ensimmäistä kertaa tallennetaan palveluun, joka käyttää oppijanumeroa ensisijaisena henkilön yksilöivänä tunnisteena. |
| master_oid | Kyllä | Henkilön ns. primäärioppijan oppijanumero (ks. tarkemmin ylempää taulun kuvaus). Jos rivin kuvaama oppija on primäärioppija, tässä kentässä on sama arvo kuin kentässä oppija_oid. Jos taas rivin kuvaama oppija on jonkun toisen oppijan duplikaatti, tässä kentässä on eri arvoi kuin kentässä oppija_oid. |
| hetu | Kyllä | Oppijan henkilötunnus. Jos oppijalla ei ole henkilötunnusta, kenttä on tyhjä. |
| sukupuoli | Kyllä | Oppijan virallinen (henkilötunnukselliset oppija) tai itsensä ilmoittama (henkilötunnuksettomat oppija) sukupuoli. Sukupuoli voi saada arvot '1' (= mies) tai '2' (= nainen). |
| syntymaaika | Kyllä | Oppijan virallinen (henkilötunnukselliset oppija) tai itsensä ilmoittama (henkilötunnuksettomat oppija) syntymäaika. Tiedon muoto 'YYYY-MM-DD'. |
| sukunimi | Kyllä | Oppijan virallinen (henkilötunnukselliset oppija) tai itsensä ilmoittama (henkilötunnuksettomat oppija) sukunimi. |
| etunimet | Kyllä | Oppijan viralliset (henkilötunnukselliset oppija) tai itsensä ilmoittamat (henkilötunnuksettomat oppija) etunimet. |
| aidinkieli | Kyllä | Oppijan virallinen (henkilötunnukselliset oppija) tai itsensä ilmoittama (henkilötunnuksettomat oppija) äidinkieli. Käytettävä koodisto: https://opintopolku.fi/koski/dokumentaatio/koodisto/kieli/latest. |
| kansalaisuus | Kyllä | Oppijan viralliset (henkilötunnukselliset oppija) tai itsensä ilmoittamat (henkilötunnuksettomat oppija) kansalaisuudet (pilkulla erotettuna, jos useita). Käytettävä koodisto: https://opintopolku.fi/koski/dokumentaatio/koodisto/maatjavaltiot2/latest. |
| turvakielto | Kyllä | Tieto siitä, jos oppijalla on DVV:n mukaan turvakielto (true/false). |
| kotikunta | Kyllä | Tieto henkilötunnuksellinen oppijan virallisesta kotikunnasta koodiarvona. Käytettävä koodisto: https://opintopolku.fi/koski/dokumentaatio/koodisto/kunta/latest. Henkilötunnuksettomilla sekä turvakiellollisilla oppijoilla kenttä on tyhjä (null). |
| kotikunta_nimi_fi | Kyllä | Henkilötunnuksellisen oppijan kotikunnan nimi suomeksi. Henkilötunnuksettomilla sekä turvakiellollisilla oppijoilla kenttä on tyhjä (null). |
| kotikunta_nimi_sv | Kyllä | Henkilötunnuksellisen oppijan kotikunnan nimi ruotsiksi. Henkilötunnuksettomilla sekä turvakiellollisilla oppijoilla kenttä on tyhjä (null). |
| yksiloity | Kyllä | Tieto siitä, onko oppija Opintopolun oppijanumerorekisterissä teknisesti ns. yksilöity, eli varmistettu, että oppijan henkilötiedot ovat oikeat (true/false). Henkilötunnuksellisilla oppijoilla yksilöinti tapahtuu automaattisesti, jos henkilön tietojen päivittäminen onnistuu DVV:n tietoja hyödyntäen henkilötunnuksen ja nimen vastaavuuden perusteella. Henkilötunnuksettomilla oppijan yksilöinti tehdään manuaalisesti oppijanumerorekisterin käyttölittymässä, kun tietoja syöttävä viranomainen, koulutuksen järjestäjän edustaja jne. on tarkistanut oppijan tiedot häneltä saadun informaation ja todistusten perusteella. |