LukukausiIlmoittautumiset tiedonsiirtoskeema. XML-skeema, jonka avulla on tarkoitus siirtää useita lukukausi-ilmoittautumisten tietoja kerralla. Skeeman voi myös lukea sisään muihin skeemoihin jolloin myös yksittäisiä tietoja voidaan antaa.
Versio 1.06.3 Skeema GitHubissa https://github.com/CSCfi/VIRTA-Opintotietopalvelu/blob/master/XML-skeemat/LukukausiIlmoittautumiset.xsd
Kaaviokuva

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema version="1.06.3"
attributeFormDefault="unqualified"
elementFormDefault="qualified"
targetNamespace="urn:mace:funet.fi:virta/2015/09/01"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:virta="urn:mace:funet.fi:virta/2015/09/01">
<xs:include schemaLocation="tyypit.xsd">
<xs:annotation>
<xs:documentation xml:lang="fi">
Tiedonsiirtoelementtien tyypit.
</xs:documentation>
</xs:annotation>
</xs:include>
<!-- LUKUKAUSI-ILMOITTAUTUMISTEN 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="LukukausiIlmoittautumiset" type="virta:LukukausiIlmoittautumisetTyyppi"/>
<!-- Tyyppinä ilman organisaatio- ja lang-attribuutteja, jos skeemaa käytetään sisäkkäisesti toisesta skeemasta -->
<xs:complexType name="LukukausiIlmoittautumisetTyyppi">
<xs:annotation>
<xs:documentation xml:lang="fi">
Lukukausi-ilmoittautumiset
* Juurielementti useille lukukausi-ilmoittautumisille
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="LukukausiIlmoittautuminen" type="virta:LukukausiIlmoittautuminenTyyppi" minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="LukukausiIlmoittautuminenTyyppi">
<xs:annotation>
<xs:documentation xml:lang="fi">
Ilmoittautuminen
* Yksittäinen ilmoittautuminen
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Myontaja" type="virta:OrganisaatioKoodiTyyppi" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="fi">
Lukukausi-ilmoittautumisen kohteena oleva organisaatio (oppilaitos). Pakollinen.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Tila" type="virta:LukukausiIlmoittautuminenTilaKoodiTyyppi" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="fi">
Ilmoittautumisen tila (koodisto).
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="IlmoittautumisPvm" type="virta:PvmTyyppi" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="fi">
Ilmoittautumispäivämäärä.
</xs:documentation>
</xs:annotation>
</xs:element>
<!-- nämä alku- ja loppupvm -elementit voisi lukea mukaan myös extensionina, mutta järjestys... -->
<xs:element name="AlkuPvm" type="virta:PvmTyyppi" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="fi">
Alkamispäivämäärä.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="LoppuPvm" type="virta:PvmTyyppi" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="fi">
Päättymispäivämäärä.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="YlioppilaskuntaJasen" type="virta:KyllaEiKytkinTyyppi" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="fi">
Ylioppilaskunnan jäsen.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="YTHSMaksu" type="virta:KyllaEiKytkinTyyppi" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="fi">
YTHS-maksu.
</xs:documentation>
</xs:annotation>
</xs:element>
<!-- Lukuvuosimaksu tieto -->
<xs:element name="LukuvuosiMaksu" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="fi">LukuvuosiMaksu.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Maksettu" type="virta:LukuvuosiMaksuTilaKoodiTyyppi" minOccurs="1" maxOccurs="1"/>
<xs:element name="Summa" type="virta:RahaMaaraTyyppi" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="fi">
Maksetettu itse summa
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Apuraha" type="virta:RahaMaaraTyyppi" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="fi">
Apurahan summa
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:attribute name="opiskeluoikeusAvain" type="virta:AvainTyyppi" use="optional">
<xs:annotation>
<xs:documentation xml:lang="fi">
Lukuvuosimaksun liittyvä opiskeluoikeuden avain. Valinnainen.
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="opiskelijaAvain" type="virta:AvainTyyppi" use="required">
<xs:annotation>
<xs:documentation xml:lang="fi">
Opiskelijan (henkilön) avain. Pakollinen.
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="opiskeluoikeusAvain" type="virta:AvainTyyppi" use="optional">
<xs:annotation>
<xs:documentation xml:lang="fi">
Opiskeluoikeuden avain. Valinnainen.
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:schema>
4 Comments
Unknown User (jrautama@oulu.fi)
Sep 21, 2012Yliopistoissa ilmoittautuminen ei ole opiskeluoikeuskohtainen. Jos tuohon pitää jotain saada, niin se on sitten ensisjainen opinto-oikeus, joka sekin tosin voi muuttua lukukauden aikana.
Alkupvm ja lopupvm ovat ilmeisesti lukukauden alku ja loppupäiviä.
Tila taitaa olla taas uusi käsite läsnä-/poissaololle)
Lauri Jokipii
Sep 21, 2012Kiitos kommenteista!
Kyseessä on tässä vaiheessa vielä luonnos tiedonsiirtoskeemasta, joten esim. dokumentaatiota puuttuu reilusti. Esim. juuri selitys, että AlkuPvm on sama kuin "Ilmoittautumisen tuloksen alkamispäivämäärä" (tietosisältö ID65) ja korkeakoulujen tietomallin (xdw-malli) käsite/tieto Läsnäoloilmoittautuminen->Aikajakso.Alkamispäivämäärä.
Ilmoittautumisen tila on sama asia kuin korkeakoulujen tietomallin Läsnäoloilmoittautuminen->Läsnäolo. Eli kyllä, siinä mielessä uusi käsite.
Tieto opiskeluoikeusID on tiedonsiirtomallissakin "optional", eli tieto voidaan ilmoittaa, mutta jättää myös ilmoittamatta. Henkilöä ei voi jättää ilmoittamatta.
Unknown User (eiairio@helsinki.fi)
Sep 28, 2012Jos "opiskeluoikeusID" jätetään ilmoittamatta, mihin ilmoittautumisen sitten katsotaan kohdistuvan? Onko mahdollista yhdistää ilmoittautumiseen opiskeluoikeuden sijaan korkeakoulun id?
Lauri Jokipii
Sep 28, 2012Kiitos kommenteista!
Yliopistojen osalta oletetaan, että lukukausi-ilmoittautumiset koskevat vain opiskelijoita, siksi opiskeluoikeusID on valinnainen. Sen sijaan ammattikorkeakouluilla lukukausi-ilmoittautumiset koskevat opiskeluoikeuksia, siksi opiskeluoikeusID on lukukausi-ilmoittautumisiin liittyen olemassa.
Korkeakoulu-tieto on toistaiseksi ajateltu pääteltävän tiedon lähettäjästä, mutta tähän voi vielä tulla muutos (oppilaitostunnus).