Raportti - asetukset
Raportti – toiminnon asetukset määritetään StellaMap.xml – tiedostossa Geospatial Administrator – ohjelmistolla.
Raporttityökalun metodit löytyvät kohdasta Methods ja Raportti.
| Parametri | Selitys |
|---|---|
| reportFileName | Raporttitiedoston määritystiedoston nimi ja sijainti |
| styleSheetPathName | Raporttitiedostojen esitykseen ja muodostukseen liittyvien tyyliohjaintiedostojen sijainti |
Report.xml – määrittelytiedosto
Report.xml-tiedostossa on määritetty kuvatiedostosta raporttiin haettavat tiedot. Työkalua käytetään myös kaavatilastojen muodostamiseen.
Tiedostoa suositellaan editoitavaksi xml-editonitiin tarkoitetulla sovelluksella, mikä helpottaa xml-tiedostorakenteen hahmottamista.
Report.xml-tiedostossa määritetään kuvatiedostosta xml-tiedostoon poimittavat tiedot. Kullekin raportoitavalla tiedolle varataan oma rivinsä ja esim. Description-kentässä näkyy nimi, joka varsinaisesti on näkyvissä käyttäjälle käyttöliittymässä.
| Name | Raporttimäärityksen yksilöllinen nimi |
| Description | Raportin nimi, joka näkyy käyttäjälle Stella Mapin raporttityökalun valintalistassa |
| Header | Otsikon nimi, jonka alle tiedot raportoidaan xml-tulostiedostoon |
| Columns | xml -tulostiedostoon kirjoitettavat kohteen ominaisuus ja geometriset ominaisuudet |
| Features | Kohteet, joita kuvalta etsitään |
| StyleSheets | Luotavan raportin käyttämä tyylitiedosto (StyleSheet). Muodostetun xml – tulostiedoston ulkoasun määrityksessä voidaan käyttää ns. StyleSheet – määritystiedostoa. - StyleSheeteillä määritetään luotavan tekstitiedoston muoto sekä htm-tiedoston ulkoasu ja tietosisältö vs. generoitava xml-tiedosto. |
| TextStyle | Valinnainen määritys. Tekstityylin nimi, joka halutaan kuvaan liitettävälle raportille. Toiminto muuttaa määrityksen mukaisen tekstityylin aktiiviseksi tekstityyliksi. |
| Properties | Valinnainen määritys. Kohteen ominaisuustiedostot, jotka haetuilta kohteelta edellytetään |
Columns – geometriamääritykset
Kohteista voidaan kirjoittaa ominaisuustietojen lisäksi geometriatietoa. Mahdollisia raporttiin kirjoitettavia geometriatietoja ovat:
Ykoord
Xkoord
Zkoord
Pinta-Ala
Pituus
Tilavuus
Tyylitiedostomääritykset
StyleSheet – määritystiedostolla voidaan määrittää, millä tavalla xml–tulostiedoston tieto näytetään selaimessa tai millainen tekstitiedosto muodostetaan raportilla.
Tiedostoa suositellaan editoitavaksi stylesheet-tiedostojen editointiin tarkoitetulla sovelluksella, mikä helpottaa tiedostorakenteen hahmottamista.
Raportin muodostus näppäinkomennolla
Raportti on mahdollista luoda näppäinkomennolla. Komennossa on seuraavat parametrit:
| Parametri | Selitys |
|---|---|
| ReportListFile | tiedosto, jossa raporttien määritykset ovat |
| StyleSheetPath | hakemistopolku, jossa tyylitiedostot ovat |
| OutputFile | tulostiedosto |
| ReportName | raportin nimi (Report.xml-tiedoston arvo <Name> -lohkossa) |
| AppendToFile | Valinnainen parametri. Määrittää, lisätäänkö raportti olemassa olevaan tiedostoon vai luodaanko uusi. Mahdollisia arvoja, k,K,y,Y,0,1 |
Komennon käynnistys:
vba run GenerateReport parametrin_nimi=parametrin_arvo|parametrin_nimi=parametrin_arvo
Esimerkki: vba run GenerateReport ReportListFile=$(STELLAMAP_DIR)\xml\report.xml|StyleSheetPath=$(STELLAMAP_DIR)\x sl\|OutputFile=D:\temp\rep.txt|ReportName=Pyykit_1
Parametrien järjestyksellä ei ole merkitystä. Pienillä ja isoilla kirjaimilla ei myöskään ole merkitystä.
Parametrien ReportListFile,StyleSheetPath ja OutputFile arvoissa voi käyttää ympäristömuuttujaa.