Arvosana-asteikko - Muu

Tiedonsiirtojen toteutuksen yhteydessä huomattua

Asia: Mitä tietoja Muu-arvosana-asteikossa on.

Muu-arvosana-asteikko pyrkii vastaamaan korkeakoulujen tietovarannossa käytetyissä tiedonsiirroissa (XML-rakenne) korkeakoulujen tietomallin (xdw-malli) rakennetta arvosanasta ja arvosana-asteikosta mahdollisimman tarkasti. Eroa on kuitenkin syntynyt erityisesti nimennän suhteen siitä syystä, että relaatiotietokanta ja sen nimentä vain on vähän erilaista verrattuna XML-kielen nimentään. Tästä asiasta on nähtävissä lisää XML-rakennemuutoksia-sivulla, joka asia oli 28.1.2013 ohjausryhmän päätettävänä. Linkkirikki

Seuraavassa ko. rakenteiden vastaavuudet:

Tietomalli nimiXML nimi asteikkona ("kaikille suorituksille")XML nimi yksittäisessä suorituksessaHuom
Arvosana.AvainMuu.Asteikko.AsteikkoArvosana.avainMuu.Koodi
Arvosana.KoodiMuu.Asteikko.AsteikkoArvosana.Koodi

Arvosana.Laskennallinen_arvoMuu.Asteikko.AsteikkoArvosana.LaskennallinenArvo

Arvosana_asteikko.AvainMuu.Asteikko.avain

Arvosana_asteikko.Koodi

Asteikon koodiarvoa ei XML-tiedoissa ole.
Arvosana_asteikko.NimiMuu.Asteikko.Nimi

XML-rakenne Muu-arvosana-asteikolle on:
<Opintosuoritus...>
  ...
  <Arvosana>
    <Muu>
      <Asteikko avain="muu_asteikko_avain">
        <Nimi>Asteikon nimi</Nimi>
        <AsteikkoArvosana avain="asteikkoarvosana_avain1">
          <Koodi>Asteikon arvosana 1</Koodi>
          <Nimi>Asteikon arvosanan 1 nimi</Nimi>
          <LaskennallinenArvo>Asteikon arvosanan 1 laskennallinen arvo</LaskennallinenArvo>
        </AsteikkoArvosana>
        <AsteikkoArvosana...>
        </AsteikkoArvosana>
      </Asteikko>
      <Koodi>Ko. suorituksen arvosanan *avain*</Koodi>
    </Muu>
  </Arvosana>
  ...
</Opintosuoritus>

Merkittävää yllä on, että XML-elementtiin Opintosuoritus.Arvosana.Muu.Koodi tuodaan itse asiassa avain-tieto eikä koodiarvoa. Tällä varmistetaan, ettei asteikoissa mahdollisesti kahteen kertaan olevat koodiarvot pääse sotkemaan toisiaan.

Avain-tietohan on tarkoitus olla lähdejärjestelmässä oleva yksilöivä tieto. Esim. tietokannan taulun pääavaimen arvo (surrogaatti).

Ohjeistusta muu arvosana -asteikon tuonnista

Muu-arvosana-asteikkojen arvosanat tulee tuoda siten, että asteikko on jokaisessa suorituksessa kokonaisena, jotta arvosanat voidaan näyttää oikein rajapinnassa ja esim. Oma opintopolku -palvelussa. Jokainen opintosuoritus on "oma dokumenttinsa". Periaattena siis on että korkeakoulujen lähettämät tiedot (XML) menevät sellaisenaan rajapintaan opiskelijakohtaisesti pilkottuina 

Huom! Ohjeistusta on päivitetty VIRTA-opintotietopalvelun käytön jälkeen, sillä jossain vaiheessa oli sallittua tuoda asteikko vain kerran tiedonsiirron yhteydessä. Tämä toimintatapa ei kuitenkaan ole toimiva ratkaisu, kun Virran tietoja käytetään rajapinnan kautta ja tästä syystä ohjeistusta on päivittty. Keskustelua asiasta on käyty mm. yhteyshenkilökokouksessa 13.3.2018.