Collapse AllExpand All

Osoitteiden, nimistö- ja matkailukohteiden määrittelytiedosto - Condition.xml

Määrittelytiedosto on tyypillisesti Condition.xml -niminen tekstitiedosto. Hakutoiminnoissa tarvittavat osoitteet, nimistötiedot ja matkailukohteet, yms. ja kohteiden hakuluokka määritetään seuraavien periaatteiden mukaan:
Ominaisuus
Määritystapa
Pakollisuus
Kohteen www-linkki
Kohteen dokumenttityyppinen vapaa attribuutti tai tietokantataulun kentässä löytyvä tieto.
Jos ei ole määritetty, käytetään oletuslinkkiä.
Kohteen visualisoinnissa käytettävä selaimen tukemassa formaatissa oleva kuvatiedosto:
- yleensä GIF- tai JPEG-tyyppinen.
Kohteen dokumenttityyppinen vapaa attribuutti tai tietokantataulun kentässä löytyvä tieto.
Jos ei ole määritelty, käytetään oletuskuvaa.
Kohteen hakuluokka.
- Attribute, määrittelyssä alla.
Määritetään: 1. lajin tai 2. lajin ja arvolistallisen numerotyyppisen vapaan attribuutin yhdistelmä.
Pakollinen
Kohteesta haun yhteydessä näytettävä teksti.
- NameField, määrittelyssä alla.
Erikielisten kohteiden nimet haetaan vapaan attribuutin avulla.
- NameEntry, määrittelyssä alla.
Tietokantataulun kenttä tai linkin/kuvatiedostoattribuutin selitys.
Pakollinen
Kohteesta linkin vihjetekstinä näytettävä teksti.
ExplanationField, määrittelyssä alla.
Tietokantataulun kenttä tai linkin/kuvatiedostoattribuutin selitys.
Pakollinen
Kohteen www-linkki aineistotiedostojen lataukseen
Kohteen dokumenttityyppinen vapaa attribuutti. Jos halutaan lisätä useita tiedostoja, tulee useiden attribuuttien lisääminen mahdollistaa Vapaiden Attribuuttien Editorilla (FatEd).
Ei pakollinen.
Vihjeteksti-ikkunassa pisteiden tietojen näkyminen. AdditionalAttributes
Lokalisointi määritellään seuraavalla tavalla:
<AdditionalAttribute Name="Luokka" Language="fin" Bubble="true" order="5" NameKey="Luokkateksti">IKP_teksti_fin</AdditionalAttribute>
<AdditionalAttribute Name="Luokka" Language="sve" Bubble="true" order="5" NameKey="Luokkateksti">IKP_teksti_sve</AdditionalAttribute>
<AdditionalAttribute Name="Luokka" Language="enu" Bubble="true" order="5" NameKey="Luokkateksti">IKP_teksti_enu</AdditionalAttribute>
Name oltava sama kaikilla kielillä, esimerkissä yllä "Luokka".
Trimble Locus -järjestelmän taulun kenttä tai vapaa attribuutti näkyy vihjeteksti-ikkunassa.
Ei pakollinen.
Hakuluokkakohtaisen visualisointikuvan siirtymä PinOffsetN ja PinOffsetE
XPinOffsetN siirtymä pohjoissuunnassaPinOffsetE siirtymä itäsuunnassa
Ei pakollinen.
Aluemuotoisten hakukohteiden kuvaustekniikka. 
<Presentation linecolor="blue" linetype="solid" fillcolor="blue" linewidth="2"/>
Linecolor = Viivan väri. HTML-värin nimi tai heksadesimaaliesitys, esim. "blue" tai "#0000FF".
Linetype = Viivan tyyppi. Solid = yhtenäinen, dash = katkoviiva, longdash = katkoviiva pitkillä viivoilla, dot = pisteviiva.
Fillcolor = Täytön väri. HTML-värin nimi tai heksadesimaaliesitys, esim. "blue" tai "#0000FF".
Linewidth = Viivan leveys pikseleinä.
Ei pakollinen.
Esimerkki määrittelytiedostosta ja sen avulla tuotetusta tulostiedostosta löytyy liitteestä A. Määrittelytiedosto ja tulostiedosto.
Määrittelytiedosto sisältää seuraavat asiat:
1. Yhden (valinnaisen) Defaults-lohkon, johon kuuluu seuraavat osat:
  • Image-osa: Koko palvelun oletuskuvatiedostomääritys.
  • Url-osa: Koko palvelun oletuslinkkimääritys.
  • CategoryLabel-osia (tarvittava määrä): Ryhmäkohtaiset oletusarvot, esim. asemille, hotelleille, yrityksille, jne.. CategoryLabel-osat voivat sisältää (Url/Image-osat eivät ole pakollisia):
    • Name-määrityksen: Vapaan attribuutin nimi.
    • NameEntry-määrityksiä: Kielikohtaiset vaihtoehdot hakuryhmälle.
    • Url-määrityksen: Hakuryhmän oletuslinkki oletuskielellä.
    • UrlEntry-määrityksiä: Hakuryhmän oletuslinkit palvelun muilla kielillä.
    • Image-määrityksen: Hakuryhmän oletuskuvatiedoston määritys.
