Opintosuoritukset

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema version="0.61"
 attributeFormDefault="unqualified"
 elementFormDefault="qualified"
 targetNamespace="urn:mace:funet.fi:virta/2012/10/04"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:xs="http://www.w3.org/2001/XMLSchema"
 xmlns:virta="urn:mace:funet.fi:virta/2012/10/04">

<xs:import namespace="http://www.w3.org/XML/1998/namespace" schemaLocation="http://www.w3.org/2001/03/xml.xsd">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 XML-nimiavaruus tarvitaan lähinnä xml:lang -attribuutin vuoksi, mutta käyttötarpeita saattaa tulla myöhemmin lisää.
 </xs:documentation>
 </xs:annotation>
</xs:import>

<xs:include schemaLocation="tyypit.xsd">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Tiedonsiirtoelementtien tyypit.
 </xs:documentation>
 </xs:annotation>
</xs:include>

<xs:include schemaLocation="koodistot.xsd">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Koodistot.
 </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:OpintosuorituksetLaajennettuTyyppi"/>

<!-- 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="OpintosuorituksetLaajennettuTyyppi">
 <xs:complexContent>
 <xs:extension base="virta:OpintosuorituksetTyyppi">
 <xs:attributeGroup ref="virta:JuuriElementtiLaajennusTyyppi"/>
 </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="Pvm" 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:LaajuusTyyppi" 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">
 Suorituksen arvosana ja arvosana-asteikko.
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 <xs:element name="Organisaatio" minOccurs="1" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Opintosuorituksen organisaatiotiedot.
 
 Pakotettu organisaatiotieto kertaalleen (suhde: 1..1) myöntävä-roolilla.
 Osuus voi olla mitä vain kuitenkin.
 </xs:documentation>
 </xs:annotation>
 <xs:complexType>
 <xs:sequence>
 <xs:element name="Rooli" type="virta:OrganisaatioRooliTyyppi" minOccurs="1" maxOccurs="1" fixed="M"/>
 <xs:element name="Koodi" type="virta:OrganisaatioKoodiTyyppi" minOccurs="1" maxOccurs="1"/>
 <xs:element name="Osuus" type="virta:OsuusTyyppi" minOccurs="1" maxOccurs="1"/>
 </xs:sequence>
 </xs:complexType>
 </xs:element>
 <xs:element name="Organisaatio" minOccurs="0" maxOccurs="unbounded">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Opintosuorituksen organisaatiotiedot.
 
 Suoritus voi kuulua useaan organisaatioon, jolloin jakautuminen voidaan kertoa osuus-tietona. Osuustieto on väliltä 0-1.
 Osuuksien yhteenlaskettu summa tulisi olla tasan 1. Per rooli.
 </xs:documentation>
 </xs:annotation>
 <xs:complexType>
 <xs:sequence>
 <xs:element name="Rooli" type="virta:OrganisaatioRooliTyyppi" minOccurs="1" maxOccurs="1"/>
 <xs:element name="Koodi" type="virta:OrganisaatioKoodiTyyppi" minOccurs="1" maxOccurs="1"/>
 <xs:element name="Osuus" type="virta:OsuusTyyppi" minOccurs="1" maxOccurs="1"/>
 </xs:sequence>
 </xs:complexType>
 </xs:element>
 <xs:element name="Laji" minOccurs="1" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Opintosuorituksen laji.
 </xs:documentation>
 </xs:annotation>
 <xs:complexType>
 <xs:sequence>
 <xs:element name="Koodi" type="virta:OpintosuoritusLajiKoodiTyyppi" minOccurs="1" maxOccurs="1"/>
 </xs:sequence>
 </xs:complexType>
 </xs:element>
 <xs:element name="Koulutuskoodi" type="virta:KoulutuskoodiKoodiTyyppi" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Koulutuskoodi (Tutkinto) (koodisto).

 Tilastokeskuksen Koulutusluokituksen avaintietona oleva koulutuskoodi.
 Koulutusluokitus 2011: http://www.stat.fi/meta/luokitukset/koulutus/001-2011/kuvaus.html
 Vain tutkinnoille.
 
 Tietosisältö: Tutkintonimike (ID34), Koulutusala (ID35), Tutkinnon taso (ID36)
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 <xs:element name="Nimi" type="virta:OpintosuoritusNimiTyyppi" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suorituksen nimi.
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 <xs:element name="Sisaltaa" minOccurs="0" maxOccurs="unbounded">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suorituksen sisältyminen toiseen suoritukseen.
 
 Suoritus voi sisältyä useaan toiseen suoritukseen, jolloin jakautuminen voidaan
 kertoa osuus-tietona. Osuus-tieto on väliltä 0-1.
 Osuus-tietojen yhteenlaskettu summa tulee olla tasan 1.
 
 Tutkintoihin ja suoritusten muodostamiin kokonaisuuksiin sisältyy suorituksia
 eli toisin päin suoritukset sisältyvät toisiin suorituksiin, mm. tutkintoihin.
 Tätä kutsutaan 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".
 Todennäköisesti sisältymistä kuvataan vain yhteen suuntaan, sisältymisenä
 toiseen eli "lapselta vanhempaan". Muun muassa Tilastokeskuksen
 tutkintotiedonkeruussa on kerätty tietoa erilaisista tutkintoon sisältyvistä
 opintopistemääristä, joiden osalta jatkossa tieto saataisiin laskemalla
 tutkintoon sisältyvien suoritusten laajuudet yhteen.
 </xs:documentation>
 </xs:annotation>
 <xs:complexType>
 <xs:sequence>
 <xs:element name="Osuus" type="virta:OsuusTyyppi" minOccurs="0" maxOccurs="1"/>
 </xs:sequence>
 <xs:attribute name="sisaltyvaID" type="virta:OpintosuoritusYksiloivaIDTyyppi" use="required"/>
 </xs:complexType>
 </xs:element>
 <xs:element name="Hyvaksiluettu" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Hyväksiluettu suoritus.
 </xs:documentation>
 </xs:annotation>
 <xs:complexType>
 <xs:sequence>
 <xs:element name="Pvm" type="virta:PvmTyyppi" minOccurs="1" 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="Lahde" type="virta:OrganisaatioKoodiTyyppi" minOccurs="1" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suorituksen hyväksilukemisen lähde.

 Viittaus organisaatio-koodistoon (organisaatioroolilla lähde "piilotettuna").
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 </xs:sequence>
 </xs:complexType>
 </xs:element>
 <xs:element name="Kieli" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suorituksen kieli (koodisto).
 
 Versiot? (ISO, suomi/muu, suomi/ruotsi/muu)
 </xs:documentation>
 </xs:annotation>
 <xs:complexType>
 <xs:sequence>
 <xs:element name="Koodi" type="virta:KieliKoodiTyyppi" minOccurs="1" maxOccurs="1"/>
 </xs:sequence>
 </xs:complexType>
 </xs:element>
 <xs:element name="Koulutusala" minOccurs="0" maxOccurs="unbounded">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Koulutusala (koodisto).
 
 Suoritukseen voi liittyä useita koulutusala-tietoja, jolloin jakautuminen voidaan kertoa osuus-tietona. Osuus-tieto on väliltä 0-1.
 Koulutusala-tietojen yhteenlaskettu osuus tulisi olla tasan 1. Per eri koulutusala-tiedon versio.
 </xs:documentation>
 </xs:annotation>
 <xs:complexType>
 <xs:sequence>
 <xs:element name="Versio" type="virta:KoulutusalaVersioTyyppi" minOccurs="1" maxOccurs="1"/>
 <xs:element name="Koodi" type="virta:KoulutusalaKoodiTyyppi" minOccurs="1" maxOccurs="1"/>
 <xs:element name="Osuus" type="virta:OsuusTyyppi" minOccurs="0" maxOccurs="1"/>
 </xs:sequence>
 </xs:complexType>
 </xs:element>
 <xs:element name="Harjoittelukoulu" type="virta:HarjoittelukouluAlakategoriaKoodiTyyppi" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suoritus on tehty harjoittelukoulussa ja sen alakategoriassa.
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 <xs:element name="Lisatieto" type="virta:OpintosuoritusLisatietoTyyppi" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suorituksen lisätiedot.
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 <xs:element name="TKILaajuus" type="virta:LaajuusTyyppi" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suoritukseen sisältyvän opinnäytetyön tutkimus ja kehittämistoiminnan laajuus (TKI).
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 <xs:element name="TKILaajuusHarjoittelu" type="virta:LaajuusTyyppi" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suorituksen sisältyvän tutkimus ja kehittämistoiminnan osana tehdyn harjoittelun laajuus (TKI).
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 <xs:element name="TKILaajuusMuu" type="virta:LaajuusTyyppi" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suoritukseen sisältyvien muiden opintojen tutkimus ja kehittämistoiminnan laajuus (TKI).
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 <!-- TODO: Pois
 <xs:element name="Korotettu" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suoritus on korotettu toisella suorituksella. Kyllä/Ei -kytkin (Boolean).
 
 Voidaan ilmoittaa myös korotuksen tehneen suorituksen yksilöivä ID.
 </xs:documentation>
 </xs:annotation>
 <xs:complexType>
 <xs:simpleContent>
 <xs:extension base="virta:KyllaEiKytkinTyyppi">
 <xs:attribute name="korottavaID" type="virta:OpintosuoritusYksiloivaIDTyyppi" use="optional">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suoritus on korotettu toisella suorituksella, jonka yksilöivä ID.
 </xs:documentation>
 </xs:annotation>
 </xs:attribute>
 </xs:extension>
 </xs:simpleContent>
 </xs:complexType>
 </xs:element>
 -->
 <xs:element name="Opinnaytetyo" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suoritus on tehty opinnäytetyönä. Kyllä/Ei -kytkin (Boolean).
 
 Lisäksi voidaan ilmoittaa onko opinnäyte hankkeistettu.
 </xs:documentation>
 </xs:annotation>
 <xs:complexType>
 <xs:simpleContent>
 <xs:extension base="virta:KyllaEiKytkinTyyppi">
 <xs:attribute name="hankkeistettu" type="virta:KyllaEiKytkinTyyppi" use="optional">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Opinnäytetyö on hankkeistettu. Kyllä/Ei -kytekin (Boolean).
 </xs:documentation>
 </xs:annotation>
 </xs:attribute>
 </xs:extension>
 </xs:simpleContent>
 </xs:complexType>
 </xs:element>
 <xs:element name="Patevyys" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Pätevyys (koodisto).
 </xs:documentation>
 </xs:annotation>
 <xs:complexType>
 <xs:sequence>
 <xs:element name="Koodi" type="virta:PatevyysKoodiTyyppi" minOccurs="1" maxOccurs="1"/>
 </xs:sequence>
 </xs:complexType>
 </xs:element>
 <xs:element name="AvoinOpinto" type="virta:KyllaEiKytkinTyyppi" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suoritus on... tehty avoimen korkeakoulun opintona.
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 <xs:element name="KansainvalinenVaihto" type="virta:KyllaEiKytkinTyyppi" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suoritus on... kansainvälisen vaihto-opiskelun suoritus.
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 <xs:element name="Yhteistyosopimus" type="virta:KyllaEiKytkinTyyppi" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suoritus on... korkeakoulujen yhteistyösopimuksen mukainen.
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 <xs:element name="ErillisOikeus" type="virta:KyllaEiKytkinTyyppi" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suoritus on... tehty erillisellä opiskeluoikeudella.
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 <xs:element name="ErillisOpettajaOikeus" type="virta:KyllaEiKytkinTyyppi" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suoritus on... tehty erillisellä opettajankoulutuksen opiskeluoikeudella.
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 <xs:element name="ValmentavaMaahanmuuttaja" type="virta:KyllaEiKytkinTyyppi" minOccurs="0" maxOccurs="1">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suoritus on... tehty valmentavassa maahanmuuttajakoulutuksessa.
 </xs:documentation>
 </xs:annotation>
 </xs:element>
 </xs:sequence>
 <xs:attribute name="yksiloivaID" type="virta:OpintosuoritusYksiloivaIDTyyppi" use="required">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suorituksen yksilöivä ID. Pakollinen.
 Synonyymejä: "sekvenssi", "surrogaatti".
 
 Suorituksilla, tutkinnoilla, opiskeluoikeuksilla ja henkilöillä on yksilöivä id,
 jolla tarkoitetaan koneellisen aukottoman tunnistamisen mahdollisuutta.
 Tälläaista 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="opiskelijaID" type="virta:OpiskelijaYksiloivaIDTyyppi" use="required">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suorituksen tehneen opiskelijan (henkilön) ID. Pakollinen.
 </xs:documentation>
 </xs:annotation>
 </xs:attribute>
 <xs:attribute name="koulutusmoduuliID" type="virta:KoulutusmoduuliIDTyyppi" use="required">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Koulutusmoduulin ID. 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="opiskeluoikeusID" type="virta:OpiskeluoikeusYksiloivaIDTyyppi" use="optional">
 <xs:annotation>
 <xs:documentation xml:lang="fi">
 Suoritukseen liittyvän opiskeluoikeuden ID. Valinnainen, mutta pakollinen tutkinnoilla.
 </xs:documentation>
 </xs:annotation>
 </xs:attribute>
</xs:complexType>

</xs:schema>