KuntaGML tiedonsiirto
KuntaGML Import – toiminnolla sisään luettavan aineiston muoto tulee olla KuntaGML – formaatin mukaista. Tuetut KuntaGML -schema versiot ovat:
Kantakartta: 2.0.0
Asemakaava: 2.0.0
Opaskartta: 2.0.0
Palvelut: 2.0.0
Verkkotopologia: 2.0.0
Osoitteet: 2.0.0
KuntaGML Export – toiminnolla kirjoitetaan edellä mainittua formaatteja.
Huomattavaa, on että Osoitteiden sisäänluvussa on oma toiminnallisuutensa suoraan tietokantaan kirjoittamiseen.
KuntaGML Import -käyttö
Ennen sisäänlukua avataan OpenCities Map Ultimate for Finland -ohjelmisto ja luodaan tai avataan tyhjä kuvatiedosto, jonne halutaan kirjoittaa kohteet KuntaGML-tiedostosta. Kuvatiedostossa tulee olla OpenCities Map Ultimate for Finland -mittakaavamääritys. Kohteiden koko määräytyy kuvatiedoston mittakaavan sekä OpenCities Map Ultimate for Finland - kohdemääritysten mukaisesti.
KuntaGML tiedoston sisäänluvun lomake avautuu työkaluryhmästä Tiedonsiirto > Luku/kirjoitus > KuntaGML Import.
| Vastaavuustiedosto | Toiminnon asetustiedosto |
| GML-tiedosto | Valitse Selaa.. - painike ja navigoi avautuvalla lomakkeella *.gml tai *.xml – tiedosto. Huomaa muuttaa tarvittaessa tiedostotyyppiä lomakkeelta |
| Välilehti |
Valitse välilehti, jonka mukaisia kohteita KuntaGML – siirtotiedosto pitää sisällään. |
| Kohteiden suodatus |
Valitse valinta kohteelle, jotka haluat lukea. Jos haluat lukea kaikkia kohteita, valitse pääkohteeseen valinta, tällöin sen alta kaikki kohteet saavat valintamäärityksen. Huomaa, että lomake näyttää kohteet, joille vastaavuus on määritetty vastaavuustiedostoon, se ei siis näytä kohteita, joita KuntaGML – siirtotiedosto pitää sisällään. |
| Luo lokitiedosto |
Valitse valinta kohtaan Luo lokitiedosto, mikäli haluat siirrosta luotavan lokitiedoston, Vastaavalla rivillä olevalla Selaa.. – painikkeella voit määrittää lokitiedostolle polun ja nimen. Jos valinta on päällä ennen GML-tiedoston valintaa tulee lokitiedoston polku ja nimi (pääte log) vastaaviksi kuin itse GML-tiedostolla |
| Tuo korkeus | Valitse valinta kohtaan Tuo korkeus, mikäli haluat lukea kohteille korkeuden KuntaGML – siirtotiedostosta |
| Vastaavuudet |
Valitse Vastaavuudet - painike, jos haluat muokata siirron vastaavuustiedostoa. Katso lisätietoa kohdasta KuntaGML Vastaavuustiedosto Huomaa, että vastaavuustiedosto vaihtuu sen mukaan mikä Valintalehti on aktiivisena. |
| Aloita | Valitse Aloita – painike, kun haluat käynnistää tiedonsiirron valituilla määrityksillä. |
KuntaGML Export -käyttö
Ennen uloskirjoitusta avaa OpenCities Map Ultimate for Finland -ohjelmisto. Aktiiviseksi kuvatiedostoksi voit avata kohteet sisältävän tiedoston, tai voit kiinnittää referenssiksi tiedostot, jonka kohteet haluat siirtää. KuntaGML- siirtotiedoston uloskirjoituksen lomake avautuu työkaluryhmästä Tiedonsiirto > Luku/kirjoitus > KuntaGML Export.
| Kohteiden valinta | Valitse kohteiden valintapa: Valinta, Aita, Koko tiedosto, Näkymä 1. Valinta: kirjoittaa valintajoukon kohteet. Aita: Piirrä aita kuvalle. Voit rajata kohteita myös tasoja sammuttamalla. Koko tiedosto: Kirjoittaa aktiivisen tiedoston ja kiinnitetyn referenssin kohteet, ei huomioi sammutettuja tasoja eikä näkymästä poistettuja referenssejä Näkymä 1: Käyttää rajauksena näkymää 1. Voit rajata kohteita myös tasoja sammuttamalla |
| Aineistotyyppi | Valitse aineistotyyppi, jonka mukaisia kohteita KuntaGML – siirtotiedostoon aiot siirtää. |
| Vastaavuustiedosto | Toiminnon asetustiedosto |
| GML-tiedosto | Valitse Selaa.. - painike ja anna avautuvalla lomakkeella polku ja tiedostonimi luotavalle siirtotiedostolle *.gml tai *.xml – tiedosto. Huomaa muuttaa tarvittaessa tiedostotyyppiä lomakkeelta |
| Kohteiden suodatus |
Valitse valinta kohteelle, jotka haluat lukea. Jos haluat lukea kaikkia kohteita, valitse pääkohteeseen valinta, tällöin sen alta kaikki kohteet saavat valintamäärityksen. Huomaa, että lomake näyttää kohteet, joille vastaavuus on määritetty vastaavuustiedostoon. Se ei siis näytä kohteita, joita kuvatiedostot pitää sisällään. |
| Luo lokitiedosto |
Valitse valinta kohtaan Luo lokitiedosto, mikäli haluat siirrosta luotavan lokitiedoston. Vastaavalla rivillä olevalla Selaa.. – painikkeella voit määrittää lokitiedostolle polun ja nimen. Jos valinta on päällä ennen GML-tiedoston valintaa tulee lokitiedoston polku ja nimi (pääte log) vastaaviksi kuin itse GML-tiedostolla |
| Vie korkeus | Valitse valinta kohtaan Vie korkeus, mikäli haluat kirjoittaa kohteille korkeuden KuntaGML – siirtotiedostoon. |
| Desimaalien lkm | Valitse desimaalien lkm kohtaan desimaalien määrä, jolla tarkkuudella kohteet kirjoitetaan siirtotiedostoon |
| Vastaavuudet |
Valitse Vastaavuudet - painike, jos haluat muokata siirron vastaavuustiedostoa. Katso lisätietoa kohdasta KuntaGML Vastaavuustiedosto Huomaa, että vastaavuustiedosto vaihtuu, sen mukaan mikä aineistotyyppi on aktiivisena. |
| Aloita | Valitse Aloita – painike, kun haluat käynnistää tiedonsiirron valituilla määrityksillä |
KuntaGML vastaavuustiedosto
Tiedonsiirroissa käytettään vastaavuustaulukoita. Jokaiselle aineistotyypille on oma vastaavuustiedostonsa:
Kantakartta: KuntaGMLBaseMapMappings.xml
Asemakaava KuntaGMLCityPlanMappings.xml
Opaskartta: KRYSPGuideMapMappings.xml
Palvelut: KRYSPServicesMappings.xml
Verkkotopologia: KRYSPNetworkTopologyMappings.xml
Osoitteet: KRYSPAddressesMappings.xml (vain Export)
Vastaavuustiedostossa on omat vastaavuusmäärityksensä sisäänlukuun (Import) ja uloskirjoitukseen (Export).
Vastaavuustiedostoa on mahdollista editoida sekä KuntaGML – lomakkeilta, että suoraan soveltuvalla XML – editorilla.
Jos muokkaat vastaavuustiedostoa, ota ennen editointia tiedostosta varmuuskopio.
KuntaGML Import – vastaavuuslomakkeen avaus
Valitse ensin aineistotyyppi KuntaGML Import – lomakkeelta. Valitse tämän jälkeen Vastaavuudet - painike.
Huomaa, että kohdevastaavuuksille on mahdollista määrittää myös muita lisäparametreja, joita ei vielä avautuvalla lomakkeella voi tällä hetkellä tehdä.
KuntaGML Import kohdevastaavuudet
KuntaGML-kohde: KuntaGML – kohdenimi
Geometria: KuntaGML – siirtotiedostosta poimittava geometria
KuntaGML:ssä saman kohdenimen alla voi olla useita eri geometrioita, OpenCities Map Ultimate for Finland -ohjelmassa kukin kohde pitää sisällään yhden pää-geometrian.
Point: Pistemäinen
Linear_Edge: Viivamainen (reuna)
Linear_Centerline: Viivamainen (keskilinja)
Area: Aluemainen
Kohderivillä oleva geometriamääritys tulee vastata OpenCities Map Ultimate for Finland -kohteen geometriamääritystä. Esimerkki Kivi-määrityksestä, jossa määritys ohjataan kolmeen eri kohdeluokkaan riippuen geometriasta:
Lisäehto:
Lisäehdolla voidaan määrittää, että KuntaGML - kohteesta poimitaan tietyn ehdon omaavat kohteet. Lisäehdossa ominaisuustiedon nimi, kuten myös ominaisuustiedon arvo ovat KuntaGML-kohteen mukaiset
| Metsa | Point | luokka=varvikko|pensaikko|havupensaikko|lehtipensaikko|pensaikko |
| Metsa | Point | maapohja=soistuma |
| Metsa |
Vastaavuustiedostossa järjestyksellä on väliä, eli ensin käsitellään listassa ylimpänä olevat määritykset. Mikäli määrityksessä ei ole lisäehtoa, tulee kaikki kyseisen geometrian omaavat kohteet tähän valintamääritykseen.
Stella-kohde: OpenCities Map Ultimate for Finland -kohteeksi luettavan kohteen nimi (huomaa, että kohdenimessä ei käytettä _Collection päätettä)
OpenCities Map Ultimate for Finland -kohteeksi luetaan siirtotiedostosta kohteet, jotka täyttävät samalla rivillä määritetyt ehdot KuntaGML-kohde,Geometria ja Lisäehto.
Käännä: Käännä-määrityksellä true voidaan muuttaa viivan kulkusuuntaa. Kulkusuunnan muuttamista käytetään yleensä vain symboliviivoilla. Tällöin alkupisteestä tulee päätepiste ja päätepisteestä alkupiste, ja symboliviivan puoli muuttuu myös päin vastaisesti. Oletusarvona on suositeltavaa pitää false -arvoa.
Kierto:
Kierto-määrityksellä voidaan lisätä kohteen KuntaGML – määritykseen kiertoa. Kiertoarvo on asteina. Jos lisäkiertoa ei haluta, käytetään arvoa 0.
Tallenna:
Tallenna-painikkeella tallennetaan tehdyt muutokset vastaavuustiedostoon.
Sulje:
Sulje-painikkeella suljetaan Kohdevastaavuus-tiedoston editointi. Painamisen jälkeen avautuu lomake "Tallennetaanko muutokset" vastaavuustiedostoon.
Lisää:
Lisää-painikkeella luodaan uusi tyhjämääritys viimeiselle riville oman määrityksen tekoa varten.
Poista:
Poista-painikkeella poistetaan valittu vastaavuusmääritys (rivi). Ennen Poista-painikkeen painamista valitaan rivi. Valinnan voi tehdä klikkaamalla riviä Valitse-sarakkeessa.
Ominaisuudet:
Kohdevastaavuuksien lisäksi on määritettävä ominaisuustietojen vastaavuudet kullekin määritykselle.
Ensin valitaan kohdevastaavuusrivi, jonka ominaisuusvastaavuuksia halutaan määrittää.
KuntaGML Import ominaisuustietovastaavuudet
Huomaa, että kaikkia määrityksiä ei ole mahdollista luoda/editoida käyttöliittymässä tällä hetkellä, vaan osa pitää tehdä XML-editorilla.
KuntaGML-ominaisuustieto/Arvo:
Ominaisuustiedon nimi KuntaGML:ssä tai OpenCities Map Ultimate for Finlandiin oletuksena tallennettava arvo.
Vastaavuustyyppi:
Mahdollisia vastaavuustyyppimäärityksiä:
None, Assign, Constant, Geometry, List, XCoord, YCoord, ZCoord, Length, Area, Rotation, Label, Array, UUID, Today, Struct, Compose, LabelSpecial, AssignText, ComposeFloorCount, ParseFloorCount, ReferencePoint, AssignAllowEmpty, RotationText, AssignTodayIfEmpty, AssignParentProperty, AssignParentSubstring, AssignParentSubstringSeparated, AssignLanguageValue, ParseParentFloorCount, AutomaticAnnotation
OpenCities Map Ultimate for Finland -ominaisuustieto:
Annetaan OpenCities Map Ultimate for Finland -ominaisuustiedon nimi, jonka arvoksi määritetty arvo kirjoitetaan.
Hyväksy:
Hyväksy-painikkeella hyväksytään ominaisuustietovastaavuuksiin tehdyt muutokset.
Peruuta:
Peruuta-painikkeella hylätään ominaisuustietovastaavuuksiin tehdyt muutokset.
Lisää:
Lisää-painikkeella luodaan uusi tyhjämääritys viimeiselle riville oman määrityksen tekoa varten
Poista:
Poista-painikkeella poistetaan valittu vastaavuusmääritys (rivi). Ennen Poista-painikkeen painamista valitaan rivi. Valinnan voi tehdä klikkaamalla Valitse-sarakkeessa vastaavuusmääritysriviä.
Listavastaavuudet:
Listavastaavuudet on määritettävissä omalla lomakkeellaan kun Vastaavuustyyppi on List.
Oletusarvo:
tallennetaan OpenCities Map Ultimate for Finland -kohteelle, jos listavastaavuutta ei löydy.
KuntaGML-arvo:
Arvo, joka on KuntaGML – kohteella
Stella-arvo:
Arvo, joka kirjoitetaan OpenCities Map Ultimate for Finland -kohteelle.
Esimerkkejä yleisimmistä KuntaGML Import ominaisuustietovastaavuuksista
Sijainnin luku OpenCities Map Ultimate for Finland -kohteelle:
Annetun arvon tallennus suoraan ominaisuuteen:
KuntaGML-ominaisuuden tallennus suoraan OpenCities Map Ultimate for Finland -ominaisuuteen
Ominaisuustietoarvon uudelleenmääritys listan avulla:
KuntaGML Export -vastaavuustiedoston määritykset
Valitse ensin aineistotyyppi KuntaGML Export -lomakkeelta. Valitse tämän jälkeen Vastaavuudet-painike, jos haluat editoida vastaavuustiedostoa.
Huomaa, että kohdevastaavuuksille on mahdollista määrittää myös muita lisäparametreja, joita tällä lomakkeella ei voi tällä hetkellä tehdä.
Kohdevastaavuudet:
Stella-kohde:
OpenCities Map Ultimate for Finland -kohdenimi. (Huomaa, että kohdenimessä ei käytettä _Collection päätettä)
Geometria:
KuntaGML – siirtotiedostoon kirjoitettava geometria.
KuntaGML:ssä saman kohdenimen alla voi olla useita eri geometrioita, OpenCities Map Ultimate for Finland -ohjelmassa kukin kohde pitää sisällään yhden päägeometrian.
Any
Point: Pistemäinen
Linear_Edge: Viivamainen (reuna)
Linear_CenterLine: Viivamainen (keskilinja)
Area: Aluemainen
Kohderivillä oleva geometriamääritys tulee vastata OpenCities Map Ultimate for Finland -kohteen geometriamääritystä.
Lisäehto:
Lisäehdolla voidaan määrittää, että OpenCities Map Ultimate for Finland -kohteesta poimitaan tietyn ehdon omaavat kohteet. Lisäehdossa ominaisuustiedon nimi, kuten myös ominaisuustiedon nimi ovat OpenCities Map Ultimate for Finland -kohteen mukaiset
MaaKohdeViiva Linear_Edge Tyyppi=jyrkänne&Vaihda_suunta=False&Reuna=yläreuna
MaaKohdeViiva Linear_Edge Tyyppi=jyrkänne&Vaihda_suunta=True&Reuna=yläreuna
| (tolppa) -merkkiä käyttämällä voidaan luetteloida useita eri arvoja samaan kyselyyn. & -merkillä voidaan antaa lisäehtoja. Vastaavuustiedostossa järjestyksellä on väliä, eli ensin käsitellään listassa ylimpänä olevat määritykset, mikäli määrityksessä ei ole lisäehtoa, tulee kaikki kyseisen geometrian omaavat kohteet tähän valintamääritykseen.
KuntaGML-kohde:
KuntaGML-kohteeksi kirjoitettavan kohteen nimi
Huomaa, että KuntaGML-formaatti on tarkka järjestyksestä, johon kohteet kirjoitetaan.
Käännä:
Käännä-määrityksellä true voidaan muuttaa viivan kulkusuuntaa. Kulkusuunnan muuttamista käytetään yleensä vain symboliviivoilla. Jolloin alkupisteestä tulee päätepiste ja päätepisteestä alkupiste, jolloin symboliviivan puoli muuttuu myös päin vastaisesti. Oletusarvona on suositeltavaa pitää false -arvoa.
Kierto:
Kierto-määrityksellä voidaan lisätä kohteen KuntaGML-määritykseen kiertoa. Kiertoarvo on asteina. Jos lisäkiertoa ei haluta, käytetään arvo 0.
KuntaGML Export ominaisuustietovastaavuudet
Huomaa, että kaikkia alla mainittuja määrityksiä ei ole mahdollista luoda/editoida käyttöliittymässä tällä hetkellä, vaan ne pitää tehdä XML-editorilla.
Huomaa myös, että ominaisuustietojen kirjoitusjärjestyksenä tulee noudattaa KuntaGML-kohteelle määritettyä järjestystä.
Stella-ominaisuustieto:
Annetaan OpenCities Map Ultimate for Finland -ominaisuustiedon nimi, jonka arvo kirjoitetaan KuntaGML-kohteelle. Mikäli arvo on tyhjä, arvoksi kirjoitetaan tyhjä arvo.
Vastaavuustyyppi:
Mahdollisia vastaavuustyyppimäärityksiä:
None, Assign, Constant, Geometry, List, XCoord, YCoord, ZCoord, Length, Area, Rotation, Label, Array, UUID, Today, Struct, Compose, LabelSpecial, AssignText, ComposeFloorCount, ParseFloorCount, ReferencePoint, AssignAllowEmpty, RotationText, AssignTodayIfEmpty, AssignParentProperty, AssignParentSubstring, AssignParentSubstringSeparated, AssignLanguageValue, ParseParentFloorCount, AutomaticAnnotation
KuntaGML-ominaisuustieto / Arvo:
Ominaisuustiedon nimi KuntaGML:ssä
Hyväksy:
Hyväksy-painikkeella hyväksytään ominaisuustietovastaavuuksiin tehdyt muutokset.
Peruuta:
Peruuta-painikkeella hylätään ominaisuustietovastaavuuksiin tehdyt muutokset.
Lisää:
Lisää-painikkeella luodaan uusi tyhjämääritys viimeiselle riville oman määrityksen tekoa varten
Poista:
Poista-painikkeella poistetaan valittu vastaavuusmääritys (rivi). Ennen Poista-painikkeen painamista valitaan rivi. Valinnan voi tehdä klikkaamalla Valitse-sarakkeessa vastaavuusmääritysriviä.
Listavastaavuudet:
Listavastaavuudet on määritettävissä omalla lomakkeellaan kun Vastaavuustyyppi on List.
Oletusarvo-määrityksellä arvoksi KuntaGML-kohteelle tallennetaan tämä arvo jos listavastaavuutta ei löydy.
Stella-arvo:
Arvo, joka on käytetty OpenCities Map Ultimate for Finland -kohteella
KuntaGML-arvo:
Arvo, joka kirjoitetaan KuntaGML-kohteelle.
