Esimerkkimäärittelyjä erilaisille tiedoille

Kirjoitetaan kohteiden URL-linkit ja kuvat

Oletetaan, että kohteiden URL-linkit on liitetty kohteisiin (esimerkiksi lajeihin) URL-nimistä dokumenttityyppistä vapaata attribuuttia käyttäen.

Lisäksi on kohteiden visualisointikuva (GIF-tiedosto) liitetty kohteisiin GIF-nimistä dokumenttityyppistä vapaata attribuuttia käyttäen. Määritystiedostossa (esimerkiksi CategoryDefinition-lohkon lopussa) nämä asiat määritellään seuraavalla tavalla:

  <Url> 
   <Attribute>URL</Attribute>
   <AttributeEntry Language="sve">URL_sve</AttributeEntry>
   <AttributeEntry Language="enu">URL_enu</AttributeEntry>
  </Url>

  <Image> 
   <Attribute>GIF</Attribute>
  </Image>

Kirjoitetaan tietyn lajiset kohteet, joihin liittyy attribuutti

Halutaan kirjoittaa kaikki lajia 86308 olevat kohteet, joilla on määritetty arvo vapaalle attribuutille Bussipysäkit.

Hakuluokan nimi tulee automaattisesti attribuutin nimestä. Palvelun valitalistoilla esiintyvä nimi haetaan StreetLang1-nimisestä kentästä (eli kadunnimi suomeksi). Muissa kieliversioissa kohteiden nimet haetaan vapaan attribuutin avulla (IKP_name_sve ja IKP_name_enu). Vihjetekstinä näytetään katunimi suomeksi. Muissa kieliversioissa haetaan vihjetekstit vapaan attribuutin avulla (IKP_expl_sve ja IKP_expl_enu). Asiat voidaan määritellä seuraavalla tavalla:

<!-- Conditions-->
<Condition Type="Point">
<Category>BYATTRIBUTE</Category>
<Class>86308</Class>
<FilterAttribute Name="Bussipysäkit" />
<NameField>streetlang1</NameField>
<NameEntry Language="sve">IKP_name_sve</NameEntry>
<NameEntry Language="enu">IKP_name_enu</NameEntry>
<ExplanationField>streetlang1</ExplanationField>
<ExplanationEntry Language="sve">IKP_expl_sve</ExplanationEntry>
<ExplanationEntry Language="enu">IKP_expl_enu</ExplanationEntry>
</Condition>

Kirjoitetaan tietyn lajiset kohteet tiettyyn hakuluokkaan

Halutaan, että kaikki lajia 20799 olevat kohteet kuuluvat Hotellit-nimiseen hakuluokkaan palvelussa. Tämä voidaan määritellä seuraavalla tavalla:

<!-- Conditions-->
<Condition Type="Point">
<Category>Hotellit</Category>
<Class>20799</Class>
<NameField>teksti</NameField>
<NameEntry Language="sve">IKP_text_sve</NameEntry>
<NameEntry Language="enu">IKP_text_enu</NameEntry>
<ExplanationField>IMAGEEXPLANATION</ExplanationField>
<ExplanationEntry Language="sve">IKP_expl_sve</ExplanationEntry>
<ExplanationEntry Language="enu">IKP_expl_enu</ExplanationEntry>
</Condition>

Kirjoitetaan tietyn lajiset kohteet, joilla on tietty attribuutti ja tietty attribuuttiarvo hakuluokkaan

Halutaan, että kaikki lajia 20799 olevat kohteet, joilla on määritetty vapaa attribuutti Hakuluokka ja vapaan attribuutin arvon arvolistan selitys on Hotelli, kuuluvat Hotellit-nimiseen hakuluokkaan palvelussa.

Tässä Category voi olla joko BYATTRIBUTE tai "Hotelli" lopputuloksen ollessa sama. Tämä voidaan määritellä seuraavalla tavalla:

<!-- Conditions-->
<Condition Type="Point">
<Category>BYATTRIBUTE</Category>
<Class>20799</Class>
<FilterAttribute Name="Kohteen_hakuluokka" Value="Hotelli" />
<NameField>teksti</NameField>
<NameEntry Language="sve">IKP_text_sve</NameEntry>
<NameEntry Language="enu">IKP_text_enu</NameEntry>
<ExplanationField>IMAGEEXPLANATION</ExplanationField>
<ExplanationEntry Language="sve">IKP_expl_sve</ExplanationEntry>
<ExplanationEntry Language="enu">IKP_expl_enu</ExplanationEntry>
</Condition>

BYATTRIBUTE-suodin on tuettu vain kokonaislukutyyppisille vapaille attribuuteille.

Kirjoitetaan tietyn lajiset kohteet suoraan tietokantataulusta

