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-skeema
LukukausiIlmoittautumiset.xsd 
<?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>
  • No labels

4 Comments

  1. Unknown User (jrautama@oulu.fi)

    Yliopistoissa 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)

    1. Lauri Jokipii

      Kiitos 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.

      1. Unknown User (eiairio@helsinki.fi)

        Jos "opiskeluoikeusID" jätetään ilmoittamatta, mihin ilmoittautumisen sitten katsotaan kohdistuvan? Onko mahdollista yhdistää ilmoittautumiseen opiskeluoikeuden sijaan korkeakoulun id?

        1. Lauri Jokipii

          Kiitos 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).