TODO: Laajennetaan dokumentti käsittämään myös muut migraatioon liittyvät tuonnit.
Table of Contents |
---|
VIRTA-tietotyypit
Tässä osiossa käsitellään perusrekisterin tietotyypit, jotka löytyvät Virrasta, mutta saattavat tarvita täydennystä muista tietojärjestelmistä kuten Winhasta.
Lähde: https://confluence.csc.fi/display/VIRTA/Tietovarannon+tiedot
Kommenttien selitykset
- S = Tieto Syntyy perusrekisterissä
- T = Tieto Tuotava nykyisestä opiskelijatietojärjestelmästä (esim. Winha)
- ~ = Tieto ei ole täsmälleen sama. Vaatii joko käsittelyä tai haun muualta
- K = Mapattava Koodistoon
Opiskelija
Kartoitus valmis.
Ks. https://confluence.csc.fi/display/VIRTA/Opiskelijat
- identity
- student
- student_relative
- idenity_role
Perusrekisteri | VIRTA | Kommentti |
---|---|---|
identity. | - | S |
identity. | - | T |
identity. | ( Opiskelija.Etunimet ) | ~ / T (Huom. kutsumanimi) |
identity. | Opiskelija.Sukunimi | |
identity. | Opiskelija.KirjoihintuloPvm | Huom. Tallennetaan myös identity_role -tauluun |
identity. | - | T |
identity. | - | S |
identity. | - | S |
- | S | |
student. | Opiskelija.KansallinenOppijanumero | |
student. | Opiskelija.Henkilotunnus | |
student. | Opiskelija.Henkilotunnus | ~ / T (Hetuttomille tuotava muualta) |
student. | Opiskelija.Etunimet | ~ |
student. | Opiskelija.Etunimet | ~ |
student. | Opiskelija.Etunimet | ~ |
student. | - | T |
student. | Opiskelija.Sukupuoli | K |
student. | Opiskelija.Asuinkunta | K |
student. | Opiskelija.Asuinkunta | Mikäli ulkomailla |
student. | - | T |
student. | - | T |
student. | - | T |
student. | Opiskelija.Aidinkieli | K |
student. | - | T |
student. | Opiskelija.Kansalaisuus | K |
student. | Opiskelija.Kansalaisuus | Mikäli ei löydy koodistosta (miksi ei?) |
student.address_residence_ | - | T |
student.address_residence_ | - | T |
student.address_residence_ | - | T |
student.address_residence_ | - | T |
student.address_home_ | - | T |
student.address_home_ | - | T |
student.address_home_ | - | T |
student.address_home_ | - | T |
student.address_billing_ | - | T |
student.address_billing_ | - | T |
student.address_billing_ | - | T |
student.address_billing_ | - | T |
student.address_billing_ | - | T |
student.address_billing_ | - | T |
student.address_billing_ | - | T |
student._primary | - | T |
student._secondary | - | T |
student._primary | - | T |
student. | - | T |
student. | - | T |
student. | - | T |
student. | - | S |
student. | - | S |
migration (table_name="student") | Opiskelija.avain | |
student_relative. | - | S (Tuodaanko omaistiedot? Winhasta?) |
student_relative. | - | ~ / migration (table_name="student") |
student_relative. | - | T |
student_relative. | - | T |
student_relative. | - | T |
student_relative. | - | T |
student_relative. | - | T |
student_relative. | - | S |
student_relative. | - | S |
identity_role. | - | S (identiteetin rooli = opiskelija) |
identity_role. | - | S / K |
identity_role. | Opiskelija.KirjoihintuloPvm | |
identity_role. | - | T (vrt. identity.) |
identity_role. | - | S |
identity_role. | - | S |
Opiskeluoikeus
Kartoitus valmis, huom. kuitenkin TODO -kohdat.
Ks. https://confluence.csc.fi/display/VIRTA/Opiskeluoikeudet
- study_entitlement
study_entitlement_detail
study_entitlement_specialisation
study_entitlement_status
study_entitlement_group
study_entitlement_qualification (ks. opintosuoritus!)
study_entitlement_tutor
Huomioita
- Opiskeluoikeuteen voi liittyä useita jaksoja. Nämä ovat opiskeluoikeuden versiotietoja.
- TODO: Opiskeluoikeuden jakso eli historiatiedot. Tauluun study_entitlement kirjataan ainoastaan kuranttia tietoa (eli viimeisin jakso). Muut mahdolliset jaksot talletataan erikseen, tarkemmin määriteltävään paikkaan.
- TODO: Opiskeluoikeuden jakso eli historiatiedot. Tauluun study_entitlement kirjataan ainoastaan kuranttia tietoa (eli viimeisin jakso). Muut mahdolliset jaksot talletataan erikseen, tarkemmin määriteltävään paikkaan.
- Opiskeluoikeus.Ensisijaisuus
- Ei tueta toistaiseksi
- Opiskeluoikeus.AsetusMaisteriOhjelma
- Ei talleteta opiskeluoikeuden tietoihin
- Ei talleteta opiskeluoikeuden tietoihin
- Opiskeluoikeus.Organisaatio:
- Ei tueta toistaiseksi
- Ei tueta toistaiseksi
- Opiskeluoikeus.Liittyvyys.liittyvaOpiskeluoikeusAvain
- Ei tueta toistaiseksi --> opiskelijalla erilliset opiskeluoikeudet
- Ei tueta toistaiseksi --> opiskelijalla erilliset opiskeluoikeudet
- Opiskeluoikeus.Siirto.lahdeOpiskeluoikeusAvain
- Ei tueta toistaiseksi.
- Ei tueta toistaiseksi.
- Opiskeluoikeus.Siirto.LasnaPoissaoloLukukausiMaara
- Ei tueta toistaiseksi
TODO: tarvitaan täydelliset läsnäolorivit.
- Ei tueta toistaiseksi
- Opiskeluoikeus.Jakso.Aikuiskoulutus
- Ei talleteta erikseen. Koulutusmuoto: study_entitlement.education_type_id.
- Opiskeluoikeus.Jakso.Patevyys
- Ei talleteta. Tavoiteltava pätevyys ei ole suoraan opiskelijaroolin tieto.
- Opiskeluoikeus.KansainvalinenVaihto
TODO: Miten huomioidaan?
Perusrekisteri | VIRTA | Kommentti |
---|---|---|
study_entitlement. | Opiskeluoikeus.avain | ~ / S Mappaus migration (table_name="student_entitlement") |
study_entitlement.identity_id | Opiskeluoikeus.opiskelijaAvain | ~, Mappaus migration (table_name="student") |
study_entitlement. | - | T / Virrasta ainoastaan Opiskeluoikeus.Jakso.Koulutuskunta |
study_entitlement. | Opiskeluoikeus.Jakso.Koulutuskieli | K |
study_entitlement. | Opiskeluoikeus.Jakso.koulutusmoduulitunniste | K |
study_entitlement. | Opiskeluoikeus.Jakso.Koulutuskoodi | K |
study_entitlement. | T | |
study_entitlement. | (-) | T / Vaihtoehtoisesti voidaan Opiskeluoikeus.AlkuPvm |
study_entitlement. | (-) | T / Vaihtoehtoisesti voidaan Opiskeluoikeus.LoppuPvm |
study_entitlement. | Opiskeluoikeus.AlkuPvm | |
study_entitlement. | Opiskeluoikeus.LoppuPvm | |
study_entitlement. | - | T |
study_entitlement. | - | T |
study_entitlement. | - | T |
- | T | |
study_entitlement. | Opiskeluoikeus.Tyyppi | ~ / Ks. VIRTA |
study_entitlement. | - | T |
study_entitlement. | - | T / Huom. Opiskeluoikeus.KansainvalinenVaihto |
study_entitlement. | - | T |
study_entitlement. | Opiskeluoikeus.Jakso.Koulutuskoodi | K / HUOM. Vaatimusmäärittelyssä opintoala (study_sector_id) on ammatillisen opettajankoulutuksen opiskelijoita koskeva tieto. |
study_entitlement. | Opiskeluoikeus.Jakso.Rahoituslahde | K |
study_entitlement.open_route | Opiskeluoikeus.AvoinVayla | |
study_entitlement. | - | T |
study_entitlement. | - | T |
study_entitlement. | - | T |
study_entitlement. | Opiskeluoikeus.Organisaatio (Rooli = lähde) | K |
study_entitlement. | Opiskeluoikeus.SiirtoOpiskelija.SiirtoPvm | |
study_entitlement. | - | T |
study_entitlement. | - | |
study_entitlement. | - | |
study_entitlement. | Opiskeluoikeus.Laajuus | |
study_entitlement. | - | T / Taustaorganisaation tiedot Winhasta? |
study_entitlement.bg_corporation_other | - | |
study_entitlement. | - | |
study_entitlement. | - | |
study_entitlement. | - | |
study_entitlement. | - | |
study_entitlement. | - | |
study_entitlement. | - | S |
study_entitlement. | - | S |
migration (table_name = "study_entitlement") | Opiskeluoikeus.avain | |
study_entitlement_specialisation.id | - | T / Suuntautumistiedot Winhasta? |
study_entitlement_specialisation. | - | |
study_entitlement_specialisation.spcialisation_id | - | |
study_entitlement_specialisation. | - | |
study_entitlement_specialisation. | - | |
Opiskeluoikeus.Tila | S (rivi per opiskeluoikeuden tila) | |
study_entitlement_status. | Opiskeluoikeus.avain | ~ |
study_entitlement_status.status_id | Opiskeluoikeus.Tila.koodi | K |
study_entitlement_status.validity_start_date | Opiskeluoikeus.Tila.AlkuPvm | |
study_entitlement_status.validity_end_date | Opiskeluoikeus.Tila.LoppuPvm | |
study_entitlement_status. | S | |
study_entitlement_status. | S | |
study_entitlement_tutor. | - | T / Tuutorit Winhasta? |
study_entitlement_tutor. | - | |
study_entitlement_tutor. | - | |
study_entitlement_tutor. | - | |
study_entitlement_tutor. | - | |
study_entitlement_tutor.created_date_time | - | |
study_entitlement_tutor.created_by_id | - | |
study_entitlement_tutor. | - | |
study_entitlement_tutor. | - |
Opintosuoritus
Kartoitus valmis, huom. TODO.
Huom. Tutkinto on yksi opintosuorituksen laji.
Ks. https://confluence.csc.fi/display/VIRTA/Opintosuoritukset
- study_accomplishment
- study_accomplishment_proportion
- study_entitlement_qualification
Huomioita
- Sisältyvyys vs. study_accomplishment.is_
- is_sub_attainment -rivi (osasuoritus) voidaan luoda ilman, että varsinaista opintosuoritusta on merkitty
- Sisältyvyys: TODO
- parent_id -opintosuoritukseen vai liitostaulu (n:m)
- Opintosuoritus.Organisaatio
- Ei tueta toistaiseksi
Opintosuorituksen koulutusala?
- Ei toistaiseksi erikseen opintosuorituksessa (tämä saadaan opinnosta?)
Opintosuoritus.OpetusharjoitteluTyyppi
- Ei tueta toistaiseksi
- Opintosuoritus.Luokittelu
- Opintosuoritus.Koulutuskoodi
- Liittyy suoritettuun tutkintoon (tutkinnon tietoihin). Ei tarvetta tuelle toistaiseksi.
Perusrekisteri | VIRTA | Kommentti |
---|---|---|
- | S | |
study_accomplishment. | Opintosuoritus.opiskeluoikeusAvain | ~, Mappaus migration (table_name="study_entitlement") |
study_accomplishment. | - | T? |
study_accomplishment. | - | T |
study_accomplishment. | Opintosuoritus.koulutusmoduulitunniste | ~, Mappaus migration (table_name="study_unit") |
study_accomplishment.type_id | Opintosuoritus.Laji | ~, Huom. mappaus VIRTA-skeemaan:
|
study_accomplishment.type_detail_id | Opintosuoritus.Opinnaytetyo | K / Tyypin tarkenteeksi opinnäytetyö |
study_accomplishment.is_ | ||
study_accomplishment.language_id | Opintosuoritus.Kieli | K |
study_accomplishment. | Opintosuoritus.Laajuus.Opintopiste | |
study_accomplishment. | VAKIO:ECTS | |
study_accomplishment.study_unit_name_1 | - / Opintosuoritus.Nimi | Kielivaihtoehdot tuotava? |
study_accomplishment.study_unit_name_2 | - / Opintosuoritus.Nimi | |
study_accomplishment.study_unit_name_3 | - / Opintosuoritus.Nimi | |
study_accomplishment. | - | ? |
study_accomplishment. | ||
study_accomplishment. | ||
study_accomplishment.display_study_unit_name | - | T |
study_accomplishment.display_alt_name | - | T |
study_accomplishment. | ||
study_accomplishment.municipality | ||
study_accomplishment.organization_id | Opintosuoritus.Organisaatio (Rooli = lähde) | "Suorituksen hyväksilukemisen lähde" |
study_accomplishment.place_of_accomplishment_1 | - | |
study_accomplishment.place_of_accomplishment_2 | - | |
study_accomplishment.place_of_accomplishment_3 | - | |
study_accomplishment.reason_for_exemption_id | - | T |
study_accomplishment.status | VAKIO:"C" | Tuodaan vain valmiita opintosuorituksia |
study_accomplishment. | Opintosuoritus.Arvosana."asteikko" / | K |
study_accomplishment. | Opintosuoritus.Arvosana."asteikko" / | K |
study_accomplishment. | Opintosuoritus.Arvosana."asteikko" / | ~ |
study_accomplishment.average_of_sub_attainments | ||
study_accomplishment. | Opintosuoritus.SuoritusPvm | |
study_accomplishment. | - | T |
study_accomplishment.is_commissioned | Opintosuoritus.Hankkeistettu | |
study_accomplishment. | - | T |
study_accomplishment. | Opintosuoritus.Lisatieto | |
study_accomplishment.created_date_time | Opintosuoritus.HyvaksilukuPvm | VIRTA: "Suorituksen hyväksilukemisen päivämäärä on tieto siitä, milloin opintosuoritus on hyväksytty tai kirjattu ym. kyseisen korkeakoulun rekisteriin." |
study_accomplishment.created_by | - | |
study_accomplishment. | - | S |
study_accomplishment. | - | S |
migration (table_name = "study_accomplishment") | Opintosuoritus.avain | |
study_accomplishment_proportion (value) | Opintosuoritus.TKILaajuus | K / Uusi rivi study_accomplishment_proportion -tauluun |
study_accomplishment_proportion (value) | Opintosuoritus.TKILaajuusHarjoittelu | K / Uusi rivi study_accomplishment_proportion -tauluun |
study_accomplishment_proportion (value) | Opintosuoritus.TKILaajuusMuu | K / Uusi rivi study_accomplishment_proportion -tauluun |
study_entitlement_qualification | Opintosuoritus.Patevyys | K / Uusi rivi study_entitlement_qualification -tauluun |
Lukukausi-ilmoittautuminen
Kartoitus valmis.
Ks. https://confluence.csc.fi/display/VIRTA/LukukausiIlmoittautumiset
- semester_enrollment
- semester_enrollment_payment
Perusrekisteri | VIRTA | Kommentti |
---|---|---|
semester_enrollment. | ||
semester_enrollment.parent_id | - | T / Läsnäolorivit tuotava alkuperäisestä tietojärjestelmästä. |
semester_enrollment. | LukukausiIlmoittautuminen.opiskeluoikeusAvain | ~, Mappaus migration (table_name="study_entitlement") Huom. VIRTA-skeemassa vain LukukausiIlmoittautuminen.opiskelijaAvain on pakollinen. |
semester_enrollment. | LukukausiIlmoittautuminen.Tila | K |
semester_enrollment. | LukukausiIlmoittautuminen.AlkuPvm | ~ / Yritetään parsia AlkuPvm perusteella |
semester_enrollment. | LukukausiIlmoittautuminen.AlkuPvm | |
semester_enrollment. | LukukausiIlmoittautuminen.LoppuPvm | |
semester_enrollment. | - | T ? |
semester_enrollment. | - | T ? |
semester_enrollment. | - | |
semester_enrollment. | - | |
semester_enrollment.created_date_time | LukukausiIlmoittautuminen.IlmoittautumisPvm | |
semester_enrollment. | - | S |
semester_enrollment. | - | S |
semester_enrollment_payment | LukukausiIlmoittautuminen.YlioppilaskuntaJasen | K |
semester_enrollment_payment | LukukausiIlmoittautuminen.YTHSMaksu | K |
Muut migraation sisällöt
Koodistot
Koodisto | Koodiston tunniste | Käyttö (esim.) | Lähde | Synkronointi | Tarvitaan migraatiossa | Tarkennus |
---|---|---|---|---|---|---|
Toimipiste | OFFICE | student_ | Peppi | |||
Tutkinto-ohjelma / koulutusohjelma | DEGREE_PROGRAMME | student_group. | Peppi | |||
Tutkinto | DEGREE | student_group. | ||||
Tutkintonimike | DEGREE_TITLE | student_group_degree_title. | ||||
Asiointi- / opetuskieli | TEACHING_LANGUAGE | student_group. | Pienempi joukko kieliä | |||
Organisaatioyksikkö | ORGANIZATION_UNIT | student_group. | ||||
Koulutustyyppi / koulutusmuoto | EDUCATION_TYPE | student_group. | Vaatimusmäärittelyssä puhutaan ristiin koulutustyypistä ja koulutusmuodosta. | |||
Rahoitus | FUNDING | student_group., | Tarvitaanko useampi rahoitus -koodisto? | |||
Läsnäolotieto | ATTENDANCE | semester_enrollment. | - | Tarvitaan VIRTA/Kela -aliakset | ||
Lukukausimaksun tyyppi | SEMESTER_ENROLLMENT_PRODUCT | semester_enrollment_payment.product_id | - | Mikäli maksutietojen tallennus toteutetaan geneerisesti, ks. semesterenrollmentpayment | ||
Sukupuoli | SEX | student. | Virta | Ei | ||
Kunta | MUNICIPALITY | student. | Manuaalinen | |||
Henkilön kieli | LANGUAGE | student., | https://virkailija.opintopolku.fi/koodisto-service/rest/json/kieli/koodi | |||
Valtio | COUNTRY | student. | Kansalaisuus | |||
Opintosuorituksen tyyppi | ACCOMPLISHMENT_TYPE | study_accomplishment.type_id | ||||
Opintosuorituksen tarkentava tyyppi | ACCOMPLISHMENT_TYPE_DETAIL | study_accomplishment.type_detail_id | ||||
Suoritustapa | ACCOMPLISHMENT_METHOD | study_accomplishment. | ||||
Organisaatio (ulkoinen) | ORGANIZATION | study_accomplishment.organization_id study_entitlement. study_entitlement. study_entitlement. | ||||
Vapautuksen syy | REASON_FOR_EXEMPTION | study_accomplishment.reason_for_exemption_id | ||||
Arvosteluasteikko | EVALUATION_SCALE | study_accomplishment. | Huom. hierarkkinen, sisältää arvosanat (EVALUATION_SCALE:GRADE) | |||
Arvosana | EVALUATION_SCALE:GRADE | study_accomplishment. | ||||
Suoritetun opinnon TKI- ym. osuudet | ACCOMPLISHMENT_PROPORTION | study_accomplishment. | ||||
Opiskelutyyppi | STUDY_ENTITLEMENT_TYPE | study_entitlement. | Pääopiskelija, Sivuopiskelija, Kurssiopiskelija | |||
Koulutus | EDUCATION | study_entitlement. | Peruskoulu, ylioppilas, alempi kk-tutkinto, ... | |||
Opintoala | STUDY_SECTOR | study_entitlement. | Täsmennettävä: "Ammatillisen opettajankoulutuksen opiskelijoita koskeva tieto" | |||
Suuntautuminen | SPECIALISATION | study_entitlement_specialisation.spcialisation_id | Huom. osa hierarkkista koodistoa | |||
Opiskeluoikeuden tila | STUDY_ENTITLEMENT_STATUS | study_entitlement_status.status_id | Virta | aktiivinen, optio, päättynyt, passivoitu, luopunut | ||
Pätevyys | QUALIFICATION | study_entitlement_ | ||||
Lukukausi | SEMESTER | semester._id | Syksy / kevät |
Roolit
Voidaan tehdä myös vakiopaletti: opiskelija, opettaja, ...
- role
Henkilökunta
- identity
- identity_role
Opiskelijaryhmät
- group
- group_detail
- identity_group
- study_entitlement_group
Migraation järjestys
Määritellään järjestys sen mukaan, mitä esitietoja kukin tietotyyppi vaatii. Esimerkiksi: Opiskelija > Opiskeluoikeus > Opintosuoritus.
TODO
- Perusrekisteriin siirryttäessä korkeakoulukohtaiset tietueet yksilöivät tunnisteet muuttuvat (ks. taulu migration). Miten vanhat/uudet tunnistetiedot klaarataan Virrassa? Ehdotuksia:
- Merkitään Perusrekisterin yksilöiviin tunnisteisiin etuliite/namespace. Esim. 891721 –> "XX:891721"