Taulun kuvaus:
KOSKI-raporttikannan r_paatason_suoritus-taulu sisältää opiskeluoikeuteen liittyvän päätason suorituksen/liittyvien päätason suoritusten tiedot olennaisilta osin normalisoituna. Jokainen päätason suoritus muodostaa oman rivinsä, mutta samasta päätason suorituksesta ei ole taulussa kuin yksi rivi. Lisäksi mukana on JSON-formaatissa suurin osa sekä normalisoidusta tietosisällöstä että niistä tiedoista, joita ei ole purettu taulun relaatiomalliin.
HUOM! Opiskeluoikeudella on aina vähintään yksi päätason suoritus, mutta opiskeluoikeudella voi olla myös useampi päätason suoritus riippuen siitä, mitä koulutusta opiskeluoikeudessa suoritetaan. Osiosta "Koulutusmuodot" löytyy yleinen kuvaus siitä, miten kukin koulutusmuoto on mallinnettu KOSKI-palveluun opiskeluoikeuden ja päätason suoritusten kombinaatioina ja missä tilanteissa opiskeluoikeudella on useampi kuin yksi päätason suoritus.
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 |
|---|---|---|
| paatason_suoritus_id | Ei | Päätason suorituksen jokaisessa KOSKI-raporttikannan generoinnissa vaihtuva tunniste. Tunnistetta ei voi käyttää päätason suorituksen yksilöimiseen eri päivinä generoitujen raporttikannan versioiden välillä, vaan pelkästään saman aineiston sisällä. |
| opiskeluoikeus_oid | Ei | Opiskeluoikeuden yksilöivä tunniste KOSKI-palvelussa. Generoidaan KOSKI-palvelussa opiskeluoikeutta luotaessa. Linkittää r_paatason_suoritus-taulun r_opiskeluoikeus-tauluun. |
| suorituksen_tyyppi | Ei | Suorituksen tyyppi, joka yksilöi millaisesta päätason suorituksessa on kyse (esimerkiksi ammatillisessa koulutuksessa tieto kertoo sen, suoritetaanko kokonaista tutkintoa, tutkinnon osaa/osia, tutkinnon osaa pienemmistä kokonaisuuksista koostuvaa suoritusta, muun ammatillisen koulutuksen suoritusta, VALMA-koulutusta vai TELMA-koulutusta). Käytettävä koodisto: https://opintopolku.fi/koski/dokumentaatio/koodisto/suorituksentyyppi/latest. |
| koulutusmoduuli_koodisto | Ei | Opintopolun koodisto, josta päätason suorituksen yksilöivä tunniste (= alempana sarake koulutusmoduuli_koodiarvo) löytyy. Suurimmassa osassa tapauksia päätason suorituksen yksilöivä tunniste löytyy koodistosta: https://opintopolku.fi/koski/dokumentaatio/koodisto/koulutus/latest. Tapaukset, joissa käytetään yleisestä koulutuskoodistosta poikkeavaa koodistoa:
|
| koulutusmoduuli_koodiarvo | Ei | Päätason suorituksen yksilöivä tunniste. Voi olla virallinen koulutuskoodi, KOSKI-palveluun erikseen koodistona mallinnetun tunnisteavaaruden mukainen koodiarvo tai koulutuksen järjestäjän paikallinen koodiarvo päätason suorituksesta riippuen. Ks. kuvaus käytettävistä koodistoista päätason suorituksittain ylempää tietueen koulutusmoduuli_koodisto selitteestä. |
| koulutusmoduuli_koulutustyyppi | Ei | Tieto, jonka KOSKI päättelee päätason suoritukselle automaattisesti, jos koulutusmoduuli_koodiarvo-kentässä päätason suoritukselle tallennettava arvo on kuuluu viralliseen koulutuskoodistoon: https://opintopolku.fi/koski/dokumentaatio/koodisto/koulutus/latest. Koulutustyyppi ryhmittelee joissain koulutusmuodoissa tutkintokoulutuksen suorituksia erilaisiin tai eritasoisiin suorituksiin. KOSKI-datan kohdalla relevantti vain ammatillisen tutkintokoulutuksen kohdalla ja kertoo sen, onko ammatillisen tutkintokoulutuksen (koko tutkinnon suoritus tai tutkinnon osan/osien suoritus) suorituksessa kyse ammatillinen perustutkinnosta, ammattitutkinnosta vai erikoisammattitutkinnosta tai niihin liittyvistä opinnoista. Tällaisen päätason suoritus on tyypiltään (kenttä 'suorituksen_tyyppi' toinen seuraavista:
Käytettävä koodisto: https://opintopolku.fi/koski/dokumentaatio/koodisto/koulutustyyppi/latest. |
| koulutusmoduuli_laajuus_arvo | Ei | Päätason suorituksen laajuus koulutusmuodossa käytetävässä laajuusyksikössä laskettuna. Tyypillisesti esimerkiksi suorituksen yhteislaajuus (esimerkiksi aikuisten perusopetuksen aineopintoina suoritetun oppiaineen suorituksen yhteislaajuus kursseina). Ks. tarkemmat kuvaukset tilanteista, joissa päätason suorituksella on joku laajuus alta kentän koulutusmoduuli_laajuus_yksikkö kuvauksesta. HUOM! Kaikissa päätason suorituksissa laajuus ei ole relevantti tieto. Myöskään keskeneräisille päätason suorituksille ei usein ole tallennettu suorituksen laajuutta, vaikka sellainen vahvistetulta (= valmiilta) suoritukselta lopulta löytyisikin. Näissä tapauksissa kenttä on aina tyhjä. |
| koulutusmoduuli_laajuus_yksikko | Ei | Päätason suorituksen mahdollisen laajuuden määrittämisessä käytetty yksikkö. Käytettävä koodisto: https://opintopolku.fi/koski/dokumentaatio/koodisto/opintojenlaajuusyksikko/latest. Päätason suoritukset, joista voi löytyä laajuus:
|
| koulutusmoduuli_nimi | Ei | Kentästä koulutusmoduuli_koodiarvo löytyvän koodiarvon nimi käytetyssä koodistossa (ks. käytettävät koodistot sekä tilanteet, joissa koodiarvo ei ole mistään koodistosta, tietueen koulutusmoduuli_koodisto kuvauksesta) sinä päivänä, jolta käytettävä KOSKI-raporttikannan versio on. HUOM! Tutkinnon/koulutuksen nimi voi muuttua niin, että käytettävä koodiarvo ei vaihdu. Näin ammatillisen tutkintokoulutuksen suorituksia (= suorituksen tyyppi joko 'ammatillinentutkinto' tai 'ammatillinentutkintoosittainen') käsiteltäessä on suositeltavaa käyttää aina kenttää tutkinnon_nimi_perusteessa, jos koulutuksen/tutkinnon eksaktilla nimellä on merkitystä. Jos päätason päätason suoritus on paikallinen toteutus (paikallinen perusopetuksen oppiaine, paikallinen aikuisten perusopetuksen oppiaine, paikallinen lukion oppiaine tai ammatillisessa koulutuksessa tutkinnon osaa pienemmistä kokonaisuuksista koostuva suoritus tai ammatillista osaamista täydentävä muun ammatillisen koulutuksen suoritus), myös koulutuksen nimi on koulutuksen järjestäjän siirtämä, eikä sitä (kuten koodiarvoakaan) löydy mistään koodistosta. Jos päätason suoritus on lukion aineopintosuoritukset (vain vuoden 2019 lukion opetussuunnitelman mukaiset aineopinnot) yhden päätason suorituksen alle kokoava synteettinen päätason suoritus, tämä kenttä on tyhjä, mutta tiedon hyödyntäjä voi halutessaan nimetä tällaiset suoritukset nimellä "Lukion aineopinnot". |
| tutkinnon_nimi_perusteessa | Ei | Päätason suorituksen nimi siinä opetussuunnitelman perusteessa, jonka mukaan päätason suoritusta suoritetaan/on suoritettu. Relevantti lähinnä silloin, kun päätason suoritus on ammatillisen tutkintokoulutuksen suoritus (= suorituksen tyyppi joko 'ammatillinentutkinto' tai 'ammatillinentutkintoosittainen'), jolloin kentästä koulutusmoduuli_nimi löytyvä nimi ei välttämättä ole sama, joka koulutuksella/suorituksella on ollut suorittamishetkellä. Näin ammatillisen tutkintokoulutuksen suorituksia käsiteltäessä on suositeltavaa käyttää aina kenttää tutkinnon_nimi_perusteessa, jos koulutuksen/tutkinnon eksaktilla nimellä on merkitystä. Opetussuunnitelman perusteen (jos päätason suorituksessa relevantti) tunniste (= diaarinumero) löytyy r_päätason_suoritus-taulun data-kentästä alkuperäisessä JSON-tallennusformaatissa (kentän nimi: perusteenDiaarinumero). |
| suorituskieli_koodiarvo | Ei | Kieli, jolla päätason suoritus on pääasiallisesti suoritettu (tyypillisimmin suomi tai ruotsi) ja jolla suorituksesta mahdollisesti annettu/annettava todistus on kirjoitettu. Määritelmällisesti sama asia kuin OKSA-sanastossa määritelty "opintosuorituksen kieli", eli "kieli, jolla oppija tekee opintosuorituksen tai suorittaa ammatillisen tutkinnon, valmentavan koulutuksen tai niiden osan" (määritelmä päivältä 2.1.2024). Käytettävä koodisto: https://opintopolku.fi/koski/dokumentaatio/koodisto/kieli/latest. |
| oppimaara_koodiarvo | Ei | Tieto kertoo, minkä oppimäärän mukaan päätason suoritusta suoritetaan. Relevantti vain lukiokoulutuksen ja lukiokoulutukseen valmentavan koulutuksen opiskeluoikeuksien alta löytyvissä päätason suorituksissa. Käytettävä koodisto: https://opintopolku.fi/koski/dokumentaatio/koodisto/lukionoppimaara/latest. |
| alkamispaiva | Ei | Päätason suorituksen alkamispäivä. Tapauksissa, joissa opiskeluoikeus sisältää vain yhden päätason suorituksen, tyypillisesti sama kuin opiskeluoikeuden alkamispäivä. |
| vahvistus_paiva | Ei | Päätason suorituksen vahvistuspäivä. Esimerkiksi perusopetuksessa vuosiluokkatodistuksen tai päättötodistuksen myöntämispäivä, ammatillisessa tutkintosuorituksessa tutkintotodistuksen myöntämispäivä jne. Ei relevantti tapauksissa, joissa päätason suoritukselta löytyy arvosana, jolloin käytetään kenttää 'arviointi_paiva' sen määrittämiseen, milloin suoritus on saatu valmiiksi. Ks. tilanteet, joissa päätason suorituksella voi olla arvosana, sekä näissä tilanteissa käytettävät koodistot alempaa kentän arviointi_arvosana_koodiarvo-kuvauksesta. |
| arviointi_arvosana_koodiarvo | Ei | Mahdollinen päätason suorituksen arvosana. Päätason suorituksella voi olla arvosana seuraavissa tapauksissa:
Yllä kuvatuissa tapauksissa kenttä arviointi_paiva kertoo sen, minä päivänä suoritus on saatu ns. valmiiksi kentän vahvistus_paiva sijaan. |
| arviointi_arvosana_koodisto | Ei | Päätason suoritukselle annetun arvosanan arviointiasteikko Opintopolun koodistopalvelussa. Ks. tilanteet, joissa päätason suorituksella voi olla arvosana, sekä näissä tilanteissa käytettävät koodistot ylempää kentän arviointi_arvosana_koodiarvo kuvauksesta. |
| arviointi_hyvaksytty | Ei | Tieto siitä, tarkoittaako päätason suoritukselle mahdollisesti annettu arvosana hyväksyttyä vai hylättyä suoritusta käytettävän arviointiasteikon kontekstissa. Ks. tilanteet, joissa päätason suorituksella voi olla arvosana, sekä näissä tilanteissa käytettävät koodistot ylempää kentän arviointi_arvosana_koodiarvo-kuvauksesta. |
| arviointi_paiva | Ei | Päivä jolloin päätason suoritus on arvioitu. Ks. tilanteet, joissa päätason suorituksella voi olla arvosana, sekä näissä tilanteissa käytettävät koodistot ylempää kentän arviointi_arvosana_koodiarvo-kuvauksesta. Tilanteissa, joissa päätason suorituksella on arvosana, käytetään tätä kenttää kentän vahvistus_paiva sijaan sen määrittämiseksi, milloin suoritus on saatu valmiiksi. |
| toimipiste_oid | Ei lähtökohtaisesti, mutta tieto siitä, että kyseessä on erityisoppilaitos, on erityinen henkilötieto, ja toimipisteestä pystyy tunnistamaan oppilaitoksen, jonka alle toimipiste kuuluu. | Jos oppilaitoksen alla on eri toimipisteitä, ja oppilaitoksen organisaatiorakenne on toimipistetasolla mallinnettu Opintopolun organisaatiopalveluun, koulutuksen järjestäjä voi näissä tapauksissa siirtää sen toimipisteen, jossa koulutus/suoritus pääasiassa tapahtuu, yksilöivän tunnisteen Opintopolun organisaatiopalvelussa tähän kenttään. Jos koulutuksen järjestäjä ei ole siirtänyt kenttään toimipistetasoisen organisaation oid-tunnistetta tai jos oppilaitostasoisella organisaatiolla ei ole toimipisteitä, kentästä löytyy sen oppilaitoksen tai varhaiskasvatuksen toimipaikan, jolle opiskeluoikeus kuuluu, yksilöivä tunniste Opintopolun organisaatiopalvelussa (= sama arvo kuin r_opiskeluoikeus-taulun kentästä oppilaitos_oid). HUOM! Kaikki koulutustoimijat, joilla on oppilaitostasoisten organisaatioiden alla toimipisteitä, eivät systemaattisesti siirrä tietoa siitä, missä toimipisteessä koulutus/suoritus tapahtuu, joten toimipistetietoja ei löydy KOSKI-datasta ns. kattavasti. Tietoa voi siis lähinnä käyttää yksittäisten opiskeluoikeuksien osalta silloin, kun päätason suoritukselta löytyy tästä kentästä eri organisaation oid-tunniste kuin r_opiskeluoikeus-taulun oppilaitos_oid-kentästä. |
| toimipiste_nimi | Ei lähtökohtaisesti, mutta tieto siitä, että kyseessä on erityisoppilaitos, on erityinen henkilötieto, ja toimipisteestä pystyy tunnistamaan oppilaitoksen, jonka alle toimipiste kuuluu. | Toimipisteen, jossa koulutus/suoritus tapahtuu, suomenkielinen nimi Opintopolun organisaatiopalvelussa sinä päivänä, jolta opiskeluoikeuden viimeinen versio on tai päättyneiden opiskeluoikeuksien osalta sinä päivänä, jolloin opiskeluoikeus on päättynyt. Jos päätason suoritukselle ei ole siirretty tietoa siitä oppilaitoksen alaisesta toimipisteestä, jossa koulutus/suoritus tapahtuu tai jos oppilaitostasoisella organisaatiolla ei ole toimipisteitä, tässä kentässä on sen oppilaitoksen tai varhaiskasvatuksen toimipaikan, jolle opiskeluoikeus kuuluu, suomenkielinen nimi Opintopolun organisaatiopalvelussa sinä päivänä, jolta opiskeluoikeuden viimeinen versio on tai päättyneiden opiskeluoikeuksien osalta sinä päivänä, jolloin opiskeluoikeus on päättynyt (= sama arvo kuin r_opiskeluoikeus-taulun kentästä oppilaitos_nimi). |
| toimipiste_nimi_sv | Ei lähtökohtaisesti, mutta tieto siitä, että kyseessä on erityisoppilaitos, on erityinen henkilötieto, ja toimipisteestä pystyy tunnistamaan oppilaitoksen, jonka alle toimipiste kuuluu. | Toimipisteen, jossa koulutus/suoritus tapahtuu, ruotsinkielinen nimi Opintopolun organisaatiopalvelussa sinä päivänä, jolta opiskeluoikeuden viimeinen versio on tai päättyneiden opiskeluoikeuksien osalta sinä päivänä, jolloin opiskeluoikeus on päättynyt. Jos päätason suoritukselle ei ole siirretty tietoa siitä oppilaitoksen alaisesta toimipisteestä, jossa koulutus/suoritus tapahtuu tai jos oppilaitostasoisella organisaatiolla ei ole toimipisteitä, tässä kentässä on sen oppilaitoksen tai varhaiskasvatuksen toimipaikan, jolle opiskeluoikeus kuuluu, ruotsinkielinen nimi Opintopolun organisaatiopalvelussa sinä päivänä, jolta opiskeluoikeuden viimeinen versio on tai päättyneiden opiskeluoikeuksien osalta sinä päivänä, jolloin opiskeluoikeus on päättynyt (= sama arvo kuin r_opiskeluoikeus-taulun kentästä oppilaitos_nimi_sv). |
| data | Saattaa sisältää | Kenttä sisältää JSON-formaatissa lähes kaiken sellaisen päätason suorituksen tietoihin kuuluvan datan, jota ei normalisoida yllä kuvattuun relaatiomalliin, sellaisena kuin koulutuksen järjestäjä on sen tallentanut, sekä osan myös siitä datasta, joka normalisoidaan. Kenttään tallennettavat tiedot vaihtelevat koulutusmuodoittain, joten kentän mahdollisesti sisältämän datan määrittely tyhjentävästi ei ole mahdollista. Peukalosääntönä voi kuitenkin käyttää sitä, että jos joku KOSKI-tietomallista (https://opintopolku.fi/koski/json-schema-viewer#koski-oppija-schema.json) päätason suoritukselta löytyvä tieto ei löydy yllä kuvatuista r_paatason_suoritus-taulun kentistä, se löytyy tästä kentästä alkuperäisessä JSON-formaatissa. HUOM! KOSKI-raporttikannan generoinnissa jätetään tallentamatta myös tähän kenttään KOSKI-datasta jotkut taustapalveluiden sisältämät koodiarvojen sekä muiden mahdollisten tunnisteiden kielistetyt (suomi, ruotsi, englanti) nimet, jolloin KOSKI-raporttikantaa dataa käyttävä tiedonhyödyntäjä voi joutua käyttämään saman päivän versiota esimerkiksi Opintopolun koodistopalvelusta tai organisaatiopalvelusta yhdessä KOSKI-raporttikannasta muodostetun aineiston kanssa. |
| sisaltyy_opiskeluoikeuteen_oid | Ei | Joissain tapauksissa (tyypillisimmin ammatillisen koulutuksen laajennetussa oppisopimuskoulutuksessa) toinen koulutustoimija ostaa opiskeluoikeuden sisältämän koulutuksen toiselta koulutustoimijalta niin, että ostava osapuoli saa koulutuksesta valtionosuusrahoituksen, mutta myyvä osapuoli vastaa kokonaan tai suurimmaksi osaksi koulutuksen käytännön järjestelyistä ja myöntää koulutuksesta saatavan suorituksen/todistuksen. Näissä tapauksissa molemmat osapuolet luovat KOSKI-palveluun omat opiskeluoikeutensa, mutta ne linkitetään niin, että koulutuksen ns. myyvä koulutuksen järjestäjä välittää koulutuksen hankkineen koulutuksen järjestäjän luoman opiskeluoikeuden oid-tunnisteen tässä kentässä. Lähtökohtaisesti näissä tapauksissa valtionosuusrahoituksen laskennassa tarvittavat tiedot löytyvät kattavasti koulutuksen hankkineen ns. päävastuullisen koulutuksen järjestäjän luomasta opiskeluoikeudesta ja varsinaiset suoritustiedot koulutuksen myyneen koulutuksen järjestäjän opiskeluoikeudesta. Vaikka koulutuksen hankkinut koulutuksen järjestäjä on tapauksessa ns. päävastuullinen koulutuksen järjestäjä, joka saa koulutuksesta valtionosuusrahoituksen, monissa tilastollisissa tarkasteluissa suoritus lasketaan koulutuksen myyneen ja suorituksen myöntäneen koulutuksen järjestäjän suoritukseksi, sillä varsinainen suorituksesta annettava todistus (esimerkiksi ammatillinen tutkintotodistus) on näissä tapauksissa aina koulutuksen myyneen koulutuksen järjestäjän allekirjoittama. HUOM! Sama tieto kuin r_opiskeluoikeus-taulun kentässä sisaltyy_opiskeluoikeuteen_oid. |