Asetukset

Asetustiedoston nimi määritetään ympäristömuuttujalla STELLAMAP_EXPORT_TO_FACTA_FILE. , eli esim. skeematiedoston Makrot-osiossa näin:

STELLAMAP_EXPORT_TO_FACTA_FILE = $(STELLAMAP_DIR)/xml/ExportToFactaSettings.xml

Jos ko. ympäristömuuttujaa ei ole määritetty, tai tiedostoa ei löydy, käytetään oletustiedostoa C:\temp\ExportToFactaSettings.xml , mikäli sellainen on olemassa. Asetustiedostossa määritetään tiedot tietokantayhteyttä varten, tietokantataulujen nimet sekä siirrettävät ryhmät ominaisuustietoineen.

Tietokantayhteys määritetään osiossa DBConnectionStr, esim. <DBConnectionStr>Data Source=xxx;User Id=xxx;Password=xxx;</DBConnectionStr> Ryhmän nimi määritetään (ilman ääkkösiä) osiossa ExportGroup\GroupName, esim.

<ExportGroup>

<GroupName>kaavayksikot</GroupName>

Yhteen ryhmään kuuluu yksi tietokantataulu, joka määritetään osiossa ExportGroup\DBTableName, esim.

<ExportGroup>

<GroupName>kaavayksikot</GroupName>

<DBTableName>K_GEOM_KAAVYKS_A</DBTableName>

Features-osiossa määritellään siirrettävät kohteet ja ominaisuustiedot:

<ExportGroup>

<GroupName>kaavayksikot</GroupName>

<DBTableName>K_GEOM_KAAVYKS_A</DBTableName>

<Features>

<Feature name="TonttijakotonttiAlue_Collection">

<DisplayProperty>Yksikko</DisplayProperty>

<GeometryType>alue</GeometryType>

<PropertyMappings>

<PropertyMapping>

<FactaProperty>C_KUNTA</FactaProperty>

<StellaProperty>Kunta</StellaProperty>

</PropertyMapping> …

DisplayProperty määrittää, minkä ominaisuustiedon arvo näytetään toiminnon käyttöliittymässä kun selataan löytyneiden kohteiden tietoja.

Mikäli DisplayProperty-arvoa ei ole määritetty, käyttöliittymässä näytetään kohteen nimi.

Ominaisuustieto voi olla useamman ominaisuustiedon yhdistelmä ja siihen voi liittää muotoilusäännöksi kentän pituuden ja esim. väliviivat:

<PropertyMapping>

<FactaProperty>KAAVAYKSIKKOTUNNUS</FactaProperty>

<StellaProperty valueTemplate="[03Kunta]-[03Sijaintialue]-[04Ryhma][04Yksikko]"></StellaProperty>

</PropertyMapping>

StellaProperty-arvoksi voidaan määrittää myös numeerinen vakioarvo, esim.

<PropertyMapping>

<FactaProperty>C_OLOTILA</FactaProperty>

<StellaProperty>3</StellaProperty>

</PropertyMapping>

Jos ominaisuustietoa ei voi siirtää suoraan vaan OpenCities Map Ultimate for Finland -ominaisuustietoa vastaava arvo pitää hakea vastaavuuslistasta, määritetään StellaProperty -kohtaan arvoksi:

List.[OpenCities Map Ultimate for Finland -ominaisuustiedon_nimi]

, eli esimerkiksi kaavojen viennissä haetaan Factan tauluun C_KAAVLAJI-kentän arvo OpenCities Map Ultimate for Finland -ominaisuustiedosta ”kaavanvaihe” vastaavuuslistasta

List.kaavanvaihe

, joka on määritelty vastaavuuslistatiedostossa FactaValueMappings.xml näin:

<ValueMappingList name="kaavanvaihe">

<ValueMapping>

<StellaValue>vireilletullut</StellaValue>

<FactaValue>1</FactaValue>

</ValueMapping>

<ValueMapping>

<StellaValue>kaavaluonnos</StellaValue>

<FactaValue>2</FactaValue>

</ValueMapping>

</ValueMappingList>

Vastaavuuslistatiedoston nimi määritetään ympäristömuuttujalla STELLAMAP_EXPORT_TO_FACTA_VALUEMAPPINGS.

, eli esim. skeematiedoston Makrot-osiossa näin:

STELLAMAP_EXPORT_TO_FACTA_VALUEMAPPINGS = $(STELLAMAP_DIR)/xml/FactaValueMappings.xml

Jos ko. ympäristömuuttujaa ei ole määritetty, tai tiedostoa ei löydy, käytetään oletustiedostoa

C:\temp\FactaValueMappings.xml

, mikäli sellainen on olemassa.

Vastaavuuslistassa listan nimi on OpenCities Map Ultimate for Finland -ominaisuustiedon nimi (pienet ja isot kirjaimet ovat merkitseviä). StellaValue on kohteen ominaisuustiedon arvo ja FactaValue on sitä vastaava arvo, joka siirretään Facta-kantaan.

Jos asetustiedostoja muutetaan OpenCities Map Ultimate for Finland -ohjelman ollessa auki, tulee tehdyt muutokset voimaan näppäilykomennolla:

exporttofacta reload

Työnkulku

Factaan vienti käynnistetään valitsemalla työkaluryhmästä Tiedonsiirto > Luku/kirjoitus -> Facta Export. Toiminto lukee asetustiedostosta tietokantayhteystiedot, ja mikäli tietokantaan yhdistäminen onnistuu, aukeaa lomake:

Factaan vietäviä kohteita voidaan hakea valintajoukolla, aidalla tai skannaamalla koko tiedosto.

Ryhmä-kohdassa on listaus asetustiedostossa määritetyistä ryhmistä. Hae-napilla haetaan valittuun ryhmään kuuluvat kohteet, ja avataan lomake:

Löydettyjen kohteiden Factaan vietäviä ominaisuustietoja voi selata klikkaamalla ko. kohteen tekstiosaa.

Vie-napilla viedään Facta-kantaan ne listalla olevat kohteet, joiden ruutu on ruksattu.

Kaavat

Kaavojen vientiä varten asetustiedostossa on määriteltävä vastaavuudet vähintään seuraaville Factan kentille:

Näiden lisäksi Stella Map -ominaisuustiedoista on siirrettävissä

AREA_GEOMETRY-kohtaan laitetaan arvoksi AREA_GEOMETRY. Mikäli siirtovaiheessa tietokannasta löytyy kaava, jonka kaavatunnus on sama kuin siirrettävällä kohteella, kantaan ei lisätä uutta tietuetta vaan päivitetään olemassaolevaa kaavaa.

Kaavayksiköt

Kaavayksiköiden vientiä varten asetustiedostossa on määriteltävä vastaavuudet vähintään seuraaville Factan kentille:

AREA_GEOMETRY-kohtaan laitetaan arvoksi AREA_GEOMETRY.

Kaavayksikkötauluun ei pysty lisäämään tietueita ilman kaavayksikköä vastaavaa kaavatunnusta, joten kohteella täytyy olla ominaisuustietona kaavatunnus. Kun kaavayksikkötauluun siirretään kohteen tietoja, haetaan kaavatunnuksella kaavataulusta ko. kaavan tiedot. Mikäli kaavatunnuksella ei löydy kaavaa kaavataulusta, ei kohteen tietoja siirretä kantaan.

Mikäli siirtovaiheessa tietokannasta löytyy kaavayksikkö, jonka kaavatunnus sekä kaavayksikkötunnus ovat samat kuin siirrettävällä kohteella, kantaan ei lisätä uutta tietuetta vaan päivitetään olemassaolevaa kaavayksikköä.