Page History

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.id	-	S
identity.screen_name	-	T
identity.first_name	( Opiskelija.Etunimet )	~ / T (Huom. kutsumanimi)
identity.last_name	Opiskelija.Sukunimi
identity.validity_start_date	Opiskelija.KirjoihintuloPvm	Huom. Tallennetaan myös identity_role -tauluun
identity.validity_end_date	-	T
identity.modified_date_time	-	S
identity.modified_by_id	-	S
student.identity_id	-	S
student.oid	Opiskelija.KansallinenOppijanumero
student.national_indentity_number	Opiskelija.Henkilotunnus
student.birth_date	Opiskelija.Henkilotunnus	~ / T (Hetuttomille tuotava muualta)
student.first_name_1	Opiskelija.Etunimet	~
student.first_name_2	Opiskelija.Etunimet	~
student.first_name_3	Opiskelija.Etunimet	~
student.former_last_name	-	T
student.sex_id	Opiskelija.Sukupuoli	K
student.municipality_of_residence_id	Opiskelija.Asuinkunta	K
student.municipality_of_residence_other	Opiskelija.Asuinkunta	Mikäli ulkomailla
student.temporary_municipality_of_residence_id	-	T
student.temporary_municipality_of_residence_other	-	T
student.language_of_education_id	-	T
student.native_language_id	Opiskelija.Aidinkieli	K
student.preferred_language_id	-	T
student.nationality_id	Opiskelija.Kansalaisuus	K
student.nationality_other	Opiskelija.Kansalaisuus	Mikäli ei löydy koodistosta (miksi ei?)
student.address_residence_street_address	-	T
student.address_residence_postal_code	-	T
student.address_residence_postal_address	-	T
student.address_residence_country	-	T
student.address_home_street_address	-	T
student.address_home_postal_code	-	T
student.address_home_postal_address	-	T
student.address_home_country	-	T
student.address_billing_street_address	-	T
student.address_billing_postal_code	-	T
student.address_billing_postal_address	-	T
student.address_billing_country	-	T
student.address_billing_description	-	T
student.address_billing_business_id	-	T
student.address_billing_email	-	T
student.email_primary	-	T
student.email_secondary	-	T
student.phone_primary	-	T
student.phone_secondary	-	T
student.further_information	-	T
student.data_sharing_prohibited	-	T
student.modified_date_time	-	S
student.modified_by_id	-	S
migration (table_name="student")	Opiskelija.avain
student_relative.id	-	S (Tuodaanko omaistiedot? Winhasta?)
student_relative.student_id	-	~ / migration (table_name="student")
student_relative.first_name	-	T
student_relative.last_name	-	T
student_relative.phone	-	T
student_relative.address	-	T
student_relative.preferred_language_id	-	T
student_relative.modified_date_time	-	S
student_relative.modified_by_id	-	S
identity_role.identity_id	-	S (identiteetin rooli = opiskelija)
identity_role.role_id	-	S / K
identity_role.validity_start_date	Opiskelija.KirjoihintuloPvm
identity_role.validity_end_date	-	T (vrt. identity.validity_end_date)
identity_role.modified_date_time	-	S
identity_role.modified_by_id	-	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.
Opiskeluoikeus.Ensisijaisuus
- Ei tueta toistaiseksi
Opiskeluoikeus.AsetusMaisteriOhjelma
- Ei talleteta opiskeluoikeuden tietoihin
Opiskeluoikeus.Organisaatio:
- Ei tueta toistaiseksi
Opiskeluoikeus.Liittyvyys.liittyvaOpiskeluoikeusAvain
- Ei tueta toistaiseksi --> opiskelijalla erilliset opiskeluoikeudet
Opiskeluoikeus.Siirto.lahdeOpiskeluoikeusAvain
- Ei tueta toistaiseksi.
Opiskeluoikeus.Siirto.LasnaPoissaoloLukukausiMaara
- Ei tueta toistaiseksi
  TODO: tarvitaan täydelliset läsnäolorivit.
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.id	Opiskeluoikeus.avain	~ / S Mappaus migration (table_name="student_entitlement")
study_entitlement.identity_id	Opiskeluoikeus.opiskelijaAvain	~, Mappaus migration (table_name="student")
study_entitlement.office_id	-	T / Virrasta ainoastaan Opiskeluoikeus.Jakso.Koulutuskunta
study_entitlement.language_id	Opiskeluoikeus.Jakso.Koulutuskieli	K
study_entitlement.degree_programme_id	Opiskeluoikeus.Jakso.koulutusmoduulitunniste	K
study_entitlement.degree_id	Opiskeluoikeus.Jakso.Koulutuskoodi	K
study_entitlement.degree_title_id		T
study_entitlement.estimate_studies_start	(-)	T / Vaihtoehtoisesti voidaan Opiskeluoikeus.AlkuPvm
study_entitlement.estimate_studies_end	(-)	T / Vaihtoehtoisesti voidaan Opiskeluoikeus.LoppuPvm
study_entitlement.right_to_study_start	Opiskeluoikeus.AlkuPvm
study_entitlement.right_to_study_end	Opiskeluoikeus.LoppuPvm
study_entitlement.max_attending_semesters	-	T
study_entitlement.max_non_attending_semesters	-	T
study_entitlement.initial_incoming_group_id	-	T
study_entitlement.study_entitlement_type_id	-	T
study_entitlement.education_type_id	Opiskeluoikeus.Tyyppi	~ / Ks. VIRTA
study_entitlement.organization_unit_id	-	T
study_entitlement.source_organisation_id	-	T / Huom. Opiskeluoikeus.KansainvalinenVaihto
study_entitlement.former_education_id	-	T
study_entitlement.study_sector_id	Opiskeluoikeus.Jakso.Koulutuskoodi	K / HUOM. Vaatimusmäärittelyssä opintoala (study_sector_id) on ammatillisen opettajankoulutuksen opiskelijoita koskeva tieto.
study_entitlement.funding_id	Opiskeluoikeus.Jakso.Rahoituslahde	K
study_entitlement.open_route	Opiskeluoikeus.AvoinVayla
study_entitlement.further_information_1	-	T
study_entitlement.further_information_2	-	T
study_entitlement.further_information_3	-	T
study_entitlement.former_organisation_id	Opiskeluoikeus.Organisaatio (Rooli = lähde)	K
study_entitlement.migration_date	Opiskeluoikeus.SiirtoOpiskelija.SiirtoPvm
study_entitlement.migration_notes_1	-	T
study_entitlement.migration_notes_2	-
study_entitlement.migration_notes_3	-
study_entitlement.credits_required	Opiskeluoikeus.Laajuus
study_entitlement.bg_corporation_id	-	T / Taustaorganisaation tiedot Winhasta?
study_entitlement.bg_corporation_other	-
study_entitlement.bg_corporation_street_address	-
study_entitlement.bg_corporation_postal_code	-
study_entitlement.bg_corporation_postal_address	-
study_entitlement.bg_corporation_country	-
study_entitlement.bg_corporation_further_information	-
study_entitlement.modified_date_time	-	S
study_entitlement.modified_by_id	-	S
migration (table_name = "study_entitlement")	Opiskeluoikeus.avain
study_entitlement_specialisation.id	-	T / Suuntautumistiedot Winhasta?
study_entitlement_specialisation.study_entitlement_id	-
study_entitlement_specialisation.spcialisation_id	-
study_entitlement_specialisation.modified_date_time	-
study_entitlement_specialisation.modified_by_id	-
study_entitlement_status.id	Opiskeluoikeus.Tila	S (rivi per opiskeluoikeuden tila)
study_entitlement_status.study_entitlement_id	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.modified_date_time		S
study_entitlement_status.modified_by_id		S
study_entitlement_tutor.study_entitlement_id	-	T / Tuutorit Winhasta?
study_entitlement_tutor.identity_id	-
study_entitlement_tutor.tutor_type_id	-
study_entitlement_tutor.validity_start_date	-
study_entitlement_tutor.validity_end_date	-
study_entitlement_tutor.created_date_time	-
study_entitlement_tutor.created_by_id	-
study_entitlement_tutor.modified_date_time	-
study_entitlement_tutor.modified_by_id	-

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_sub_attainment
- 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
study_accomplishment.id	-	S
study_accomplishment.study_entitlement_id	Opintosuoritus.opiskeluoikeusAvain	~, Mappaus migration (table_name="study_entitlement") Tarvittaessa mapataan tavalla tai toisella Opintosuoritus.opiskelijaAvain avulla.
study_accomplishment.planned_study_id	-	T?
study_accomplishment.realization_id	-	T
study_accomplishment.study_unit_id	Opintosuoritus.koulutusmoduulitunniste	~, Mappaus migration (table_name="study_unit")
study_accomplishment.type_id	Opintosuoritus.Laji	~, Huom. mappaus VIRTA-skeemaan: DEGREE_PROGRAMME –> tutkinto COURSE --> muu opintosuoritus STUDY_MODULE --> muu opintosuoritus UNOFFICIAL --> oppilaitoksen sisäinen
study_accomplishment.type_detail_id	Opintosuoritus.Opinnaytetyo	K / Tyypin tarkenteeksi opinnäytetyö
study_accomplishment.is_sub_attainment
study_accomplishment.language_id	Opintosuoritus.Kieli	K
study_accomplishment.credits	Opintosuoritus.Laajuus.Opintopiste
study_accomplishment.credit_scale	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.alt_name_1	-	?
study_accomplishment.alt_name_2
study_accomplishment.alt_name_3
study_accomplishment.display_study_unit_name	-	T
study_accomplishment.display_alt_name	-	T
study_accomplishment.accomplishment_method_id
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.evaluation_scale_id	Opintosuoritus.Arvosana."asteikko" / Opintosuoritus.Arvosana.Muu.Asteikko	K
study_accomplishment.grade_id	Opintosuoritus.Arvosana."asteikko" / Opintosuoritus.Arvosana.Muu.Koodi	K
study_accomplishment.numeric_grade	Opintosuoritus.Arvosana."asteikko" / Opintosuoritus.Arvosana.Muu.Koodi	~
study_accomplishment.average_of_sub_attainments
study_accomplishment.evaluation_date	Opintosuoritus.SuoritusPvm
study_accomplishment.evaluated_by_id	-	T
study_accomplishment.is_commissioned	Opintosuoritus.Hankkeistettu
study_accomplishment.internal_notes	-	T
study_accomplishment.student_notes	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.modified_date_time	-	S
study_accomplishment.modified_by_id	-	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.id
semester_enrollment.parent_id	-	T / Läsnäolorivit tuotava alkuperäisestä tietojärjestelmästä.
semester_enrollment.study_entitlement_id	LukukausiIlmoittautuminen.opiskeluoikeusAvain (LukukausiIlmoittautuminen.opiskelijaAvain)	~, Mappaus migration (table_name="study_entitlement") Huom. VIRTA-skeemassa vain LukukausiIlmoittautuminen.opiskelijaAvain on pakollinen. Tarvittaessa mäpättävä tämän perusteella tavalla tai toisella.
semester_enrollment.attendance_id	LukukausiIlmoittautuminen.Tila	K
semester_enrollment.semester_id	LukukausiIlmoittautuminen.AlkuPvm	~ / Yritetään parsia AlkuPvm perusteella
semester_enrollment.validity_start_date	LukukausiIlmoittautuminen.AlkuPvm
semester_enrollment.validity_end_date	LukukausiIlmoittautuminen.LoppuPvm
semester_enrollment.funding_id	-	T ?
semester_enrollment.further_information_1	-	T ?
semester_enrollment.further_information_2	-
semester_enrollment.further_information_3	-
semester_enrollment.created_date_time	LukukausiIlmoittautuminen.IlmoittautumisPvm
semester_enrollment.modified_date_time	-	S
semester_enrollment.modified_by_id	-	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	Tarkennus
Toimipiste	OFFICE	student_group.office_id study_entitlement.office_id	Peppi
Tutkinto-ohjelma / koulutusohjelma	DEGREE_PROGRAMME	student_group.degree_programme_id study_entitlement.degree_programme_id	Peppi
Tutkinto	DEGREE	student_group.degree_id study_entitlement.degree_id
Tutkintonimike	DEGREE_TITLE	student_group_degree_title.degree_title_id study_entitlement.degree_title_id
Asiointi- / opetuskieli	TEACHING_LANGUAGE	student_group.teaching_language_id student.preferred_language_id study_accomplishment.language_id study_entitlement.language_id template.language_id			Pienempi joukko kieliä
Organisaatioyksikkö	ORGANIZATION_UNIT	student_group.organization_unit_id
Koulutustyyppi / koulutusmuoto	EDUCATION_TYPE	student_group.education_type_id student_entitlement.education_type_id			Vaatimusmäärittelyssä puhutaan ristiin koulutustyypistä ja koulutusmuodosta. Molemmilla tarkoitetaan ilmeisesti samaa: Nuoret, Aikuiset, Avoin AMK, YAMK, Erikoistumisopinnot, Täydennyskoulutus, Maahanmuuttajien valmentava koulutus, Oppisopimustyyppinen koulutus, Opettajan koulutus, ...
Rahoitus	FUNDING	student_group.funding_id, semester_enrollment.funding_id study_entitlement.funding_id study_entitlement_content.funding_id			Tarvitaanko useampi rahoitus -koodisto?
Läsnäolotieto	ATTENDANCE	semester_enrollment.attendance_id	-		Tarvitaan VIRTA/Kela -aliakset Tarvitaan Läsnä/Poissa aliakset
Lukukausimaksun tyyppi	SEMESTER_ENROLLMENT_PRODUCT	semester_enrollment_payment.product_id	-		Mikäli maksutietojen tallennus toteutetaan geneerisesti, ks. semesterenrollmentpayment
Sukupuoli	SEX	student.sex_id	Virta	Ei
Kunta	MUNICIPALITY	student.municipality_of_residence_id, student.temporary_municipality_of_residence_id		Manuaalinen
Henkilön kieli	LANGUAGE	student.language_of_education_id, student.native_language_id student_relative.preferred_language_id			https://virkailija.opintopolku.fi/koodisto-service/rest/json/kieli/koodi
Valtio	COUNTRY	student.nationality_id			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.accomplishment_method_id
Organisaatio (ulkoinen)	ORGANIZATION	study_accomplishment.organization_id study_entitlement.source_organisation_id study_entitlement.former_organisation_id study_entitlement.bg_corporation_id
Vapautuksen syy	REASON_FOR_EXEMPTION	study_accomplishment.reason_for_exemption_id
Arvosteluasteikko	EVALUATION_SCALE	study_accomplishment.evaluation_scale_id			Huom. hierarkkinen, sisältää arvosanat (EVALUATION_SCALE:GRADE)
Arvosana	EVALUATION_SCALE:GRADE	study_accomplishment.grade_id
Suoritetun opinnon TKI- ym. osuudet	ACCOMPLISHMENT_PROPORTION	study_accomplishment.proportion_id
Opiskelutyyppi	STUDY_ENTITLEMENT_TYPE	study_entitlement.study_entitlement_type_id			Pääopiskelija, Sivuopiskelija, Kurssiopiskelija
Koulutus	EDUCATION	study_entitlement.former_education_id			Peruskoulu, ylioppilas, alempi kk-tutkinto, ...
Opintoala	STUDY_SECTOR	study_entitlement.study_sector_id			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_qualification.qualification_id
Lukukausi	SEMESTER	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"

Space shortcuts

Page tree

Versions Compared

Old Version 4

New Version Current

Key