Sähköisesti siirrettävät pohjavesien vedenlaatutiedot

Pohjavesitietojärjestelmä POVETiin voidaan tallentaa vedenlaatutietoja suurempina tietojoukkoina nk. siirtotiedostojen muodossa, Tietoja tallennetaan pääosin ELY-keskuksissa tai SYKEssä, mutta sidosryhmäorganisaatioilla jotka velvoitettuina tuottavat aineistoja SYKEn ylläpitämiin ympäristötietojärjestelmiin on myös mahdollisuus saada käyttöoikeus. Lisätietoja sidosryhmäorganisaatioiden mahdollisuudesta saada POVETin käyttöoikeuksia löydät tästä dokumentista.

Määritelmiä siirtotiedostoille

• Näytteenotolla tarkoitetaan tietyltä paikalta (Pohjavesialuetunnuksen ja havaintopaikan tunnuksen perusteella tunnistettavalta pisteeltä) tiettynä aikana (päivä + kellonaika) tietyn laitoksen toimesta suoritettua näytteenottokertaa. 
• Yhdellä näytteenottokerralla otetaan yleensä näytteitä usealta eri syvyydeltä (syvyysnäyte) tai ilman syvyys tietoa (kokoomanäyte). 
• Näytteeseen liittyy samalta syvyydeltä näytevedestä arvioitu näytteen haju tai maku sekä vaihteleva määrä laboratoriossa tehtyjä määritystuloksia. Haju- ja maku-koodit löytyvät POVETin koodiosiosta.
• Näytteenotto voi liittyä tiettyyn tai useampaan hankkeeseen (projektiin), jotka julkisen valvonnan alaisten vesitutkimuslaitosten osalta ovat useimmiten velvoitetarkkailuohjelmia.
• Määrityksestä ilmoitetaan mitä suuretta (muuttujaa) on mitattu, näytteen esikäsittelymenetelmät sekä määritysmenetelmä. Kaikki nämä kolme asiaa ilmoitetaan määrityskoodin  (koodilistan numeerinen tai merkkimuotoinen koodi) avulla. Pohjavesinäytteille sallitut määrityskoodit löytyvät POVETin koodiosiosta ja pohjavesirajapinnasta.
• Määritystulos ilmoitetaan koodilistassakerrotussa yksikössä. (HUOM! Tarkista yksiköt huolella, sillä monet pohjavesianalyysien tuloksien yksiköt saattavat olla mg/l kun niitä vastaavat järjestelmän koodilistan yksiköt ovatkin µg/l.)
• Määritystulokseen voi liittyä lipputieto, joka kertoo tuloksen tarkkuuteen ja luotettavuuteen liittyviä asioita (esim. tulos on alle määritysrajan). Lipputietojen koodit löytyvät POVETin koodiosiosta.
• Tuloksesta ilmoitetaan tarvittaessa myös epävarmuus-tieto (virhearvio, luotettavuusväli). 
• Siirtotiedostoissa voi ilmoittaa korkeustason erillisessä kentässä nimeltään Korkeustaso sekä vedenlaatutietojen että vedenkorkeustietojen osalta. Korkeusjärjestelmän ilmoittaminen on pakollista mikäli vedenkorkeustuloksia ilmoitetaan.
• POVETin koodiosion lisäksi siirtotiedostojen luomisen helpottamiseksi löytyvät keskeiset POVETin tietokantataulut pohjavesirajapinnasta (linkki oikeassa palstassa). Esimerkiksi havaintopaikan Id-numeron saa rajapinnasta selville kyselyllä (query) havaintopaikan tunnuksella tai nimellä. Jos tietokannasta löytyy useita samannimisiä paikkoja saa tulokseksi paikkaluettelon.
• Huom! Jos tekstin merkkijono esim. `paikan nimi´ on pitkä, lisää lainausmerkit ennen ja jälkeen merkkijonon: "...."

Siirtotiedostojen sisältö

Pohjaveden laatutietoja voi siirtää kahdella eri tavalla, pitkään käytössä ollut valtion ympäristöhallinnon tiedonsiirtotapa (VYH-tiedonsiirtotapa) sekä uudella XML-siirtotiedostona. Alla tarkemmat ohjeet molemmille siirtotavoille.

VYH-tiedonsiirtotapa

• Vedenlaatutiedot voidaan jakaa kolmeen eri tiedostoon tai data blockiin. Kukin näistä tunnistetaan DATA BLOCK:n  TARGET-koodin avulla (Notto, Nayte ja Tulos). Vaijhtoehtoisesti voidaan yhdistää kaikki tietueet samaan tiedostoon.
• Näytteenotot ja näytteet numeroidaan juoksevalla numerolla ( ei tarvitse alkaa aina ykkösestä), jotta osien sisältämät tiedot saadaan liitetyksi toisiinsa ilman tietojen toistoa. 
• Muutkin tiedostorakenteet ovat mahdollisia, kunhan samat tiedot löytyvät ja tiedot saadaan sidotuksi toisiinsa. 
• Paikka tunnistetaan ensisijaisesti pohjavesialuetunnuksella ja havaintopaikan tunnuksen perusteella. `Pohjavesialueen tunnus´, `Paikan tunnus´ ja `Paikan nimi´- tietueet voidaan korvata (poistetaan rivit) paikan ID numerolla (Tunniste= Paikka_Id).  Mikäli havaintopaikka ei sijaitse luokitellulla pohjavesialueella, voidaan siirtotiedostossa jättää pohjavesialuesarake tyhjäksi jolloin paikan tunnus 'HpTunnus'  TAI 'Paikka_Id' on pakollinen POVETiin identifioiva tieto(*). Pohjavesialueen tunnus, paikan tunnus ja nimi sekä paikan ID-numero löytyvät POVETin koodiosiosta ja pohjavesirajapinnasta.
• Hankekoodilla ilmoitettavat velvoitetarkkailuohjelmien tunnukset löytyvät POVETin koodiosion lisäksi myös siirtosovelluksesta, jossa olemassa olevia hankkeita voi lisätä tai perustaa uusia hankkeita.
• Määrityksistä käytetään tunnuksena joko numeerista koodia tai kolmesta osasta koostuvaa merkkimuotoista koodia (esim. FE;D11;SP). Tutkimuslaitoksen on valittava kumpaa tunnusta käyttää, sillä niitä ei voi sekottaa samoihin tiedostoihin. 
• Kaikki koodilistat löytyvät Hertta-järjestelmästä Pohjavedet-valikon takana olevasta Koodit-valikosta. Herttaan pääsee vapaasti selaamaan koodilistoja ja havaintopaikkojen tunnuksia rekisteröitymällä SYKEn kaikille avoimeen Avoin tieto -palveluun sivulta Avoimet ympäristötietojärjestelmät . Avoin tieto -palvelun lyhytosoite on www.syke.fi/avointieto.

