FCG Finnish Consulting Group Oy VERA TOIMINTAOHJEET Rev./pvm 1.03 Hyväksytty 30.4.2010 Sisältö Käyttö Vastuuhenkilö VeRan tiedonsiirtoformaatti Laboratoriot, jotka toimittavat tulokset suoraan VeRaan. Hannu Sippola
FCG Finnish Consulting Group Oy Toimintaohje I Hyväks. 30.4.2010 SISÄLLYSLUETTELO 1 YLEISTÄ... 1 2 SIIRTOTIEDOSTON RAKENNE... 2 3 SIIRTOTIEDOSTON YKSITYISKOHTAINEN RAKENNE... 3 3.1 Yleistä... 3 3.2 Rivi 1... 3 3.3 Rivi 2.... 3 3.4 Rivi 3.... 4 3.5 Rivi 4... 5 3.6 Rivi 5.... 6 3.7 Rivit 6-N... 7 4 ESIMERKKI SIIRTOTIEDOSTOSTA... 8 TEHDYT MUUTOKSET 22.3.2010 Jälkimäinen esimerkki korjattu poistamalla tarpeeton aikaleima. 29.4.2010 Otettu käyttöön kentät STARTTIMEDATA JA ENDTIMEDATA. Rivillä 5 DATA kentän ja näytteiden lukumäärän väliin lisätty erotin. Esimerkki ENDTIMEDATA kentän käytöstä lisätty.
FCG Finnish Consulting Group Oy Toimintaohje 1 (8) 1 YLEISTÄ a) Siirrettävät tiedot kirjoitetaan tekstitiedostoon, jonka tyyppi on vtf (siirtotiedosto). Tiedoston nimi on vapaa, eikä VeRa käytä sitä mihinkään. Nimessä ei suositella käytettävän pisteitä. Tiedoston nimessä suositellaan tunnistetta, joka kertoo tiedon tuottajan ja tiedon lähteen. b) Tiedoston nimen tarkoitus on helpottaa siirtotiedoston etsimistä häiriötilanteissa, siksi nimeen on hyvä lisätä aikaleima. c) Jokaisen siirtotiedoston nimen tulee olla yksilöllinen ja se sisältää vain jäljempänä määritellyt tiedot. d) Jokaiselle VeRa päiväkirjalle on oma hakemistonsa siirtotiedostoja varten, johon siirtotiedostot (vtf-tiedostot) siirretään. e) Kaikkia siirrettäviä tietoja ei tarvitse koota samaan tiedostoon, vaan niitä voi olla useampiakin esim. kultakin näytepisteeltä omansa. f) Jos samasta näytepisteestä tai näytteenottokerrasta tulee tietoja useampaan päiväkirjapohjaan, niin kullekin päiväkirjapohjalle täytyy lähettää oma siirtotiedostonsa. g) Siirtotiedostossa saa olla mittauksia, joita kyseinen päiväkirjapohja ei käytä. Näin ollen on mahdollista kerätä kaikki näytepisteen tiedot yhteen tiedostoon ja lähettää se kaikille päiväkirjoille, jotka tarvitsevat jotain tietoa ko. näytepisteestä. On myös mahdollista tehdä kullekin päiväkirjalle oma siirtotiedosto, jossa on vain ko. päiväkirjaa kiinnostavat tiedot. h) VeRa huolehtii luettujen tiedostojen poistosta ja mahdollisesta varmuus-kopioinnista. i) Periaatteena on, että jokainen siirtotiedosto sisältää riittävän informaation sen tulkitsemiseen myös myöhemmin. j) Jokainen siirtotiedosto alkaa määrittelyosalla, joka pysyy käytännössä samana ja sitä seuraavat siirrettävien mittausten tiedot.
FCG Finnish Consulting Group Oy Toimintaohje 2 (8) 2 SIIRTOTIEDOSTON RAKENNE Tiedot ovat riveittäin tiedostossa. Jokaisen rivi loppuu merkkeihin <CR><LF> Siirtotiedoston sisältö riveittäin on seuraava: 1. Yleistunniste ja listaerotin 2. Aikaleiman määrittelyt 3. Desimaalierottimen määrittely 4. Siirrettävien tietojen tyyppimäärittelyt 5. Siirrettävä tietojen aikaleima ja lukumäärä 6. -N Siirrettävät tiedot Tiedosto jakautuu siis kahteen osaan: otsikko-osaan ja tieto-osaan, jossa ensimmäisessä määritellään siirrettävät tiedot ja niiden esitystapa sekä aikaleima. Jälkimmäisessä osassa on varsinaiset mittaustiedot.
FCG Finnish Consulting Group Oy Toimintaohje 3 (8) 3 SIIRTOTIEDOSTON YKSITYISKOHTAINEN RAKENNE 3.1 Yleistä 3.2 Rivi 1 Rivit 1-5 alkavat tunnisteella, joka kertoo mitä tietoa riviltä löytyy. Jos rivillä on useampi tieto, niin rivillä olevat tiedot erotetaan toisistaan listaerottimella (esimerkiksi puolipiste), joka määritellään tiedoston ensimmäisellä rivillä (ks. kohta Rivi 1). Rivillä kirjoitetaan tietojen tunniste ja määritellään listaerotin LABDATAFORVERA <erottimen ascii numero> tai LABDATAFORVERA <erotin> Erottimen ascii numero pitää olla välillä 0-128. Erotin erottelee rivillä olevat tiedot toisistaan, joten numeroa, kirjainta tai desimaalierotinta ei pidä valita erottimeksi. Suositeltavia erottimia esim. ovat puolipiste tai pilkku, jos sitä ei käytetä desimaalierottimena. Välilyönti (ascii numero 32) eikä kenoviiva \ (ascii numero 92) ei voi toimia erottimena, Ei myöskään <CR> tai <LF>. Välilyönnit arvojen alussa ja lopussa ohitetaan. ESIMERKKI: Erottimena puolipiste (2 tapaa) LABDATAFORVERA 59 LABDATAFORVERA ; 3.3 Rivi 2. Rivillä määritellään käytettävän aikaleiman formaatti. STAMP <Tyyppi> jossa <Tyyppi> on Aikaleiman formaatti, esimerkiksi jokin seuraavista YYYYMMDDHH (oletusarvo, jos ei ole annettu) YYMMDDHH YYYYMMDD (ilmoitustarkkuus päivän tarkkuudella) Jos tunnit, HH, puuttuvat aikaleimasta niin oletusarvona (laskuissa) on 00. Jos päivä, DD, puuttuu aikaleimasta niin oletusarvona (laskuissa) käytetään 01. ESIMERKKI: Aikaleiman formaatin määrittäminen STAMP YYYYMMDDHH
FCG Finnish Consulting Group Oy Toimintaohje 4 (8) 3.4 Rivi 3. Rivillä määritellään käytetty desimaalierotin. DECIMAL <Arvo> tai DECIMAL <Desimaalierotin> jossa <Arvo> on 0 tai 46 jos käytetään desimaalipistettä (oletusarvo) 1 tai 44 jos käytetään desimaalipilkkua <Desimaalierotin> on. (piste) tai, (pilkku) ESIMERKKI: Desimaalierottimena on piste (3 tapaa). DECIMAL 0 DECIMAL 46 DECIMAL.
FCG Finnish Consulting Group Oy Toimintaohje 5 (8) 3.5 Rivi 4 Rivillä määritellään minkä tyyppistä tietoja ollaan siirtämässä. Sen tyyppistä tietoa, jota ei ole saatavilla, ei pidä määritellä myöskään siirrettäväksi. ID <Erotin> UNIT <Erotin> <Laji1> <Erotin> <Laji2> <Erotin> <Laji3> <Erotin> <Laji4> <Erotin> <Laji5> jne. jossa <Laji> on mittauksista siirrettävien tietojen laji kuten: VALUE, QUALITY, METHOD, DELTA, SAMPLEID, START, ENDTIME, PERIOD Laji kuvaa mitä tietoja jokaisesta mittauksesta siirretään. Tarkoituksena on, että kustakin mittauksesta annetaan kaikki tällä rivillä määritellyt tiedot, joista osa voidaan tarvittaessa merkitä puuttuviksi. Lajitietojen järjestys on vapaa, mutta sitä ei voi kesken tiedoston muuttaa. VALUE QUALITY Mitattu arvo tai raja-arvo, jonka ala- tai yläpuolella tulos on Mittauksen laatu, joko voi olla: NORMAL (=) LOWER (<) GREATER (>) DOUBTFUL (w) normaali tulos tulos alle mittausrajan tulos yli mittausrajan tulokseen tulee suhtautua varauksella Suluissa olevaa merkkiä voi käyttää sitä edeltävän sanan sijasta. METHOD DELTA Käytetty analysointimenetelmä esim. SFS-EN ISO XXXX tai mittalaitteen malli ja tunnistetiedot. Myös vesihallinnon määrittelemää analysointimenetelmän koodia voi halutessaan käyttää. Mittaustarkkuus, joko absoluuttisena tai prosentteina, jolloin luvun perässä on % merkki. SAMPLEID Näytteen tai näytepullon tunniste tms. START Näytteenoton aloitusaika rivillä 2 määritetyssä formaatissa. ENDTIME Näytteenoton lopetusaika rivillä 2 määritetyssä formaatissa. PERIOD Mittauksen keräysaika tunteina: Kertanäytteille nolla, vuorokausinäytteille 24. Näytteen keräysajasta tarvitaan joko aloitus (START) ja lopetusaika (ENDTIME) tai toinen näistä ja näytteenoton kesto (PERIOD) ellei rivillä 5 ole annettu yhteistä aloitusajankohtaa, jolloin PERIOD kenttä on pakollinen. ESIMERKKI: Siirrettävien tietojen tyyppien määrittelyjä ID, UNIT, START, ENDTIME, VALUE ID, UNIT, VALUE, START, PERIOD, METHOD, QUALITY, DELTA HUOM. Neljä ensimmäistä riviä pysyy normaalisti samana joka tiedostossa.
FCG Finnish Consulting Group Oy Toimintaohje 6 (8) 3.6 Rivi 5. Rivillä annetaan siirrettävien tietojen lukumäärä. DATA <Erotin> <siirrettävien mittausten lkm> tai STARTTIMEDATA <aikaleima> <Erotin> <siirrettävien mittausten lkm>, ENDTIMEDATA <aikaleima> <Erotin> <siirrettävien mittausten lkm>, missä aikaleima on rivillä 2 määritellystä muodossa. Jälkimmäinen tapa antaa tiedostossa ilmoitettaville mittauksille yhteisen aloitus/lopetusajankohdan, jolloin rivillä 4 ei tarvitse määritellä START ja ENDTIME kenttiä. Jos em. kentistä toinen tai molemmat on määritelty, määräävät ne kyseisen mittauksen ajankohdan, jos niille on kyseiseen mittauksen kohdalla annettu arvo. Jos arvoa ei ole käytetään STARTTIMEDATA tai ENDTIMEDATA kentässä annettua yleistä aikaleimaa. PERIOD kentän käyttö on START/ENDTIMEDATA tapauksessa pakollista, sillä sen avulla erotetaan kerta- ja kokoomanäytteet toisistaan. Mittausten lukumäärän sijasta voidaan kirjoittaa myös LIST. ESIMERKKI: Mittausten lukumäärän ilmoittaminen (2 tapaa) DATA, 5 ENDTIMEDATA 2009081307, LIST
FCG Finnish Consulting Group Oy Toimintaohje 7 (8) 3.7 Rivit 6-N Riviltä 6 alkaen annetaan siirrettävät tiedot yksi mittaus per rivi. Rivien keskinäisellä järjestyksellä ei ole merkitystä. <ID> <Erotin> <Laatu> <Erotin> <Tieto1> <Erotin> <Tieto2> jne. jossa <ID> on Mittauksen yksikäsitteinen tunniste. <Laatu> on Mittauksen laatu <Tieto> on Mittaustieto ID on mittauksen tunniste, jonka avulla VeRa tunnistaa mittauksen ja sen rakenne on seuraava: <Kohde>\<Näytepiste>\<Analyysi> Merkkijonon alussa ja lopussa olevat välilyönnit poistetaan eikä niitä sisällytetä ID:hen. ID maksimipituus on 128 merkkiä. Välilyönnin käyttöä ID sisällä tulee välttää ja korvata se alaviivalla. Esimerkki ID:stä: Turun_Jvp\pH\Lähtevä_vesi. Laatu kertoo mittauksen laadun. Laaduttoman mittauksen laatuna on joko tyhjä tila erottimien välissä tai #NULL#. Mittaustiedot annetaan rivillä 4 määritellyssä järjestyksessä. Mikäli siirrettävien tietojen lukumäärän sijasta on annettu LIST, tulee siirrettävien tietojen loppuun omalle rivilleen kirjoittaa ENDLIST. Puuttuva arvo ilmaistaan joko välilyönnillä eli tyhjällä tila erottimien välillä tai kirjoittamalla FAIL tai #NULL#. Tiedon puuttumisen syy voidaan ilmaista seuraavasti: välilyönti FAIL #NULL# Tieto puuttuu syystä tai toisesta, mutta voidaan mahdollisesta vielä saada. Esimerkiksi kun näyte joudutaan analysoimaan uudestaan ja/tai tuloksen laatu ei ole vielä selvä. Tietoa ei näytteenottovirheen tms. syyn tähden tällä kertaa saada. Esimerkiksi kun näytepullo rikkoutuu tai näytemäärä oli liian pieni. Tietoa ei ole lainkaan. Esimerkiksi kenttämittauksen näytetunnus (SAMPLEID). Jos jollekin mittaukselle ei saada lainkaan tulosta, niin sen voi jättää siirtotiedostosta pois. Toinen vaihtoehto on antaa #NULL#, FAIL tai välilyönti puuttuville tiedoille. ESIMERKKI: Tulevan veden kiintoaine (VALUE, START, ENDTIME, QUALITY) Kakola\Tuleva\Kiintoaine, mg/l, 690, 2009081207, 2009081307, NORMAL
FCG Finnish Consulting Group Oy Toimintaohje 8 (8) 4 ESIMERKKI SIIRTOTIEDOSTOSTA Ohessa esimerkki, jossa erottimena toimii pilkku (44). Desimaalierottimena on piste (0). Mittaustuloksen lisäksi ei siirretä mitään muuta tietoa. Mittaustietojen lukumäärä (5) löytyvät seuraavalta riviltä, jota seuraavat varsinaiset analyysitulokset. Tiedostosta toiseen vakiona pysyvät rivit (4 kpl) on tummennettu LABDATAFORVERA 44 STAMP YYYYMMDDHH DECIMAL 0 ID, UNIT, VALUE, START, ENDTIME DATA, 5 Kakola\Tuleva\Ntot, mg/l, 89, 2009081207, 2009081307 Kakola\Tuleva\Ptot, mg/l, 12.0, 2009081207, 2009081307 Kakola\Tuleva\pH, #NULL#, 7.6, 2009081207, 2009081307 Kakola\Tuleva\COD, mg/l, 760, 2009081207, 2009081307 Kakola\Tuleva\BOD, mg/l, 560, 2009081207, 2009081307 Seuraavassa esimerkissä siirrettävien tietojen lukumäärää ei ole määritelty ja puuttuvat tiedot on ilmaistu vain erottimella (pilkku), jonka perässä on tyhjää. Desimaalierotin on piste (.) Mittauksen laatu (QUALITY) on merkitty merkkitunnistetta ei sanaa käyttäen. LABDATAFORVERA, STAMP YYYYMMDDHH DECIMAL. ID, UNIT, VALUE, START, ENDTIME, METHOD, DELTA, QUALITY DATA, LIST Kakola\Tuleva\Ntot, mg/l, 57, 2009081207, 2009081307, SFS 5055, 5%,= Kakola\Tuleva\Ptot, mg/l, 9.8, 2009081207, 2009081307, SFS-EN 1189, 5%,= Kakola\Tuleva\1/2_laskeuma, ml/l, 890, 2009081207, 2009081307,,10,= ENDLIST Seuraavassa esimerkissä mittauksilla on yhteinen lopetusajankohta, siirrettävien tietojen lukumäärä on 5 ja puuttuvat tiedot on ilmaistu vain erottimella (pilkku), jonka perässä on tyhjää. Desimaalierotin on piste (.). Huom. ph on kertanäyte. LABDATAFORVERA 44 STAMP YYYYMMDDHH DECIMAL 0 ID, UNIT, VALUE, PERIOD ENDTIMEDATA 2009081307, 5 Kakola\Tuleva\Ntot, mg/l, 89, 24 Kakola\Tuleva\Ptot, mg/l, 12.0, 24 Kakola\Tuleva\pH,, 7.6, 0 Kakola\Tuleva\COD, mg/l, 760, 24 Kakola\Tuleva\BOD, mg/l, 560, 24 FCG Finnish Consulting Group Oy