Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Versio 1.06.1

Opintosuoritukset-tiedonsiirtoskeema. XML-skeema jonka avulla voidaan siirtää useita opintosuoritusten tietoja kerralla. Skeeman voi myös lukea sisään muihin skeemoihin jolloin myös yksittäisiä tietoja voidaan antaa.

Versio 1.0506.1

Kaaviokuva

XML-skeema
Code Block
titleOpintosuoritukset.xsd
linenumberstrue
collapsetrue
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema version="1.0506.1"
  attributeFormDefault="unqualified"
  elementFormDefault="qualified"
  targetNamespace="urn:mace:funet.fi:virta/2015/201309/01/29"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xs="http://www.w3.org/2001/XMLSchema"
  xmlns:virta="urn:mace:funet.fi:virta/20132015/09/01/29">
<xs:include schemaLocation="tyypit.xsd">
	<xs:annotation>
		<xs:documentation xml:lang="fi">
			Tiedonsiirtoelementtien tyypit.
		</xs:documentation>
	</xs:annotation>
</xs:include>
<!-- OPINTOSUORITUSTEN RAKENNE -->
<!-- Elementtinä, jos skeema-tiedostoa käytetään suoraan xml-tiedoston skeemana -->
<!-- Tämä on siis ainoa globaali elementti, muutoin oltava jonkin muun elementin sisällä -->
<xs:element name="Opintosuoritukset" type="virta:OpintosuorituksetLaajennettuTyyppiOpintosuorituksetTyyppi"/>
<!-- Tyyppinä ilman organisaatio- ja lang-attribuutteja, jos skeemaa käytetään sisäkkäisesti toisesta skeemasta -->
<xs:complexType name="OpintosuorituksetTyyppi">
	<xs:annotation>
		<xs:documentation xml:lang="fi">
			Opintosuoritukset
			* Juurielementti useille opintosuorituksille
		</xs:documentation>
		<xs:documentation xml:lang="en">
			Studies
			* Root element for several studies
		</xs:documentation>
	</xs:annotation>
	<xs:sequence>
		<xs:element name="Opintosuoritus" type="virta:OpintosuoritusTyyppi" minOccurs="1" maxOccurs="unbounded"/>
	</xs:sequence>
</xs:complexType>
<!-- Laajennetaan tyyppiä -->
<xs:complexType name="OpintosuorituksetLaajennettuTyyppiOpintosuoritusTyyppi">
	<xs:complexContent>annotation>
		<xs:extensiondocumentation basexml:lang="virta:OpintosuorituksetTyyppifi">
			<xs:attributeGroup ref="virta:JuuriElementtiLaajennusTyyppi"/>Opintosuoritus
		</xs:extension>
	</xs:complexContent>
