Perustuu tietovarannon tietosisällöstä tehtyyn rajausluonnokseen, Korkeakoulujen tietomallin (xdw-malli) perusteella tehtyyn tietomalliluonnokseen sekä näihin perustuvaan koodistoluonnokseen, jotka saatavilla sivulla Tietovarannon tiedot.

Yleistä tiedonsiirrosta

Nämä tiedonsiirtomääritykset koskevat tietojen siirtämistä korkeakoulusta tietovarantoon. Tietojen lukemiseksi on erikseen web services-tyyppinen rajapinta, joka palauttaa tiedon järjestettynä CEN\SFS-standardin EUROLMAI-mukaan viranomaiskäyttöön tai korkeakoululle siirrettyjen tietojen tarkistamiseksi tai muuhun käyttöön.

Ohjausryhmän päätöksen 25/25.5.2012 perusteella tuetaan vain oletustiedonsiirtotapaa, mikä perustuu eräsiirtoon korkeakoulusta tietovarantoon.

Tietovarannon tietosisällön päivittämisen perustapaus on, että korkeakoulu päivittää eräsiirrolla kaikki tiedot uudestaan eli kaikki aiemmin tuotu tieto poistetaan alta. Kehitteillä on tapa päivittää eräsiirrolla tietoja vain muuttuneilta osin, eli yksittäisiä tietoja lisätään, muutetaan tai poistetaan (yksilöivät id:t!). 

Tiedonsiirto korkeakoulusta tietovarantoon muodostuu xml-tyyppisestä siirtotiedostosta tai vastaavasta(, kuten json?). Koska tietovarantoon sisältyy tietoja, jotka voivat saada nollasta useaan tiettyä ominaisuutta, ei CSV-kaltaiset yksiulotteiset tiedonsiirtoformaatit ole hyviä: esimerkki hylätystä CSV-vaihtoehdosta.

Tiedonsiirtomääritykset korkeakoulusta tietovarantoon

