PAIKKATIETOIKKUNAN LUETTELOPALVELU KÄYTTÖOHJE
Sisällysluettelo Sisällysluettelo... 2 1. Yleistä Luettelopalvelusta... 3 2. Luettelopalvelun tulevia ominaisuuksia... 3 3. Käyttöoikeudet... 4 4. Lisenssit... 4 5. Selainyhteensopivuus... 4 6. Luettelopalvelun käsitteitä... 5 6.1. Skeemakomponentti... 5 6.2. Kohdetyyppi... 5 6.3. Verrokki... 5 6.4. Verrokkiryhmä... 5 6.5. Skeema... 5 6.6. Skeemaresurssi... 5 6.7. Skeemalähde... 5 6.8. Skeemaryhmä... 5 6.9. Organisaatio... 6 6.10. Skeemaryhmän lisenssi... 6 6.11. Skeemakomponentin perintä... 6 7. Pikaopas... 7 7.1. Luettelopalvelun etusivu... 7 7.2. Skeemataulukko... 8 7.3. Luettelopalvelun hakutoiminto... 8 7.4. Yksittäisen skeeman avaaminen... 8 7.5. Skeemataulukon laajat tiedot... 9 8. Tarkemmat ohjeet... 10 8.1. Skeeman selailu... 10 8.2. Valmiit haut... 12 8.3. Skeemakomponenttien tarkastelu... 12 8.4. Skeeman resurssien (tiedostot) tarkastelu... 16 8.5. Skeeman ja skeemaryhmän tiedot... 17
1. Yleistä Luettelopalvelusta Paikkatietoikkunan Luettelopalvelussa esitellään paikkatietoalaan liittyviä XML-skeemoja ja niihin liittyvää dokumentaatiota. Paikkatietoikkunan Luettelopalvelun tiedot perustuvat Paikkatietohakemistoon tallennettuihin metatietokuvailuihin sekä Luettelopalveluun vietyihin XMLSchema-kuvailuihin, dokumentaatioon ja palveluiden ja aineistojen XML-määrittelyihin. Luettelopalvelussa käyttäjä voi hakea ja selata palveluun ladattuja XMLskeemoja ja XML-skeemojen skeemakomponentteja. Hakutoimintoina tuetaan vapaatekstihakua, hakua nimiavaruuden, nimen ja komponentin tyypin sekä Substitution Group -parametrin perusteella. Skeemakomponentin selailu on hypertekstin kaltaista liikkumista skeemakomponentista toiseen skeeman elementtien tyyppien perusteella. Skeemakomponentista esitetään komponentin rakenne, attribuutit ja mahdollinen dokumentaatio ja linkit ulkoisiin dokumentteihin. Skeemaan liittyvien koodistojen koodiarvot ja niihin liittyvät selitteet esitetään. Skeemaan ja skeemakomponenttiin voi linkittää ulkoisesta sovelluksesta joko leijuke (overlay) -näkymään tai sovellusnäkymään. Käyttöliittymä on suomen, ruotsin tai englanninkielinen poislukien skeeman aineisto, jonka kielistys riippuu skeeman laatineesta organisaatiosta. XML-skeeman lähdeaineistojen nykyiset vaihtoehdot XMLSchema-tiedosto linkitettyine tiedostoineen WFS-palvelun Capabilities-määritys Skeemojen lähdeaineistoon, lisenssitietoihin ja vastuuorganisaatioon liittyviä tietoja voidaan tallentaa Luettelopalveluun. Skeemakohtaisesti tai skeematyyppikohtaisesti voidaan tallentaa oletushakutoimintoja, esim GML-skeemoille voidaan tallentaa valmis haku, joka hakee kaikki skeeman AbstractFeature (GML 3.2.1) -kohdetyypit tai _Feature (GML 3.1.1) -kohdetyypit. 2. Luettelopalvelun tulevia ominaisuuksia Luettelopalvelua kehitetään edelleen kevään 2011 aikana. Seuraavassa versiossa Luettelopalvelun tietoja on mahdollista liittää leijukkeena kolmannen osapuolen sovelluksiin. Liittäminen edellyttää, että paikkatietoaineistolla on Paikkatietohakemiston aineistotunniste. Lisäksi Luettelopalvelu täydentyy ylläpitoliittymällä ja Tietotuoteselostetulosteella kevään 2011 aikana. Ylläpitoliittymässä ylläpitäjä voi tallentaa ja latauttaa tai virkistää XMLSchema-aineiston luettelopalveluun. Lisäksi voidaan tallentaa XMLSchemoihin liittyviä dokumentteja, kuvia ja UML kaavioita sekä linkkejä dokumentaatioon.
Paikkatietohakemiston tietojen ja Luettelopalvelun skeematietojen sekä Luettelopalveluun tallennettujen täydentävien kuvailujen tietojen perusteella on mahdollista tuottaa Tietotuoteseloste-tuloste. Tulevissa versioissa skeeman lähdeaineistona voidaan käyttää: Palvelun tai aineiston metatietodokumentti Paikkatietohakemistossa, jos tarvittavat tiedot metatiedoista löytyvät koneellisesti luettavassa muodossa WSDL-kuvaukseen linkitetyt XMLSchema kuvailut WPS-prosessin kuvailuun mahdollisesti linkitetyt XMLSchema-kuvailut 3. Käyttöoikeudet Paikkatietoikkunan Luettelopalvelu-sovellus on vapaasti saatavilla. Ylläpitotoiminto on tarkoitettu rekisteröityneille käyttäjille. 4. Lisenssit 5. Selainyhteensopivuus Luettelopalvelun lähdekoodi julkaistaan avoimen lähdekoodin lisenssillä. Luettelopalvelua on testattu seuraavilla selaimilla: Windows (XP) - Safari 5, Google Chrome, Mozilla Firefox, Internet Explorer 8 Mac OS X - Safari 5, Google Chrome, Opera, Mozilla Firefox Ensisijainen kehitysselain on ollut Safari. Sovellus sisältää muutamia HTML5-ominaisuuksia, mutta ne eivät ole selainvaatimuksena.
6. Luettelopalvelun käsitteitä 6.1. Skeemakomponentti 6.2. Kohdetyyppi 6.3. Verrokki 6.4. Verrokkiryhmä 6.5. Skeema 6.6. Skeemaresurssi 6.7. Skeemalähde 6.8. Skeemaryhmä (engl. Schema Component) Skeeman nimetty rakenne. Skeemakomponenttiluettelossa esitettviä skeemakomponentteja ovat globaalit elementit, complextypet, simpletypet, attributet, attributegroupit sekä groupit. (engl. Feature Type) Kohdetyyppi on skeemakomponentin erikoistapaus. Luettelopalvelussa kohdetyypiksi kutsutaan mm. Geography Markup Language -skeeman (GML) versioiden 3.1 _Feature ja 3.2 AbstractFeature-verrokkiryhmään suoraan tai epäsuorasti kuuluvia elementtityyppisiä skeemakomponentteja. (engl. Substitution, kuuluminen ryhmään Substution Group Affiliation ) Skeemaelementin (elementtityyppinen skeemakomponentti ) vertaisryhmä, johon elementin voi liittää substitutiongroup-määrityksellä. (engl. Substitution Group) Joukko skeemaelementtejä, joilla on sama substitutiongroup-määritys. (engl. Schema Instance) Skeema sisältää skeematiedoston ja siihen linkitettyjen toisten skeematiedostojen skeemakomponentit. Skeema liittyy luettelopalvelussa aina skeemaryhmään ja organisaatioon. (engl. Schema Resource ) Skeeman lukemisen yhteydessä suoraan tai URI -viittausten kautta luettu skeematiedosto. (engl. Schema Source / Source ) Luettelopalvelun skeemojen lähteitä voivat olla standardiorganisaatioiden skeemat, sovelluskohtaiset skeemat tai verkkopalveluita kuvaavat skeemat. Nykyversioon on toteutettu skeemojen luku standardiorganisaatioista ja WFS- palveluista GetCapabilities / DescribeFeatureType kutsuin. (engl. Schema Composition)
Skeemaryhmä muodostuu joukosta tavalla tai toisella yhteenkuuluvia skeemoja. Esimerkkinä yhden Web Feature Service (WFS) -palvelun kohdetyyppien (Feature Types) skeemat muodostavat skeemaryhmän. 6.9. Organisaatio 6.10. Skeemaryhmän lisenssi 6.11. Skeemakomponentin perintä (engl. Schema Repository Organization) Organisaatio, joka tuottaa tai julkistaa skeemat joko sellaisenaan tai verkkopalveluiden välittämien tietojen kautta. Skeematietojen yhteyteen voidaan tallentaa lisenssiteksti ja/tai viittaus lisenssiehtoihin. Muutamat skeemoja tuottavat organisaatiot myös vaativat lisenssitietojen liittämisen skeemojen esittelyn yhteyteen. Skeemakomponentit perivät ominaisuuksia ja attribuutteja rajoittaen (restriction) tai laajentaen (extension).
7. Pikaopas 7.1. Luettelopalvelun etusivu Luettelopalvelun etusivulla on skeemojen hakutoiminto sekä skeemataulukko, jossa listataan palveluun ladattuja skeemoja.
7.2. Skeemataulukko 7.3. Luettelopalvelun hakutoiminto Skeemataulukon rivi vastaa yksittäistä skeemaa luettelopalvelussa. Skeemataulukon rivejä voi lajitella taulukon sarakkeiden otsikkoja painamalla. Taulukossa esitettävät tiedot voi valita otsikkoriviltä avautuvasta valikosta. 7.4. Yksittäisen skeeman avaaminen Hakutoiminto hakee skeemoja avainsanojen perusteella. Toiminnon rajoitteet (tilanne 31.1.2011): - Luettelopalvelun hakutoiminto kohdistuu skeemojen XML-tiedostojen sisältöihin. Haku ei kohdistu skeemaluettelon otsikkotietoihin - Hakutulokset perustuvat sellaisenaan Postgresql-tietokannan tekstihaun palauttamiin vastauksiin - Hakutuloksia ei lajitella relevanssin mukaan. Skeemataulun vasemman reunan -painikkeella voi avata skeeman tiedot lähempään tarkasteluun, jolloin esitetään myös skeeman skeemakomponenttien luettelo ja skeeman rakennetta. Skeema avautuu aina uuteen välilehteen, joten useita skeemoja voi olla avattuna samanaikaisesti. Välilehtiä voi ja kannattaakin sulkea välilehden [x] painikkeella.
7.5. Skeemataulukon laajat tiedot Linkkiä painamalla avautuu vastaava dokumentti. Taulukon rivin vasemman reunan [+] merkillä avautuvat skeeman laajemmat tiedot. Linkistä avautuu lähdeaineisto. Laajemmissa tiedoissa luetellaan skeemaan ja skeemaryhmään liittyvät dokumentit. Skeemaryhmän nimi toimii linkkinä, josta avautuu näkymä, johon on valittu vain tiettyyn skeemaryhmään liittyvät skeemat. Metatietotulosteen Proof-of-Concept -tasoinen tuloste avautuu Tuloste - linkistä.
8. Tarkemmat ohjeet 8.1. Skeeman selailu Skeeman välilehdelle avautuu vasemmalla luettelo skeeman liittyvistä nimetyistä skeemakomponenteista. Jos skeemalla on tai sille on tallennettu selkeä kohdekomponentti (esim. WFS-palvelun kohdetyyppi), tuodaan kohde esiin, kun skeema avataan. Tarkennettu haku avautuu painikkeella Skeemakomponentit on ryhmitelty nimiavaruuden (namespace) mukaan. Nimiavaruuden komponentit saa luettelossa esiin [+] painikkeella. Skeemaluettelon saa esiin valitsemalla Skeemaluettelo välilehden. Taulukossa esitettävät tiedot voi valita otsikkoriviltä avautuvasta valikosta.
Tarkennettu haku Tarkennetulla haulla voi hakea eri tyyppiä skeemakomponentteja tai tiettyyn verrokkiryhmään kuuluvia skeemakomponentteja. Valintaluetteloiden arvot luetaan skeeman tiedoista. Etsi -painikkeella skeemakomponenttiluettelossa esitetään vain hakuehtoja vastaavat skeemakomponentit. Kaikki skeemakomponentit voi palauttaa esiin painikkeella Näytä kaikki. Haut kohdistuvat vain valittuun skeemaan.
8.2. Valmiit haut 8.3. Skeemakomponenttien tarkastelu Valmiit haut -osio on konfiguroitavissa skeematyyppikohtaisesti. Tällä hetkellä valmiilla haulla voi hakea kohdetyyppejä tai sijaintikohteita skeemoista, joissa GML 3.1 tai GML 3.2 nimiavaruus on mukana. painike käynnistää haun. Hakutoiminnot näyttävät luettelossa vain hakuja vastaavat skeemakomponentit. Haut kohdistuvat vain valittuun skeemaan. Näytä kaikki komponentit toiminto palauttaa skeemakomponenttiluettelon alkutilaan, jolloin kaikki skeemakomponentit ovat esillä luettelossa. Skeeman rakenteiden tai skeemakomponenttien selailu toimii hypertekstin kaltaisesti valitun skeeman rakenteissa. Skeeman elementtien ja perinnän tyyppitiedot toimivat hyperlinkkinä viitatun tyypin kuvaukseen.
Skeemakomponentin perinnän tyyppitiedot toimivat hyperlinkkeinä tyypin kuvailuun. Skeemakomponenttien navigoinnin tarkoitus ei ole olla täydellinen esitys rakenteesta vaan se helpottaa skeeman rakenteen tarkastelua.
Elementit toimivat linkkeinä elementin tyypin kuvailuun. Nimettömien tyyppien esitys on hieman kesken (31.1.2011). Täydellisen skeeman alkuperäisen XMLSchema-esityksen skeemakomponentin rakenteesta saa esiin alareunasta..
XMLSchema esityksen osuutta ruudusta voi säätää vetämällä välipalkkia hiirellä ylös tai alas Alareunan Välilehdillä voi vaihtaa skeeman tietoja esitteleviä näkymiä
8.4. Skeeman resurssien (tiedostot) tarkastelu Skeeman linkittyneitä XMLSchema tiedostoja voi selailla skeemaresurssit välilehdellä, jonka saa esiin alareunan painikkeella. Taulukossa esitettävät tiedot voi valita otsikkoriviltä avautuvasta valikosta. Luettelosta valittu tiedoston XML esitetään oikean reunan lähdekoodina.
8.5. Skeeman ja skeemaryhmän tiedot Skeemaan (lähinnä skeemaryhmän kautta) liittyviä muita resursseja (SLD kuvailut, lähdeaineistot, mahdolliset metatiedot) voi selata Skeemaryhmän tietoja -välilehdellä, jonka saa esiin alareunan välilehdistä. Esimerkissä WFS Capabilities -rakenne, johon skeemaryhmä perustuu. Taulukossa esitettävät tiedot voi valita otsikkoriviltä avautuvasta valikosta. Avaa sarakkeen kuvaketta painamalla avautuu vastaava dokumentti. Luettelosta valitun tiedoston XML esitetään oikean reunan lähdekoodina. Vaihtoehtoinen esitys on XML-puurakenne. XML puurakenteen toteutus on keskeneräinen (tilanne 31.1.2011)