Tietotyyppien selitykset:
i = kokonaisluku,
r = desimaaliluku 
c = merkkimuotoinen (tekstiä)

Esimerkkejä  kuvaus- ja datatiedostoista:

Yksi data-tiedosto, jossa tiedostot eri DATA BLOCKeista yhdistetty yhteen dat-tiedostoon.
Kuvaustiedosto:
povetkolaatuyhd.vyh (tekstitiedosto)

Koostettu datatiedosto
Kooste.dat (tekstitiedosto)

Erilliset datatiedostot
Kuvaustiedosto:
povetlaatu.vyh (tekstitiedosto)

Erilliset notto, nayte ja tulos dat-tiedostot
ponotto.dat (tekstitiedosto)
ponayte.dat(tekstitiedosto)
potulos.dat (tekstitiedosto)

XML-tiedonsiirrot

Kuvaus siirtotiedostoscheman sisällöstä: Vedenlaatu siirtoscheman kuvaus

Ohjeet XML siirtoscheman luomiseen: XML-siirtoschemat (Zip-paketti)

Esimerkki XML-tiedosto: Pohjavedenlaadun XML (tekstitiedosto)

Lisätietoja

Ensisijainen yhteystaho: POVETtuki.syke[at]syke.fi

Kehitysinsinööri Jorma Sipilä,
Suomen ympäristökeskus,
Tietokeskus, ICT / Tietojärjestelmäryhmä,
Sähköpostiosoite: etunimi.sukunimi@ymparisto.fi