Tiedonsiirtomääritykset XML-skeemoina (http://www.w3.org/XML/, http://www.w3.org/XML/Schema) on listattu alla (alisivuja). Jokainen skeematiedosto on alisivun liitetiedostona siten, että myös vanhemmat versiot on saatavilla. Lisäksi kustakin varsinaisesta tietorakenteita kuvaavasta skeemasta (skeeman nimi alkaa isolla kirjaimella) löytyy wikistä sekä kaavio että skeematiedosto.

XML-skeemat

• Opintosuoritukset :: Versio 1.04 :: namespace="urn:mace:funet.fi:virta/2012/11/26" :: wiki versio 23
• Opiskeluoikeudet :: Versio 1.04 :: namespace="urn:mace:funet.fi:virta/2012/11/26" :: wiki versio 19
• LukukausiIlmoittautumiset :: Versio 1.04 :: namespace="urn:mace:funet.fi:virta/2012/11/26" :: wiki versio 18
• Opiskelijat :: Versio 1.04 :: namespace="urn:mace:funet.fi:virta/2012/11/26" :: wiki versio 16
• koodistot :: Versio 1.04 :: namespace="urn:mace:funet.fi:virta/2012/11/26" :: wiki versio 13
• tyypit :: Versio 1.04 :: namespace="urn:mace:funet.fi:virta/2012/11/26" :: wiki versio 14
• Virta.xsd :: Versio 1.04 :: namespace="urn:mace:funet.fi:virta/2012/11/26" :: wiki versio 5

Päivityshistoria:

• 17.9.2012 Tuotu ensimmäiset "julkiset" versiot (opiskelijat, opiskeluoikeudet, opintosuoritukset, tyypit, koodistot). Versio 0.2
• 18.9.2012 Päivitetty mittavasti kaikkia skeemoja. Lisätty ilmoittautumiset-skeema. Versio 0.3
• 19.9.2012 Lisätty version 0.3 mukaiset kaaviokuvat XML-skeemoista
• 25.9.2012 Päivitetty skeemat ja kaaviot versioon 0.4. Muutoksia rakenteissa niin tietosisältöön liittyen kuin yleisemminkin. Lisäyksiä tietosisältöön, mm. kirjoilletulopvm. Dokumentaatiota lisätty.
• 28.9.2012 Päivitetty skeemat ja kaaviot versioon 0.5. Muutokset enimmäkseen aiempien "TODO"-kohtien läpikäyntiä ja ratkaisuja niihin. Joitakin rakenteellisia muutoksia.
• 4.10.2012 Päivitetty skeemat ja kaaviot versioon 0.6 ja 0.61. Lukuisia muutoksia asiantuntijaryhmän työpajan (2.10.2012) perusteella. Myös laajoja tietotyyppien tarkentamista ja keräämistä kahteen skeemaan (tyypit ja koodistot).
• 10.10.2012 Päivitetty skeemat ja kaaviot versioon 1.0. Versionumero on ohjausryhmän päätöksen jälkeen "virallinen julkaistu versio", mutta asiavirheitä ja tarkennuksia tehdään vielä. Erityisesti nyt alkavien Virta-projektin pilottitoteutusten aikana.
  • Puutteita/tulevaa:
    • Valtakunnallinen koulutusmoduuliID
    • id-tietotyyppien muutos ja linkittäminen toisiinsa, kun mahdollista tai suotavaa
    • Koodistojen tarkentaminen ja täydentäminen (esim. pätevyys, organisaatio)
    • Luovutaan toistaiseksi turhista <Koodi>-elementeistä, kuten Opiskeluoikeus.Tyyppi.Koodi, Opintosuoritus.Patevyys.Koodi jne.
• 11.10.2012 Päivitetty skeemat ja kaaviot versioon 1.01.
  • Muutoksia:
    • Poistettu toistaiseksi tarpeettomat <Koodi>-tagit, jotka voi helposti laajentaa myöhemmin mukaan, jos tarvetta ilmenee.
    • Opintosuoritukset-skeemaan muutettu Opinnaytetyo-elementin rakenne: Lisätty Koodi-elementti ja muutettu hankkeistettu->Hankkeistettu (attribuutista elementiksi).
    • Koodistoja tarkennettu ja täydennetty. Vielä on keskeneräisiä mm. pätevyys ja arvosana-asteikot.
  • Puutteita/tulevaa:
    • Valtakunnallinen koulutusmoduuliID
    • id-tietotyyppien muutos ja linkittäminen toisiinsa, kun mahdollista tai suotavaa
    • Koodistojen tarkentaminen ja täydentäminen: pätevyys, arvosana-asteikot
• 25.10.2012 Päivitetty skeemat ja kaaviot versioon 1.02
  • Muutoksia:
    • Lisätty valtakunnallinen koulutusmoduuli id Opiskeluoikeudet ja Opintosuoritukset -skeemoihin
    • Koodistoa tarkennettu arvosana-asteikkojen osalta. Samalla Opintosuoritukset-skeemaa päivitetty arvosanojen osalta.
    • Lisätty täysin uutena uusi skeema Virta, joka oikeastaan vain yhdistää kaikki muut skeemat.
  • Puutteita/tulevaa
    • id-tietotyyppien muutos ja linkittäminen toisiinsa, kun mahdollista tai suotavaa
    • Koodistojen tarkentaminen ja täydentäminen: pätevyys, arvosana-asteikot
• 30.10.2012
  • Puutteita/tulevaa
    • Elementtien ja attribuuttien nimeäminen uusitaan
• 5.11.2012 Päivitetty skeemat ja kaaviot versioon 1.03
  
  • Muutoksia:
    • Nimetty kattavasti elementtejä ja attribuutteja uudestaan siten, että nimet vastaavat paremmin korkeakoulujen tietomallia (xdw-malli). Selkein esimerkki tästä on kaikki elementit ja attribuutit, joissa esiintyi "id".
    • Joitakin rakenteellisia muutoksia, esim opiskeluoikeuden opiskelijaliikkuvuus (oli tarpeeton).
    • Ilmoittautumiset-skeema nimetty uudestaan nimelle LukukausiIlmoittautumiset
    • Lisätty Kansainvälistä vaihtoa -koodisto tiedonsiirtoskeemaan
  • Puutteita/tulevaa
    • Koodistojen tarkentaminen ja täydentäminen: pätevyys, arvosana-asteikot

• 26.11.2012 Päivitetty skeemat ja kaaviot versioon 1.04

  • Muutoksia:
    • koodistot.xsd
      
      • Päivitetty Pätevyys-koodistoon asiantuntijoiden ilmoittamia arvoja erityisesti Valviraan liittyen
    • tyypit.xsd
      
      • Tarkennettu henkilötunnuksen muotoa siten, että vain aidot suomalaiset hetut kelpaavat (tarkistusosan ensimmäinen merkki 0-8 (ei 9)) sekä vain syntymäaikaa ilmoittaville välimerkki (=vuosisatamerkki) on pakollinen.
      • Nimetty: OpintosuoritusLisatietoTyyppi => OpintosuoritusJulkinenLisatietoTyyppi
      • Lisätty: Opintosuorituksiin liittyen 'Muu' arvosana-asteikkoon liittyen rakenne, jolla arvosana-asteikko arvosanoineen voidaan ilmoittaa osana tiedonsiirtoa.
    • Opintosuoritukset.xsd
      
      • Nimetty uudestaan: Lisatieto -> JulkinenLisatieto
      • (lisäksi tyyppi.xsd-skeeman muutos 'Muu' arvosana-asteikkoon liittyen koskee tietysti erityisesti opintosuorituksia)
    • Virta.xsd
      
      • Muutettu: Opiskeluoikeuksien pakollisuus valinnaiseksi.
    • Muut skeemat muutettu vain vastaamaan versionumeroltaan sekä nimiavaruudeltaan.