2. Yhden tai useamman CategoryDefinition-lohkon, joka sisältää yhden tai useamman Condition-lohkon, yhden Url-lohkon ja yhden Image-lohkon. Kohteiden valinta esitetään käyttäen tätä lohkoa, lisätietoja löytyy alla olevassa esimerkissä.

Esimerkki Defaults-lohkosta

<categoryDefaults>
<Image>http://webmap/system_bmp/korostus_pallo.gif</Image>
<Url>http://www.tekla.com</Url>

   <CategoryLabel Name="Bussiaikataulut: päivälinjat">
   <NameEntry Language="sve">Busstidtabeller: dag</NameEntry>
   <NameEntry Language="enu">Bus time-tables: day</NameEntry>
   <Url>http://www.bussit.paivalinjat.fi</Url>
   <UrlEntry Language="enu">www.bussit.paivalinjat.fi/enu</UrlEntry>
   <UrlEntry Language="sve">www.bussit.paivalinjat.fi/sve</UrlEntry>
   <Image>http://webmap/system_bmp/OP_bussit.gif</Image>
   </CategoryLabel>

   <CategoryLabel Name="Asemat ja terminaalit">
   <NameEntry Language="sve">Stationer och terminaler</NameEntry>
   <NameEntry Language="enu">Stations and terminals</NameEntry>
   <Url>http://www.asemat.fi</Url> 
   <UrlEntry Language="enu">www.asemat.fi/enu</UrlEntry>
   <UrlEntry Language="sve">www.asemat.fi/sve</UrlEntry>
   <Image>http://webmap/system_bmp/OP_asemat.gif</Image>
   </CategoryLabel>

</categoryDefaults>

CategoryDefinition-lohkon syntaksi

CategoryDefinition-lohkon avulla määritellään kohteiden lajit ja lajien vapaat attribuutit, jotka otetaan mukaan kohdehakutiedostoon.
Lohkon alkuun tulevalla valinnaisella SkipAttribute-määrityksellä voidaan merkitä halutun nimisellä vapaalla attribuutilla, että jotakin Trimble Locus -kohdetta ei kirjoiteta tietokannasta kohdehakutiedostoon. Tätä voidaan käyttää silloin kun joidenkin hakukohteiden ylläpito tapahtuu ns. verkkopalvelussa ja muiden hakukohteiden ylläpito Trimble Locus -järjestelmässä.
Alla olevassa esimerkissä Trimble Locus -kohteet (ylläpidettyjä verkkopalvelussa), joihin liittyy MaintAtSomewhereElse-niminen vapaa attribuutti jätetään kirjoittamatta kohdehakutiedostoon (1 = ei kirjoiteta).
Jos SkipAttribute-määritystä ei käytetä, ohjelma kirjoittaa kaikki muiden määritysten mukaiset kohteet kohdehakutiedostoon.
CategoryDefinition-lohkon syntaksi on seuraava: 
<CategoryDefinition>
<SkipAttribute Name="MaintAtSomewhereElse" Value="1" />
<!-- Conditions-->

   <Condition Type="Point">
   <Category>Category name | BYATTRIBUTE</Category>
   <Class>Class id</Class>
   <FilterAttribute Name="Free attribute id | Free attribute name"
     Value="Attribute value | Attribute value list name" />
   <NameField>Table field name | IMAGEEXPLANATION | URLEXPLANATION</NameField>
   <NameEntry Language="language">Free attribute name</NameEntry>
   <ExplanationField>Table field name | IMAGEEXPLANATION
     | URLEXPLANATION</ExplanationField>
   <ExplanationEntry Language="language">Free attribute name
     </ExplanationEntry>
   <UrlField>Field in database table</UrlField>
   <ImageField>Field in database table</ImageField>
   </Condition>

  <Url> 
   <Attribute>Free attribute id | Free attribute name</Attribute>
   <AttributeEntry Language="language">Free attribute name</AttributeEntry>
  </Url>

  <Image> 
   <Attribute>Free attribute id | Free attribute name</Attribute>
  </Image> 

</CategoryDefinition>
  • Jos Attribute (kts. yllä) on numeerinen, tulkitaan se attribuutin id-arvoksi. Muutoin se tulkitaan attribuutin nimeksi.
  • Kun Category-attribuutin arvo on BYATTRIBUTE, järjestelmä päättelee hakuluokan vapaan attribuutin perusteella.
  • NameEntry-määrityksillä voidaan määritellä mukaanotettavat vapaat attribuutit halutuilla kielillä, Language voi esimerkiksi olla "fin", "sve" tai "enu".
  • ExplanationEntry-määrityksillä voidaan määritellä näytettävään vihjetekstiin mukaanotettavat vapaat attribuutit halutuilla kielillä, Language voi myös tässä esimerkiksi olla "fin", "sve" tai "enu".
  • Kielisyysvaihtoehtoja ei tueta tapauksissa joissa linkki tai kuva haetaan tietokantataulun kentästä määrityksillä UrlField ja ImageField.