Tiedonsiirtosanomat
Yleistä tiedonsiirtosanomista
– Käytettävä XML-sanomien encoding on ”UTF-8”. Poikkeuksista maininnat sanomakohtaisesti.
– Sanomakuvaukset ja koodistot excel-muodossa (Päivitetty 29.11.2018). Uusia sanomia päivitetään exceliin myöhemmin.
Metsävara- ja erityispiirretiedot
Metsävaratiedot
Metsävaratietoja tässä yhteydessä ovat: kuviot (jotka voidaan ryhmitellä kiinteistöittäin ja palstoittain), kuvion perustiedot, kuvion paikkatieto, kuvion puustotiedot (ositekohtaiset tiedot, kuollut puusto, yhteenveto, runkolukusarja, runkolukusarjaositteet), kuvion toimenpiteet (hakkuut ja metsänhoitotyöt sekä toteutetut että suunnitellut), kuvion vaihtoehtoiset toimenpideketjut (hakkuu- ja metsänhoitotyöketjut) ja kuvion erityispiirteet.
Sanomien versiotaulukossa Metsävaratieto-sanomaversioiden kirjaintunniste on MV.
Erityispiirretiedot
Erityispiirretietoja tässä yhteydessä ovat: luokitellut pistemäiset, viivamaiset ja aluemaiset erityispiirteet. Erityispiirreluokittelu on laaja kattaen mm. eläimistön, kasviston ja sienestön sekä lukuisia kohdeluokkia toiminnanohjaukseen, puukauppaan, kaavoitukseen tai muihin vastaaviin liittyen.
Sanomien versiotaulukossa Erityispiirre-sanomaversioiden kirjaintunniste on EP.
Metsäkeskussanomat
Metsäkeskussanomien metsätietostandardiin liittyvät tekniset ohjeet on koottu tälle sivulle. Sanomakohtaisiin ohjeisiin pääset Metsätietostandardisanomien versiotaulukon Yksityiskohtaiset tiedot -sarakkeen linkistä kunkin sanoman riviltä.
Metsäkeskus ohjeistaa omilla sivuillaan tarkemmin mm. tiedonsiirtoon liittyvistä seikoista. Tästä linkistä pääset lukemaan Metsäkeskuksen tuottamaa tähän liittyvää materiaalia.
Sanomien kirjoittamisessa, lukemisessa ja tulkinnassa kannattaa kiinnittää erityistä huomiota seuraaviin ohjeisiin ja esimerkkisanomiin ja sisältöihin:
- Metsäkeskussanomien paikkatietojen soveltamisohjeet (päivitetty 25.4.2017)
- Juurielementin sisältöön löytyvät esimerkit kunkin sanoman Yksityiskohtaiset tiedot -sarakkeesta
- Esimerkkisanomat
- XML-sanoman encoding = ”UTF-8” tai ”ISO-8859-1”. Näistä suositeltavampi on ”UTF-8”.
- Metsäkeskus yhdistää metsäkeskussanomissa liikkuvat toimijatiedot oman asiakasrekisterinsä tietoihin. Asiakasrekisterin tiedot perustuvat väestörekisterikeskuksen tietoihin.
Jotta tietojen liittäminen voidaan tehdä nopeasti ilman manuaalisia välivaiheita, on ensiarvoisen tärkeää, että toimijatietoihin liitetään aina kun mahdollista henkilöiden tapauksessa henkilötunnus ja organisaatioiden tapauksessa yritys- ja yhteisötunnus (y-tunnus). Mikäli tämä ei olisi jostain syystä mahdollista tulisi henkilötoimijan tapauksessa etu- ja sukunimi eritellä erikseen niille tarkoitettuihin tietokenttiin (FirstName ja LastName). Nimen esittämistä yhdessä kentässä (WholeName) ei suositella, koska tämä johtaa monessa tapauksessa manuaaliseen selvittelyyn. Edellä mainittuja suosituksia noudattamalla Metsäkeskus pystyy takaamaan tehokkaamman ja nopeamman tietojen käsittelyn, näin asioiden käsittely tulee hoidetuksi osapuolten näkökulmasta tehokkaasti.
Metsäkeskussanomia ovat:
Metsänkäyttöilmoitus
Sanoma sähköiseen metsien käytön ilmoittamiseen. Sanoma löytyy versiotaulukosta versiotunnisteella MKI.
Kemera-sanomat
Sanomat on tarkoitettu sähköiseen asiointiin rahoitushakemusten osalta. Sanomat eivät kata kaikkia rahoitushakemustyyppejä eli vain osa hakemuksista voidaan hoitaa näillä sanomilla. Kemera-sanomia ovat:
- Kemera-hakemus. Versiotunniste sanomien versiotaulukossa KMRHA. Hakemus tehdään ennen toimenpiteen aloittamista.
- Kemera-toteutusilmoitus. Versiotunniste sanomien versiotaulukossa KMRTI. Toteutusilmoitus tehdään hakemuksen mukaisten töiden toteuttamisen jälkeen.
- Kemera-päätös. Versiotunniste sanomien versiotaulukossa KMRPS. Kemera-hakemuksiin ja toteutusilmoituksiin liittyvät päätökset.
- Kemera-maksatussanoma. Versiotunniste sanomien versiotaulukossa KMRMA. Kemera-tukien maksuun liittyvät tiedot.
Tarkastustiedot
Sanoma Metsäkeskuksen suorittamien tarkastusten yhteydessä kerättyjen tietojen siirtämiseen. Sanoma löytyy versiotaulukosta versiotunnisteella MKTT.
Hirvivahinkoilmoitus
Sanoma sähköiseen hirvivahingon ilmoittamiseen. Sanoma löytyy versiotaulukosta versiotunnisteella HVI.
Omavalvontatiedot
Sanoma sähköiseen omavalvontatiedon siirtämiseen Metsäkeskukselle. Sanoma löytyy versiotaulukosta versiotunnisteella MKOVT.
Metsävaratietojen päivityspyyntö
Sanoma sähköiseen asiointiin metsävaratietojen päivitystilanteissa. Sanomalla esitetään Metsäkeskukselle päivityspyyntöjä määriteltyä aluetta koskien (hakkuu tai metsänhoito toteutettu, puustotiedot mitattu tms). Tiedot päivitetään Metsäkeskuksen periaatteiden mukaisesti. Sanoma löytyy versiotaulukosta versiotunnisteella MKMVTP.
Metsäkeskussanomien palauteviesti
Sanoma toimii tiedonsiirtojen teknisen kuittauksen sanomana. Sanoma sisältää tiedonsiirron tiedot ja mahdolliset virheviestit. Sanoma löytyy versiotaulukosta versiotunnisteella MKP.
Puukauppa ja metsänhoito
Puukaupan ja metsänhoidon -sanomakokonaisuus mahdollistaa puukaupan ja metsänhoitopalveluiden kaupankäynnin tarjousprosesseineen. Kokonaisuuden tietosisällöt kattavat mm. seuraavat aiheet: toimenpide / metsävarakuviot tietoineen (vrt. metsävaratietojen sanoma), tarjouspyynnön, tarjouksen, sopimuksen, mittaustodistuksen ja maksuerien tiedot.
Muutosesitykset / tulevat muutokset
Muutosesitykset 4/2016 – 9/2019. Päivitetty 9.9.2019.
Tästä linkistä on ladattavissa pdf-muodossa vanhemmat puukauppatietostandardiin esitetytyt muutokset. Päivitetty 27.9.2013.
Puukaupan ja metsänhoidon sanomat
Sanomat löytyvät sivuston versiotaulukosta sanomaryhmästä ”Puukauppa ja metsänhoito”.
Puunkorjuun ja metsänhoidon toiminnanohjauksen standardit (WoodForce)
Tässä osiossa julkaistaan korjuun yleisen sovelluspalvelun sanomaluonnokset. Tässä osiossa toistaiseksi vain työversioita.
Sanomakuvaukset 22.12.2014
Sanomakuvaukset (45 kpl excel-tiedostoja).
Koodistot 22.12.2014
Koodistot (2 kpl excel-tiedostoja). Mukana on kaksi versiota: 1) toisessa edelliseen versioon tehdyt muutokset näkyvissä ja 2) toinen ns. ’clean –versio’ josta muutosmerkinnät poistettu.
Sanomien elementtien nimien käännösehdotuksia
Käännösehdotukset (zip, 6 kpl excel-tiedostoja) (Lisätty 31.7.2014).