</xs:complexType>
<xs:complexType name="OpintosuoritusTyyppi">
	<xs:annotation>
		<xs:documentation xml:lang="fi">
			Opintosuoritus
			* Yksittäinen opintosuoritus
		</xs:documentation>
		<xs:documentation xml:lang="en">
			Study
			* Single study
		</xs:documentation>
	</xs:annotation>
	<xs:sequence>
		<xs:element name="SuoritusPvm" type="virta:PvmTyyppi" minOccurs="1" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Suorituspäivämäärä.
					
					Päivämäärä jolloin suoritus on tehty tai saatettu hyväksyttävästi loppuun.
					
					Kysymyksiä ja vastauksia (2012-09-25):
					"""
					VIRTA-projektissa ei oteta kantaa siihen mikä on oikea tulkinta, nykyisin
					ainakin seuraavia tulkintaperusteita käytössä:
					voi olla, suoritusjakso kurssin alusta loppuun
					"suorituspäivämäärä" esim. tenttipäivä
					suorituksen arviointipäivämäärä (kun arvosana annetaan)
					suorituksen rekisteröintipäivä (hallinnollinen päivämäärä)
					"""
					Suoritusjaksosta sallimme vain yhden päivämäärän (vaikka loppupvm).
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="Laajuus" type="virta:LaajuusLaajennettuTyyppi" minOccurs="1" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Laajuus. Tietona on mahdollista antaa sekä opintopiste (ects) että opintoviikko (cu).
				</xs:documentation>
				<xs:documentation xml:lang="en">
					Credits. Both ECTS (op) and CU (ov).
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="Arvosana" type="virta:ArvosanaTyyppi" minOccurs="1" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opintosuorituksen arvosana-asteikko ja arvosana.
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="Myontaja" type="virta:OrganisaatioRooliOsuusLaajennettu1TyyppiOrganisaatioKoodiTyyppi" minOccurs="1" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opintosuorituksen myöntänyt organisaatio (oppilaitos). Pakollinen.
					</xs:documentation>
					Opintosuoritukseen liittyvä pakollinen organisaatiotieto kertaalleen</xs:annotation>
		</xs:element>
		<xs:element name="Organisaatio" type="virta:OrganisaatioRooliOsuusTyyppi" minOccurs="0" maxOccurs="unbounded">
			<xs:annotation>
				(suhde: 1..1) myöntävä-roolilla. Osuus voi olla mitä vain, jota<xs:documentation xml:lang="fi">
					Opintosuoritukseen liittyvät valinnaiset organisaatiotiedot.
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="Laji" type="virta:OpintosuoritusLajiKoodiTyyppi" minOccurs="1" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					osuus-tietoa voi täydentää seuraavilla Organisaatio-elementeilläOpintosuorituksen laji.
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="OrganisaatioNimi" type="virta:OrganisaatioRooliOsuusTyyppiOpintosuoritusNimiTyyppi" minOccurs="0" maxOccurs="unbounded">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opintosuoritukseen liittyvät valinnaiset organisaatiotiedotOpintosuorituksen nimi.
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="LajiKieli" type="virta:OpintosuoritusLajiKoodiTyyppiKieliKoodiTyyppi" minOccurs="10" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opintosuorituksen lajikieli (koodisto).
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="NimiKoulutuskoodi" type="virta:OpintosuoritusNimiTyyppiKoulutuskoodiKoodiTyyppi" minOccurs="0" maxOccurs="unbounded1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">">
					Koulutuskoodi (Tutkinto) (koodisto).
					Opintosuorituksen nimiTilastokeskuksen Koulutusluokituksen avaintietona oleva koulutuskoodi.
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="Kieli" type="virta:KieliKoodiTyyppi" minOccurs="0" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">	Koulutusluokitus 2011: http://www.stat.fi/meta/luokitukset/koulutus/001-2011/kuvaus.html
					Vain tutkinnoille.
					
					Opintosuorituksen kieli (koodisto).Tietosisältö: Tutkintonimike (ID34), Koulutusala (ID35), Tutkinnon taso (ID36)
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="KoulutuskoodiKoulutusala" type="virta:KoulutuskoodiKoodiTyyppiKoulutusalaVersioOsuusTyyppi" minOccurs="0" maxOccurs="1unbounded">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					KoulutuskoodiYhdistetty (Tutkinto)koulutusala (koodisto).
					Tilastokeskuksen Koulutusluokituksen avaintietona oleva koulutuskoodi.
					Koulutusluokitus 2011: http://www.stat.fi/meta/luokitukset/koulutus/001-2011/kuvaus.html
					Vain tutkinnoille osuus-tiedolla.
					
					Tietosisältö:Tieto Tutkintonimike (ID34), Koulutusala (ID35), Tutkinnon taso (ID36)tarvitaan kaikista ei tutkinto-opintosuorituksista. Tai tarkemmin
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:choice>
			<xs:annotation>
				<xs:documentation xml:lang="fi">	sanottuna opintosuorituksista, joilla ei ole koulutuskoodi-tietoa, jolloin
					Koulutusala (koodisto)tieto on valinnainen.
					
					TietoKoulutusalan kolme tarvitaaneri kaikistaversiota ei(+ tutkinto-opintosuorituksista. Tai tarkemmin1-2 opintoalaa):
					(* Koulutusala 2002 (opmala)
					sanottuna(* opintosuorituksista,Koulutusala joilla ei ole koulutuskoodi-tietoa, jolloin1995 (opm95ala)
					tieto on valinnainen.(* Koulutusala (kala) (Tilastokeskuksen oma versio)
					(* ISCED 2011 pääluokka (broad fields)
					Koulutusalan(* kolme eri versiota (+ 1-2 opintoalaa):OKM ohjauksen ala
					* KoulutusalaISCED 2011 2002väliluokka (opmalanarrow fields)
					(* KoulutusalaOpintoala 1995 (opm95ala)
					(* Koulutusala (kala) (Tilastokeskuksen oma versio)Opintoala 2002
					(* Opintoala 1995ISCED 2011 ala (detailed field) (iscfi2013)
					(* Opintoala 2002
					Yliopistoilla on ollut käytössä OPINTOALA 1995.
					YliopistoillaAmmattikorkeakouluilla käytössäon OPINTOALAollut 1995käytössä (eiKOULUTUSALA koulutusala)2002.
					AmmattikorkeakouluillaYhteisesti käytetään käytössäISCED KOULUTUSALA2011 2002väliluokkaa.
					
					Opintosuoritukseen voi liittyä useita koulutusala-tietoja, jolloin jakautuminen
					voidaan kertoa osuus-tietona. Osuus-tieto on väliltä 0-1.
				</xs:documentation>
			</xs:annotation>
			<xs:element name="Koulutusala2002" type="virta:KoulutusalaVersioOPMALATyyppi" minOccurs="0" maxOccurs="unbounded"/>
			<xs:element name="Opintoala1995" type="virta:KoulutusalaVersioOPM95OPATyyppi" minOccurs="0" maxOccurs="unbounded"/> väliltä 0-1.
				</xs:documentation>
			</xs:annotation>
		</xs:choice>element>
		<xs:element name="Sisaltyvyys" minOccurs="0" maxOccurs="unbounded">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opintosuorituksen sisältyminen toiseen opintosuoritukseen.
					
					Opintosuoritus voi sisältää usean toisen opintosuorituksen. Sisältäminen
					voidaan kertoa opintopistelaajuus-tietona.
					
					Tutkinnot sekä opintosuoritusten muodostamat kokonaisuudet sisältävät
					opintosuorituksia. Tätä kutsutaan myös hierarkiaksi ja ilmiötä kuvataan
					suoritusten ominaisuuksilla:
					"Suorituksen sisältyminen toiseen suoritukseen (jonka id)" ja
					"Suoritukseen sisältyy toisia suorituksia (joiden id:t)" sekä tutkinnon
					ominaisuudella "Tutkintoon sidotut suoritukset".
					Hierarkia kuvataan vain yhteen suuntaan: "tämä opintosuoritus sisältää"
					eli "vanhemmasta lapseen" ("has part").
					
					Muun muassa Tilastokeskuksen tutkintotiedonkeruussa on kerätty tietoa
					erilaisista tutkintoon sisältyvistä opintopistemääristä, joiden osalta jatkossa
					tieto saataisiin laskemalla tutkinnon sisältämien suoritusten laajuudet yhteen.
				</xs:documentation>
			</xs:annotation>
			<xs:complexType>
				<xs:sequence>
					<xs:element name="Opintopiste" type="virta:LaajuusTyyppi" minOccurs="0" maxOccurs="1"/>
				</xs:sequence>
				<xs:attribute name="sisaltyvaOpintosuoritusAvain" type="virta:OpintosuoritusAvainTyyppiAvainTyyppi" use="required"/>
			</xs:complexType>
		</xs:element>
		<xs:element name="HyvaksilukuPvm" type="virta:PvmTyyppi" minOccurs="0" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Suorituksen hyväksilukemisen päivämäärä.
					
					Päivämäärä jolloin aiemmin hankittu osaaminen tunnustetaan hallinnollisella
					päätöksellä hyväksiluetuksi suoritukseksi.
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="TKILaajuus" type="virta:LaajuusLaajennettuTyyppi" minOccurs="0" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opintosuoritukseen sisältyvän opinnäytetyön tutkimus ja kehittämistoiminnan laajuus (TKI).
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="TKILaajuusHarjoittelu" type="virta:LaajuusLaajennettuTyyppi" minOccurs="0" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opintosuorituksen sisältyvän tutkimus ja kehittämistoiminnan osana tehdyn harjoittelun laajuus (TKI).
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="TKILaajuusMuu" type="virta:LaajuusLaajennettuTyyppi" minOccurs="0" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opintosuoritukseen sisältyvien muiden opintojen tutkimus ja kehittämistoiminnan laajuus (TKI).
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="OpetusharjoitteluTyyppi" type="virta:OpetusharjoitteluTyyppiKoodiTyyppi" minOccurs="0" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opintosuoritus on tehty harjoittelukoulussa ja sen opetusharjoittelun tyyppi -alakategoriassa.
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="Opinnaytetyo" type="virta:KyllaEiKytkinTyyppi" minOccurs="0" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opintosuoritus on tehty opinnäytetyönä. Kyllä/Ei -kytkin (Boolean).
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="Hankkeistettu" type="virta:KyllaEiKytkinTyyppi" minOccurs="0" maxOccurs="1">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opinnäytetyö on hankkeistettu. Kyllä/Ei -kytekin (Boolean).
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="Patevyys" type="virta:PatevyysKoodiTyyppi" minOccurs="0" maxOccurs="unbounded">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opintosuoritus on tuottanut pätevyyden (koodisto). Valinnainen. Saa olla useita.
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="Luokittelu" type="virta:OpintosuoritusLuokitteluKoodiTyyppi" minOccurs="0" maxOccurs="unbounded">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opintosuoritus on... (luokittelukoodisto). Valinnainen. Saa olla useita.
					- avoimessa korkeakouluopetuksessa suoritettu
					- tulevan kansainvälisen vaihto-opiskelijan suorittama
					- korkeakoulujen välisillä yhteistyösopimuksilla opiskelevan suorittama
					- erillisellä opiskeluoikeudella opiskelevan suorittama
					- erillisellä opiskeluoikeudella opettajankoulutuksen opintoja suorittavan opiskelijan suorittama
					- maahanmuuttajien valmentavassa koulutuksessa opiskelevan suorittama
				</xs:documentation>
			</xs:annotation>
		</xs:element>
		<xs:element name="JulkinenLisatieto" type="virta:OpintosuoritusJulkinenLisatietoTyyppi" minOccurs="0" maxOccurs="unbounded">
			<xs:annotation>
				<xs:documentation xml:lang="fi">
					Opintosuorituksen lisätiedot. Vain julkiset lisätiedot.
				</xs:documentation>
			</xs:annotation>
		</xs:element>
	</xs:sequence>
	<xs:attribute name="avain" type="virta:OpintosuoritusAvainTyyppiAvainTyyppi" use="required">
		<xs:annotation>
			<xs:documentation xml:lang="fi">
				Opintosuorituksen avain. Pakollinen.
				Synonyymejä: "sekvenssi", "surrogaatti".
				
				Opintosuorituksilla, tutkinnoilla, opiskeluoikeuksilla ja henkilöillä on yksilöivä
				id (avain), jolla tarkoitetaan koneellisen aukottoman tunnistamisen mahdollisuutta.
				Tällaista id-tietoa ei nykyisin ole valtakunnallisella tasolla ja jatkossakin
				tieto perustunee korkeakoulun antaman yksilöivän tunnisteen ja korkeakoulun
				tunnisteen yhdistelmään paitsi henkilöiden osalta.
			</xs:documentation>
		</xs:annotation>
	</xs:attribute>
	<xs:attribute name="opiskelijaAvain" type="virta:OpiskelijaAvainTyyppiAvainTyyppi" use="required">
		<xs:annotation>
			<xs:documentation xml:lang="fi">
				Opintosuorituksen tehneen opiskelijan (henkilön) avain. Pakollinen.
			</xs:documentation>
		</xs:annotation>
	</xs:attribute>
	<xs:attribute name="koulutusmoduulitunniste" type="virta:KoulutusmoduulitunnisteTyyppi" use="required">
		<xs:annotation>
			<xs:documentation xml:lang="fi">
				Koulutusmoduulin tunniste. Pakollinen.
				
				Koulutusmoduuli on uusi tietoarkkitehtuurin käsite, joka vastaa eurooppalaisten standardien
				"learning opportunity" -käsitettä (CEN 2011: MLO-AD, ELM EuroLMAI).
				Koulutusmoduuliin voi sisältyä koulutusmoduuleja ja koulutusmoduuli voi esimerkiksi olla
				tutkinto, tutkinnon osa, kokonaisuus tai kurssi.
				Koulutusmoduulin tiedot löytyvät korkeakoulujen omista koulutustarjonta- ja
				opetustarjontatietovarannoista. Tässä tietotarkkitehtuurissa koulutusmoduulin tunnisteet
				ovat varautumista tietojen yhdisteltävyyteen.
				Kuvaus Oppijan tietomallin osassa koulutuksen rakenne
				(https://confluence.csc.fi/display/oppija/Koulutuksen+rakenne).
			</xs:documentation>
		</xs:annotation>
	</xs:attribute>
	<xs:attribute name="valtakunnallinenKoulutusmoduulitunniste" type="virta:ValtakunnallinenKoulutusmoduulitunnisteTyyppi" use="optional">
		<xs:annotation>
			<xs:documentation xml:lang="fi">
				Valtakunnallisen koulutusmoduulin tunniste. Valinnainen.
			</xs:documentation>
		</xs:annotation>
	</xs:attribute>
	<xs:attribute name="opiskeluoikeusAvain" type="virta:OpiskeluoikeusAvainTyyppiAvainTyyppi" use="optional">
		<xs:annotation>
			<xs:documentation xml:lang="fi">
				Opintosuoritukseen liittyvän opiskeluoikeuden avain. Valinnainen, mutta pakollinen tutkinnoilla.
			</xs:documentation>
		</xs:annotation>
	</xs:attribute>
</xs:complexType>
</xs:schema>