Halutaan kirjoittaa kaikki lajia 80376 olevat kohteet sekä niihin liittyvät linkit, nimet ja selitykset suoraan tietyn tietokantataulun kentästä.

Tämä voidaan määritellä seuraavalla tavalla:

<!-- Conditions-->
<Condition Type="Point">
<Category>Ravintolat, kahvilat ja baarit</Category>
<Class>80376</Class>
<NameField>text</NameField>
<ExplanationField>text</ExplanationField>
<UrlField>streetlang1</UrlField>
</Condition>

Vapaavalinnaisten dokumenttien jakaminen

Trimble Locus -järjestelmän kohteisiin vapaalla attribuutilla kytkettyjä dokumentteja voidaan jakaa Internet-karttapalvelun kautta. Dokumentit määritellään ExternalDocument-elementillä, jonka arvoksi annetaan dokumenttityyppisen vapaan attribuutin nimi. Kaavojen yhteydessä dokumentit voidaan jakaa seuraavan esimerkin mukaisesti:

<Condition Type="PlanData">
  <Category>Kaavat</Category>
  <Class>25211</Class>
  <Presentation linecolor="blue" linewidth="2" linetype="solid" fillcolor="blue"/>
  <FilterAttribute Name="WritePlanToIKP" Value="2"/>
  <NameField>LUPlan.LUPlanLabel/Label</NameField>
  <ExplanationField>LUPlan.LUPlanName</ExplanationField>
  <MunicipalityCode>LUPlan.LUPlanLabel/Municipality</MunicipalityCode>
 <ExportPlanRegulations DisplayRegNum="false"/>
 <ExternalDocument>KuntaGML_latauspalvelu</ExternalDocument>
</Condition>

Näytetään pisteiden tiedot vihjeteksti-ikkunassa

Halutaan, että Trimble Locus -järjestelmän taulun kenttä tai vapaa attribuutti voidaan näyttää vihjeteksti-ikkunassa. Alla esimerkki määrittelystä:

<AdditionalAttributes>
<AdditionalAttribute Name="Name" Bubble="true" order="1">Name
</AdditionalAttribute>
<AdditionalAttribute Name="X" Bubble="true" order="3" NameKey="AttrX">X
</AdditionalAttribute>
<AdditionalAttribute Name="Y" Bubble="true" order="4">Y
</AdditionalAttribute>
<AdditionalAttribute Name="PointType" Bubble="true" order="2">PointType/Code
</AdditionalAttribute>
</AdditionalAttributes>

Name (pakollinen): Attribuutin nimi, NameKey (valinnainen): Käyttöliittymässä esitettävä nimi (viite TranslationLabel:iin), Bubble: Näytetäänkö kohteen vihjeteksti-ikkunassa, Order: Järjestys vihjeteksti-ikkunassa.

Kielivakion määritykseen käytetään <Translation Name="AttrX"> arvoa, Kohteen NameKey mukainen lokalisoitu arvo.

<Translation Name="AttrX">
<NameEntry Language="fin">X (Euref)</NameEntry>
<NameEntry Language="sve">X (Euref)</NameEntry>
<NameEntry Language="enu">X (Euref)</NameEntry>
</ Translation >


<CategoryLabel Name="Tasokiintopisteet" PinOffsetN="-5" PinOffsetE="3">
<NameEntry Language="fin">Tasokiintopisteet</NameEntry>
<NameEntry Language="sve">Stationer och terminaler</NameEntry>
<NameEntry Language="enu">Stations and terminals</NameEntry>
</CategoryLabel>

Hakuluokkakohtaisen visualisointikuvan siirtymän määrittäminen

Hakuluokkakohtaisen visualisointikuvan siirtymä voidaan määrittää. Alla esimerkki määrittelystä:

<CategoryLabel Name="Tasokiintopisteet" PinOffsetN="-5" PinOffsetE="3">
<NameEntry Language="fin">Tasokiintopisteet</NameEntry>
<NameEntry Language="sve">Stationer och terminaler</NameEntry>
<NameEntry Language="enu">Stations and terminals</NameEntry>
</CategoryLabel>

PinOffsetN määrittää siirtymän pohjoissuunnassa ja PinOffsetE siirtymän itäsuunnassa.

Rekisteritietojen näyttäminen vihjeteksti-ikkunassa

Trimble Locus -järjestelmän rekisteritietoja voidaan näyttää vihjeteksti-ikkunassa. Alla esimerkki määrittelystä:

Määritä julkaistavat tiedot FilterAttribute-elementillä.
Anna elementin Name-arvoksi merkintä, jonka alkuosa on EVAL: ja loppuosa noudattaa asiakirjatulostuksen tapaa määritellä tietokannasta tulostettavat tiedot.

