Koski-tietomalli - Henkilötiedot ja henkilö-OID

Oppija

Oppija Koski-järjestelmässä. Sisältää henkilötiedot ja listan opiskeluoikeuksista, jotka puolestaan sisältävät suorituksia, läsnäolotietoja jne. Henkilötietoja ei tallenneta Koskeen, vaan haetaan/tallennetaan Opintopolun henkilöpalveluun.

Nimi	Lukumäärä	Tyyppi	Kuvaus
henkilö	1	Henkilötiedot ja henkilö-OID Henkilö-OID Täydelliset henkilötiedot Uusi henkilö	Henkilötiedot. Syötettäessä vaaditaan joko oppijanumero `oid` tai kaikki muut kentät, jolloin järjestelmään voidaan tarvittaessa luoda uusi henkilö.
opiskeluoikeudet	0..n	Aikuisten perusopetuksen opiskeluoikeus Ammatillinen opiskeluoikeus DIA-tutkinnon opiskeluoikeus EB-tutkinnon opiskeluoikeus Esiopetuksen opiskeluoikeus European school of helsinki opiskeluoikeus IB-tutkinnon opiskeluoikeus International school opiskeluoikeus Korkeakoulun opiskeluoikeus Lukion opiskeluoikeus Lukioon valmistavan koulutuksen opiskeluoikeus Muun kuin säännellyn koulutuksen opiskeluoikeus Perusopetukseen valmistavan opetuksen opiskeluoikeus Perusopetuksen lisäopetuksen opiskeluoikeus Perusopetuksen opiskeluoikeus Taiteen perusopetuksen opiskeluoikeus Tutkintokoulutukseen valmentavan koulutuksen opiskeluoikeus Vapaan sivistystyön opiskeluoikeus Ylioppilastutkinnon opiskeluoikeus	Lista henkilön opiskeluoikeuksista. Sisältää vain ne opiskeluoikeudet, joihin käyttäjällä on oikeudet. Esimerkiksi ammatilliselle toimijalle ei välttämättä näy henkilön lukio-opintojen tietoja.

Oppija > Henkilötiedot ja henkilö-OID

Henkilötiedot. Syötettäessä vaaditaan joko oppijanumero oid tai kaikki muut kentät, jolloin järjestelmään voidaan tarvittaessa luoda uusi henkilö.

Nimi	Lukumäärä	Tyyppi	Kuvaus
oid	1	merkkijono Oksa: oppijanumero	Oppijanumero 'oid' on oppijan yksilöivä tunniste Opintopolku-palvelussa ja Koskessa.
hetu	0..1	merkkijono	Suomalainen henkilötunnus.
etunimet	1	merkkijono	Henkilön kaikki etunimet. Esimerkiksi Sanna Katariina.
kutsumanimi	1	merkkijono	Kutsumanimi, oltava yksi etunimistä. Esimerkiksi etunimille "Juha-Matti Petteri" kelpaavat joko "Juha-Matti", "Juha", "Matti" tai "Petteri".
sukunimi	1	merkkijono	Henkilön sukunimi. Henkilön sukunimen etuliite tulee osana sukunimeä.

Oppija > Henkilö-OID

Henkilötiedot. Syötettäessä vaaditaan joko oppijanumero oid tai kaikki muut kentät, jolloin järjestelmään voidaan tarvittaessa luoda uusi henkilö.

Henkilö, jonka oppijanumero 'oid' on tiedossa. Tietoja syötettäessä henkilö haetaan henkilöpalvelusta.

Nimi	Lukumäärä	Tyyppi	Kuvaus
oid	1	merkkijono Oksa: oppijanumero	Oppijanumero 'oid' on oppijan yksilöivä tunniste Opintopolku-palvelussa ja Koskessa.

Oppija > Täydelliset henkilötiedot

Henkilötiedot. Syötettäessä vaaditaan joko oppijanumero oid tai kaikki muut kentät, jolloin järjestelmään voidaan tarvittaessa luoda uusi henkilö.

Täydet henkilötiedot. Tietoja haettaessa Koskesta saadaan aina täydet henkilötiedot.

Nimi	Lukumäärä	Tyyppi	Kuvaus
oid	1	merkkijono Oksa: oppijanumero	Oppijanumero 'oid' on oppijan yksilöivä tunniste Opintopolku-palvelussa ja Koskessa.
hetu	0..1	merkkijono	Suomalainen henkilötunnus.
syntymäaika	0..1	päivämäärä	Henkilön syntymäaika. Muoto YYYY-MM-DD.
etunimet	1	merkkijono	Henkilön kaikki etunimet. Esimerkiksi Sanna Katariina.
kutsumanimi	1	merkkijono	Kutsumanimi, oltava yksi etunimistä. Esimerkiksi etunimille "Juha-Matti Petteri" kelpaavat joko "Juha-Matti", "Juha", "Matti" tai "Petteri".
sukunimi	1	merkkijono	Henkilön sukunimi. Henkilön sukunimen etuliite tulee osana sukunimeä.
äidinkieli	0..1	Koodistokoodiviite Koodisto: kieli	Opiskelijan äidinkieli (vrkn mukainen äidinkieli).
kansalaisuus	0..n	Koodistokoodiviite Koodisto: maatjavaltiot2	Opiskelijan kansalaisuudet.
turvakielto	0..1	true/false	Henkilöllä on turvakielto.

Oppija > Uusi henkilö

Henkilötiedot. Syötettäessä vaaditaan joko oppijanumero oid tai kaikki muut kentät, jolloin järjestelmään voidaan tarvittaessa luoda uusi henkilö.

Henkilö, jonka oppijanumero 'oid' ei ole tiedossa. Tietoja syötettäessä luodaan mahdollisesti uusi henkilö Henkilöpalveluun, jolloin henkilölle muodostuu oppijanumero.

Nimi	Lukumäärä	Tyyppi
hetu	1	merkkijono
etunimet	1	merkkijono
kutsumanimi	0..1	merkkijono
sukunimi	1	merkkijono

Englanniksi

Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.

Lokalisoitu teksti, jossa mukana englanti.

Nimi	Lukumäärä	Tyyppi	Kuvaus
en	1	merkkijono

Suomeksi

Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.

Lokalisoitu teksti, jossa mukana suomi.

Nimi	Lukumäärä	Tyyppi
fi	1	merkkijono
sv	0..1	merkkijono
en	0..1	merkkijono

Ruotsiksi

Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.

Lokalisoitu teksti, jossa mukana ruotsi.

Nimi	Lukumäärä	Tyyppi	Kuvaus
sv	1	merkkijono
en	0..1	merkkijono

Koodistokoodiviite

Nimi	Lukumäärä	Tyyppi	Kuvaus
koodiarvo	1	merkkijono	Koodin tunniste koodistossa.
nimi	0..1	Englanniksi Suomeksi Ruotsiksi	Tiedon syötössä kuvausta ei tarvita; kuvaus haetaan Koodistopalvelusta. Koodin selväkielinen, kielistetty nimi. Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.
lyhytNimi	0..1	Englanniksi Suomeksi Ruotsiksi	Tiedon syötössä kuvausta ei tarvita; kuvaus haetaan Koodistopalvelusta. Koodin selväkielinen, kielistetty lyhennetty nimi. Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.
koodistoUri	1	merkkijono	Käytetyn koodiston tunniste.
koodistoVersio	0..1	numero	Käytetyn koodiston versio. Jos versiota ei määritellä, käytetään uusinta versiota.