Settings - Asetukset Settings - Asetukset 1. 2. 3. 4. 5. Karttojen piirtoväri ja piirtovärin läpinäkyvyys Filtterit a. Filtterin lisääminen b. Filtterin poistaminen Uudelleenohjaukset Filtteri vai uudelleenohjaus? Exporter-rajapinnan asetukset Settings-sivun kautta on mahdollista muokata Kirjastokarttapalveluun liittyviä kirjastokohtaisia asetuksia. 1. Karttojen piirtoväri ja piirtovärin läpinäkyvyys Piirtoväri määrittää millä värillä paikannettavan julkaisun sijainti piirretään kartalle. Piirtovärin läpinäkyvyys puolestaan määrittää piirtovärin läpikuultavuuden. Karttojen piirtoväri ja piirtovärin läpinäkyvyys ( eng. opacity) on mahdollista määritellä sekä koko palvelun että yksittäisen kartan tasolla. Settings-sivulla määritellyt oletusasetukset vaikuttavat kaikkiin karttoihin, ellei yksittäisen k artan kohdalla ole muuta määritelty. Oletusasetusten määrittely tapahtuu Settings-sivun Drawing Settings -osiossa. Kuva 1. Karttojen piirtovärin ja piirtovärin läpinäkyvyyden oletusasetukset. Piirtovärin määritteleminen tapahtuu syöttämällä haluttua väriä vastaava heksadesimaaliluku Drawing color -kenttään. Värien määrittelyssä on apuna graafinen värivalitsin, joka avautuu Drawing color-kenttää klikkaamalla. Valitsin asettaa valittua väriä vastaavan heksadesimaaliluvun Drawing color-kenttään automaattisesti. Piirtovärin läpinäkyvyys määritellään Opacity-kentään syötettävän väliltä 0-255 olevan kokonaisluvun avulla. 0 tarkoittaa läpinäkyvää ja 255 täysin läpikuultamatonta. Piirtoväri ilmaistaan heksadesimaalikuna ja värin läpinäkyvyys kokonaislukuna väliltä 0-255. 0 tarkoittaa läpinäkyvää ja 255 täysin läpikuultamatonta. 2. Filtterit Kirjastokarttapalveluun on mahdollista luoda ennen sijainnin paikannusta suoritettavia uudelleenohjauksia eli ns. filttereitä, jotka mahdollistavat paikannettavan sijaintitiedon muokkauksen ennen annetun sijainnin hakua palvelun tietokannasta. Toimintoa voidaan hyödyntää esimerkiksi tapauksissa, joissa yhdellä sijainnilla on useampia eri sijaintitunnuksia tai yhdestä sijaintitunnuksesta on useita eri kirjoitusasuja. Filtterit kohdistuvat Kirjastokarttapalvelulle välitettävän callno-parametrin määrittämään arvoon. Aktiiviseksi määritellyt filtterit suoritetaan aina jokaisen paikannuksen yhteydessä. Filtterien ketjuttaminen ei kuitenkaan ole mahdollista eli sijaintitiedon vastatessa filtterin määrittelemää ehtoa, ei loppuja filttereitä enää suoriteta. Esimerkki: Sijaintitunnukset X, Y ja Z viittaavat kaikki samaan laitoskirjastoon. Tällöin kyseinen laitoskirjasto tallennetaan Kirjastokarttapalveluun siten, että sen sijaintitunnukseksi asetetaan yksi kolmesta vaihtoehdosta, esim.
X. Kahdelle muulle tunnukselle luodaan sen sijaan filtterit, joiden avulla kerrotaan palvelulle, että sijaintitunnukset Y ja Z tarkoittavat käytännössä sijaintitunnusta X. Filtterit suoritetaan jokaisen paikannettavan sijaintitiedon yhteydessä ja niiden määrittely tapahtuu säännöllisten lausekkeiden avulla. Kuva 2. Preprocessing redirects -osio Settings-sivulla. Filttereiden määrittely tapahtuu Settings-sivun Preprocessing redirects -osiossa, jossa kutakin palveluun syötettyä filtteriä varten on oma rivinsä. Osiossa on aina näkyvillä vähintään yksi rivi, vaikka palveluun ei olisikaan tallennettu yhtään filtteriä. Filttereihin liittyvien kenttien merkitykset on esitetty taulukossa 1. Kenttä Active Selitys Onko filtteri aktiivinen eli suoritetaanko filtteri jokaisen sijainnin paikannuksen yhteydessä. Passiivinen filtteri säilytetään Kirjastokarttapalvelussa, mutta se jätetään aina suorittamatta. Condition Ehto, jonka toteutuessa Operation-kentän määrittelemä toimenpide suoritetaan. Määritellään säännöllisten lausekkeiden avulla. Operation Operaatio, joka suoritetaan Condition-kentän määrittelemä n ehdon täyttyessä. Määritellään säännöllisten lausekkeiden avulla. Taulukko 1. Filttereihin liittyvät kentät. Aiemmin esitetyn esimerkin mukaiset filtterit, joiden tarkoituksena on kertoa Kirjastokarttapalvelulle, että sijaintitunnukset Y ja Z tarkoittavat käytännössä sijaintitunnusta X, on esitetty taulukossa 2. Condition ^Y ^Z Operation X X Taulukko 2. Esimerkin mukaiset filtterit. Käytännössä taulukossa 2 esitetyt filtterit tarkoittavat, että mikäli sijaintitunnuksen alusta löytyy Y- tai Z-kirjain, korvataan se kirjaimella X. Condition-sarakkeessa esiintyvä ^-merkki puolestaan tarkoittaa, että sarakkeen sisältämän merkkijonon on oltava sijaintitunnuksen alussa. Mikäli sijaintitunnus sisältää Y- tai Z-kirjaimen lisäksi muuta tietoa, säilyy muu tieto muuttumattomana, koska Condition-kenttä kohdistaa operaation vain ensimmäiseen merkkiin, mikäli ensimmäinen merkki on Y tai Z. Jos Condition-kenttän arvo sen sijaan olisi '^Y.*', korvattaisiin Y-kirjain ja kaikki sen jälkeen tulevat merkit kirjaimella X. Tämä perustuu siihen, että ehto '^Y.*' tarkoittaa sijaintitiedon alussa olevaa Y-kirjantainta ja kaikkia sen jälkeen mahdollisesti tulevia merkkejä. Säännöllisissä lausekkeissa piste tarkoittaa mitä tahansa merkkiä ja tähti merkitsee puolestaan sitä edeltävän symbolin toistoa 0-n kertaa. Kuva 3. Esimerkin mukaiset filtterit. Kirjastokarttapalvelu mahdollistaa myös monimutkaisempien filtterien tekemisen, joissa Condition-kentässä määrite
ltyjä ehtoja vastaavia merkkijonoja käytetään Operation-kentässä. Tämä perustuu siihen, että kaikki Condition-ken tässä sulkujen sisällä olevia ehtoja vastaavat merkkijonot talletetaan muuttujiin $1-$9, joita voidaan käyttää Operati on-kentässä. Esimerkki: Filtterin avulla halutaan lisätä muotoa kirjaston tunnus + hyllyuokan tunnus (esim. L 001) olevan sijaintitiedon keskelle kokoelman tunnus Col (esim. L 001 -> L Col 001). Kirjaston ja hyllyluokan tunnuksien tarkalla sisällöllä ei ole väliä, mutta tiedetään, että ne voivat sisältää numeroita ja kirjaimia. Tällöin Condition-kenttään kirjoi tetaan ehto ' ^(\w+) (\w+)', ja Operation-kenttään puolestaan ' $1 Col $2'. Säännölisten lausekkeiden rakentaminen perustuu pitkälti erikoismerkkien käyttöön, joiden tunteminen on välttämätöntä säännöllisten lausekkeiden kanssa työskenneltäessä. Taulukossa 3 on esitetty säännöllisten lausekkeiden yleisimpiä erikoismerkkejä. Erikoismerkki Selitys. mikä tahansa yksittäinen merkki paitsi rivinvaihto ^ rivin tai merkkijonon alku $ rivin tai merkkijonon lopu * nolla tai useampi edellistä merkkiä + yksi tai useampi edellistä merkkiä? nolla tai yksi edellistä merkkiä \n rivinvaihto \t sarkain \w mikä tahansa alphanumeerinen merkki. Sama kuin [a-za-z0-9_] \W ei mikään alphanumeerinen merkki. Sama kuin [^a-za-z0-9_] \d mikä tahansa numero. Sama kuin [0-9] \D ei mikään numero. Sama kuin [^0-9] \s mikä tahansa tyhjä merkki: välilyönti, sarkain,rivinvaihto jne. \S edellisen negaatio Taulukko 3. Säännlisten lausekkeiden yleisimpiä erikoismerkkejä. Filttereiden määrittely perustuu säännöllisten lausekkeiden käyttöön. Kirjastojarttapalvelu on toteutettu Java-ohjelmointikielellä, joten säännöllisten lausekkeiden on noudatettava Javan käyttämää syntaksia. Lisätietoja säännöllisten lausekkeiden käytöstä Javassa: http://docs.oracle.com/javase/tutorial/essential/regex/ Lisätietoja säännöllisistä lausekkeista: http://www.regular-expressions.info/ 2.1 Filtterin lisääminen Preprocessing redirects -osiossa on aina näkyvillä vähintään yksi rivi, vaikka palveluun ei olisikaan tallennettu yhtään filtteriä. Mikäli palveluun ei ole entuudestaan tallennettu yhtään filtteriä, voidaan ensimmäisen filtterin tallennus aloittaa kirjoittamalla suoraan valmiiksi näkyvissä olevalle tyhjälle riville. Mikäli palvelussa sen sijaan on filttereitä jo entuudestaan, aloitetaan uuden filtterin lisääminen Preprocessing redirects -otsakkeen alla sijaitsevaa Add-painiketta klikkaamalla, jonka myötä näytölle ilmestyy uusi tyhjä rivi. Tämän jälkeen syötetään Condition- ja O peration-kenttiin halutut tiedot, jonka jälkeen klikataan Save-painiketta. HUOM! Mikäli uuden filtterin lisäyksen yhteydessä on tehty muutoksia muihin filttereihin tai muihin sivulla oleviin asetuksiin, tallentaa Save-painikkeen klikkaus myös nämä muutokset. 2.2 Filtterin poistaminen Filtterin poistaminen tapahtuu poistettavan filtterin kanssa samalla rivillä olevaa punaista rastia klikkaamalla. Rastin klikkauksen myötä filtterin Condition- ja Operation-kentät tyhjentyvät, eikä Active-kenttä ole enää valittuna. Tässä vaiheessa filtteriä ei ole vielä poistettu palvelusta, vaan poistaminen vaatii vielä Save-painikkeen klikkaamista. Yleisesti ottaen voidaan sanoa, että filtterit, joiden Condition- ja Operation-kentät ovat tyhjiä poistetaan palvelusta filtterien tallennuksen yhteydessä. Poistaminen ei siis välttämättä edellyttä punaisen rastin klikkaamista, vaan filtteriin liittyvien kenttien tyhjäksi jättäminen riittää. 3. Uudelleenohjaukset
Kirjastokarttapalveluun on mahdollista luoda ns. uudelleenohjauksia, jotka mahdollista paikannettavan sijaintitiedon muokkauksen ja uudelleenpaikannuksen, mikäli annettua sijaintitietoa ei löydy Kirjastokarttapalvelun tietokannasta. Uudelleenohjaukset eroavat filttereistä siten, että ne suoritetaan vain siinä tapauksessa, että sijaintitietoa ei pystytä paikantamaan kirjasto-, kokoelma- tai hyllyluokkatasolla, kun filtterit taas suoritetaan aina jokaisen paikannuksen yhteydessä. Uudelleenohjaukset kohdistuvat filtterien tapaan Kirjastokarttapalvelulle välitettävän callno-parametrin määrittämään arvoon. Kuva 4. Location not found redirects -osio Settings-sivulla. Uudelleenohjausten määrittely tapahtuu Settings-sivun Location not found redirects -osiossa, jossa kutakin palveluun syötettyä uudelleenohjausta varten on oma rivinsä. Osiossa on aina näkyvillä vähintään yksi rivi, vaikka palveluun ei olisikaan tallennettu yhtään uudelleenohjausta. Uudelleenohjauksiin pätevät muilta osin samat säännöt kuin filttereihinkin. 4. Filtteri vai uudelleenohjaus? Filtterien ja uudelleenohjausten keskeisin ero on, että ne suoritetaan eri vaiheissa paikannusprosessia. Filtterit suoritetaan aina jokaisen paikannuksen yhteydessä ennen varsinaista paikannusta ja uudelleenohjaukset vasta prosessin lopuksi vain siinä tapauksessa, että paikannettavaa sijaintia ei löytynyt Kirjastokarttapalvelusta. On olemassa monia tilanteita, jossa haluttu lopputulos voidaan saada aikaan molemmilla tavoilla. Tällaisissa tilanteissa kannattaa suosia uudelleenohjauksia filtterien sijaan, koska uudelleenohjaukset suoritetaan vain silloin, kun paikannettavaa sijaintia ei muuten löydetä. Filtterit suoritetaan sen sijaan jokaisen paikannuksen yhteydessä, joten niiden turhaa käyttöä kannattaa välttää suorituskyvyn maksimoimiseksi. 5. Exporter-rajapinnan asetukset Settings-sivun Exporter interface -osiossa on mahdollista muokata Kirjastokarttapalvelusta tehtävät XML-siirrot ja -haut mahdollistavaan Exporter-rajapinnan pääsynhallintaan liittyviä asetuksia. Rajapinta voidaan määritellä täysin avoimeksi, jolloin kuka tahansa pääsee tekemään hakuja palvelusta, tai sallia sen käyttö vain määrätyistä IP-osoitteista. Rajapintaan liittyvien kenttien selitykset on esitetty taulukossa 4. Kuva 5. Exporter-rajapinnan asetukset. Kenttä Public access Selitys Jos asetus on valittu, on rajapinta kaikille avoin. Muussa tapauksessa vain Allowed ip addresses -kentässä listatuist a IP-osoittesta on pääsy rajapintaan.
Allowed ip addresses Mikäli rajapinta ei ole kaikille avoin, vain tässä kentässä listatuista IP-osoitteista on pääsy rajapintaan. Yksi IP-osoite / rivi. IP-osoitteiden määrittelyssä voidaan käyttää hyväksi *-merkkiä, joka toimii korvausmerkkinä. Näin voidaan esimerkiksi sallia pääsy kaikista 123.456.7.* alkuisista osoitteista. Taulukko 4. Exporter-rajapinnan kentät. Mikäli Exporter-rajapinnan tarjoamia toimintoja halutaan käyttää hyväksi sivupohjiin liitettävissä skripteissä tai plugin eissa, kannattaa rajapinta jättää kaikille avoimeksi. Vaikka skriptit ja pluginit sijaitsevat Kirjastokarttapalvelun palvelimella, niin niiden suorittaminen tapahtuu kuitenkin käyttäjän internet-selaimessa, jolloin Exporter-rajapinnan kutsu tulee käyttäjän IP-osoitteesta. Recently Updated Kirjastokartta 2017-02-27 updated by M Nicholas Volk v LOCATION SERVICE 2016-09-23 updated by M Nicholas Volk v Ylläpito 2016-09-21 updated by M Nicholas Volk v LOCATION SERVICE 2014-08-14 updated Google Maps 2014-07-08 updated Plugin - Highlighting map areas Creating a template for a specific collection Settings Maintenance Esittely 2014-06-10 updated
Kirjastokartta 2014-06-10 updated REST API - V1 - Käyttäjät 2014-06-06 updated Ylläpito 2014-05-17 updated Google Maps -kartat 2014-05-17 updated Versiopäivitys 17.5.2014 - versio 3.0.0 2014-05-17 updated