Katso Trimble Locus Pääkäyttäjän käsikirja, kohta Tulostepohjien rakenne.
Esimerkiksi yleisten alueiden lupatyypit voidaan määrittää antamalla niihin liittyvät koodistoarvot joko Name-arvon sisällä tai erikseen Value-arvona.
- Esimerkiksi sekä määritys <FilterAttribute Name="EVAL:$(RpmPermit.PermitType)" Value="2"/> että määritys <FilterAttribute Name="EVAL:$(RpmPermit[PermitType=2].Id)"/> kirjoittavat molemmat tiedostoon vain lupatyypit, joiden koodiarvo on 2.
- Viittausten väliin voi lisätä tekstiä.
- @-merkki määrittää rivinvaihdon.
- Huomaa, että vaikka et käytä NameField-elementtiä, tulee se löytyä tiedostosta, jotta sen rakenne on ehjä.
Jos haluat suodattaa julkaistavia lupia voimassaoloajan perusteella, määritä suodatus FilterValidity-elementillä joko päivämäärinä tai päivien lukumääränä.
- Päivämäärinä: Anna StartDate- ja EndDate-arvoiksi päivämäärät, joiden sisällä osittain tai kokonaan voimassa olevat luvat julkaistaan. Esimerkiksi määrityksellä <FilterValidity StartDate="25.01.2009" EndDate="31.01.2009" /> julkaistaan kaikki luvat, jotka ovat voimassa vähintään yhtenä aikavälille osuvista päivistä.
- Päivien lukumääränä: Anna StartDate- ja EndDate-arvoiksi luvut, jonka verran päiviä lisätään nykyhetkeen ja näin saadun aikavälin sisällä osittain tai kokonaan voimassa olevat luvat julkaistaan. Huomaa, että luku summataan nykyhetkeen, eli jos haluat siirtää alkupäivämäärää aikaisemmaksi, tulee StartDate-arvoksi antaa negatiivinen luku. Esimerkiksi määrityksellä <FilterValidity StartDate="-6" EndDate="6" /> julkaistaan luvat, jotka ovat voimassa vähintään yhtenä päivänä aikavälillä, joka alkaa kuusi päivää ennen nykyhetkeä ja päättyy kuusi päivää nykyhetken jälkeen.
- Voit antaa toisen päivistä päivämääränä ja toisen päivien lukumääränä. Päivien lukumääränä annettu arvo lasketaan kuitenkin aina nykyhetkestä.
- Voit jättää alku- tai loppupäivämäärän asettamatta. Esimerkiksi sekä määritys <FilterValidity StartDate="25.01.2009" /> että määritys <FilterValidity StartDate="25.01.2009" EndDate="" /> kirjoittavat molemmat tiedostoon kaikki luvat, joiden voimassaolon loppupäivä on sama tai myöhempi kuin annettu alkupäivä.

Esimerkki

Esimerkki Condition.xml-tiedoston kaivulupien CategoryDefinition-lohkosta:

<CategoryDefinition>
<!--  Conditions  --> 

<Condition Type="Polygon">
     <Category>Kaivuluvat</Category>
     <Class>62205,62210,62220</Class>
     <FilterAttribute Name="EVAL:$(RpmPermit.PermitType)" Value="2" />
     <MunicipalityCode>FIXEDVALUE:853</MunicipalityCode>
     <NameField>GridId</NameField>
     <NameEntry Language="fin">EVAL:$(RpmPermit.PermitType/
       CodeExpl=RpmPermitType) $(RpmPermit.Label/Label=RpmPermit)</NameEntry>
     <NameEntry Language="sve">EVAL:$(RpmPermit.PermitType/
       CodeExpl=RpmPermitType) $(RpmPermit.Label/Label=RpmPermit)</NameEntry>
     <ExplanationField>Id</ExplanationField>
     <ExplanationEntry Language="fin">EVAL:Lupatyyppi: $(RpmPermit.PermitType/
       $(RpmPermit.RpmPermitPurpose.Note)@Luvan hakija:
       $(RpmPermit.RpmPermitParty[Role=1].GenContactInfo.Surname)
       @Voimassaoloaika:$(RpmPermit.PermitStartDate/Date) - 
       $(RpmPermit.PermitEndDate/Date)</ExplanationEntry>
     <ExplanationEntry Language="sve">EVAL:Lovtyp: $(RpmPermit.PermitType/
       CodeExpl=RpmPermitType)@Syfte:
       $(RpmPermit.RpmPermitPurpose.Note)@Sökande:
       $(RpmPermit.RpmPermitParty[Role=1].GenContactInfo.Surname)
       @Lovets giltighetstid: $(RpmPermit.PermitStartDate/Date) - 
       $(RpmPermit.PermitEndDate/Date)</ExplanationEntry>
     </Condition>

</CategoryDefinition>