Wiki source code of Hakutoiminto
Last modified by akuusija@helsinki_fi on 2024/02/07 06:51
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | (% style="color: rgb(255,0,0);" %)This page has been integrated to (% style="color: rgb(255, 0, 0); color: rgb(255, 0, 0)" %)Specimen search/Näytetietojen haku(% style="color: rgb(255,0,0);" %)[[doc:digit.Kotka Collection Management System.Manual for Kotka.SpecimensNäytteet.Specimen search.WebHome]] | ||
2 | |||
3 | Kotkan näytehakutoiminto on huomattavan monipuolinen, mutta sen käyttö voi aluksi olla hankalaa. Hakutoiminnosta on olemassa myös yksinkertaistettu versio. Tässä kerrotaan miten näitä voi käyttää. Hakusivu on osoitteessa [[https:~~/~~/kotka.luomus.fi/specimens/search>>url:https://kotka.luomus.fi/specimens/search||shape="rect"]] (Kotkan valikosta Specimens > Search). | ||
4 | |||
5 | //Tämä ohje koskee hakuomaketta sellaisena kuin se oli 27.10.2015.// | ||
6 | |||
7 | == Yksinkertainen haku == | ||
8 | |||
9 | Yksinkertaiseen hakulomakkeeseen pääsee Query builder -napista (merkitty vihreällä alempana olevaan kuvaan). Sillä voi hakea näytteitä muutamien kenttien perusteella kirjoittamalla kunkin hakuehdon omaan kenttäänsä. Kun lomakekenttiin alkaa kirjoittamaan, osaa Kotka tarjota Kotkaan tallennettuja kirjoitusvaihtoehtoja. | ||
10 | |||
11 | Haku on AND-haku, eli kaikkien hakuehtojen tulee näytettäviin näytteisiin. | ||
12 | |||
13 | == Monipuolinen haku == | ||
14 | |||
15 | Monipuolisella haulla pystyy mm. | ||
16 | |||
17 | * Tekemään täsmällisiä ja sanahakuja kaikkiin näytekenttiin | ||
18 | * Määrittelemään AND, OR ja NOT -hakuehtoja | ||
19 | * Tekemään yhdistelmä-, samankaltaisuus-, osittais- ja muita monipuoisia hakuja | ||
20 | * Tilastoimaan näytteitä kaikkien näytekenttien mukaan | ||
21 | * Järjestämään näytteitä kaikkien näytekenttien mukaan | ||
22 | * Ottamaan hakutulokset ulos erilaisissa Excel-muodoissa sekä erilaisina etiketteinä | ||
23 | |||
24 | [[image:attach:hakulomake-ohje.png]] | ||
25 | |||
26 | |||
27 | |||
28 | Lomakkeella on kaksi kenttää, joihin voi kirjoittaa hakuehtoja. Hakuehtojen kirjoittamisen jälkeen klikkaa **Search**-nappia (kuvassa violetilla). **Clear all** -nappi tyhjentää kaikki hakuehdot. | ||
29 | |||
30 | === Tunnistehaku === | ||
31 | |||
32 | Ylempään identifier-kenttään voi kirjoittaa näytteen tunnisteita tai tunnistevälejä lyhyessä muodossa. Mikäli haluat hakea näytteitä, jotka ovat eri verkkotunnusavaruudessa kuin oman museosi näytteet, kirjaa tämän lyhenne tunnisteen eteen (tun, luomus tai utu). | ||
33 | |||
34 | * **luomus:GV.1-10, luomus:GP.100-120** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?identifier=luomus:GV.1-10, luomus:GP.100-120&sortBy=documentQName&sortDirection=ASC||shape="rect"]]) | ||
35 | * (% style="line-height: 1.42857;" %)**tun:SPL.1-50**(%%) (% style="line-height: 1.42857;" %)((%%) [[linkki>>url:https://kotka.luomus.fi/specimens/search?identifier=tun:SPL.1-50&sortBy=documentQName&sortDirection=ASC||style="line-height: 1.42857;" shape="rect"]] (% style="line-height: 1.42857;" %)) | ||
36 | |||
37 | === Kaikkien kenttien haku === | ||
38 | |||
39 | Alempaan search terms -kenttään voi kirjoittaa kaikkiin kenttiin kohdistuvia hakuja. | ||
40 | |||
41 | Oletuksena Kotka hakee näytteet, joissa **jokin hakusanoista esiintyy missä tahansa kentässä**. Jos haluat hakea fraasilla, kääri sanat lainausmerkkeihin. | ||
42 | |||
43 | * **Cap Verde** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=Cap%20Verde&sortBy=documentQName&sortDirection=ASC||shape="rect"]]) - Cap tai Verde: 2579 hakutulosta | ||
44 | * **"Cap Verde"** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=%22Cap%20Verde%22&sortBy=documentQName&sortDirection=ASC||shape="rect"]]) - Täsmällinen hakutermi: 56 hakutulosta | ||
45 | * **sahlberg** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=sahlberg&sortBy=documentQName&sortDirection=ASC||shape="rect"]]) - palauttaa näytteet joissa esiintyy "sahlberg" esim. kerääjänä, määrittäjänä tai lajinimessä | ||
46 | |||
47 | Jos haluat kohdistaa haun tiettyyn kenttään, ala kirjoittamaan kentän "tietokantanimeä". Kotka tarjoaa oikeita kenttänimiä automaattisesti. Sitten kirjoita hakusana kaksoispisteen jälkeen lainausmerkkeihin, jotka Kotkan myös lisää automaattisesti. | ||
48 | |||
49 | * **det: "sahlberg"** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=det:%20%22sahlberg%22||shape="rect"]]) - palauttaa näytteet, joissa on määrittäjänä Sahlberg | ||
50 | |||
51 | Kotka osaa myös tarjota hakusanoja sen mukaan mitä Kotkaan on tähän näytekenttään tallennettu. Esim. kun hakukenttään kirjoittaa sahlberg, tarjoaa Kotka vaihtoehdoiksi //Sahlberg, J.//, //Sahlberg, U.// ja //Sahlberg//. | ||
52 | |||
53 | Jos haluat hakea näytteet, jotka täsmäävät useaan hakuehtoon, klikkaa AND-nappia (kuvassa violetilla) kirjoitettuasi yhden hakuehdon. Sitten ryhdy kirjoittamaan uutta hakuehtoa samaan tapaan. Tällöin Kotka palauttaa ne näytteet, jotka täsmäävät kaikkiin ehtoihin. Voit myös kirjoittaa itse AND-sanan hakuehtojen väliin. | ||
54 | |||
55 | * **municipality: "Espoo" AND leg: "Heikkinen, Mikko"** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=municipality:%20%22Espoo%22%20AND%20leg:%20%22Heikkinen,%20Mikko%22||shape="rect"]]) | ||
56 | |||
57 | Jos haluat hakea näytteet, jotka täsmäävät mihin tahansa hakuehtoon, kirjoita OR-sana hakuehtojen väliin. | ||
58 | |||
59 | * **municipality: "Espoo" OR leg: "Heikkinen, Mikko" **(% style="color: rgb(0,0,0);" %)((%%)[[linkki>>url:https://kotka.luomus.fi/specimens/search?q=municipality:%20%22Espoo%22%20OR%20leg:%20%22Heikkinen,%20Mikko%22||shape="rect"]]) | ||
60 | |||
61 | Jos haluat hakea näytteet, jotka eivät täsmää annettuun ehtoon, kirjoita sen eteen NOT-sana, | ||
62 | |||
63 | * ((( | ||
64 | **NOT municipality: "Helsinki"** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=NOT%20municipality:%20%22Helsinki%22||shape="rect"]](% style="color: rgb(0,0,0);" %))(%%) - näytteet kaikkialta muualta paitsi Helsingistä | ||
65 | ))) | ||
66 | |||
67 | (% class="confluence-link confluence-link" style="color: rgb(0, 0, 0); color: rgb(0, 0, 0)" %)Ohjeen lopussa kerrotaan,** [[miten lomakkeella voi tehdä monipuolisempia hakuja>>doc:||anchor="Monipuolisia hakuehtoja"]]** | ||
68 | |||
69 | |||
70 | |||
71 | ===== Alanäytteet ja seuralaiset ===== | ||
72 | |||
73 | Koska Kotkassa näytteeseen voi kuulua useita osanäytteitä tai seuralaishavaintoja, tulevat nämäkin näkyville hakutuloksiin. Esimerkiksi näyte, jossa on //kaksi// lajia omina osanäytteinään sekä //kolme// seuralaishavaintoa, näkyy tuloksissa //viitenä// rivinä (ja vaikuttaa tulosten määrään vastaavasti). Näitä voi suodattaa pois seuraavasti: | ||
74 | |||
75 | Jos haluat nähdä vain näytteet (eikä havaintoja), lisää hakuehdoksi **recordBasis: "Preserved Specimen"** | ||
76 | |||
77 | Jos et halua että osanäytteet vaikuttavat tulosten määrään, lisää hakuehdoksi **firstInDocument: "true"** | ||
78 | |||
79 | === Aputoiminnot === | ||
80 | |||
81 | Oikean ylänurkan napeista (kuvassa punaisella) voi käyttää aputoimintoja: | ||
82 | |||
83 | **Linkki-ikoni** kopioi leikepöydälle käytössä olevat hakuehdot linkkinä. Tämän linkin voi tallettaa itselleen/tiimilleen muistiin tai vaikka välittää kollegalle. Huomaa että linkissä voi olla välilyöntejä; linkin katkeaminen näiden kohdalta esim. sähköpostiohjelmassa muuttaa sen toimimattomaksi. | ||
84 | |||
85 | **Kysymysmerkistä** pääsee lyhyeeseen hakutoiminnon esittelyyn. | ||
86 | |||
87 | **Hammasratas-ikonista** pääsee käsiksi asetuksiin. Asetuksista voi säätää seuraavia asioita: | ||
88 | |||
89 | (% style="margin-left: 30.0px;" %) | ||
90 | //Filter options//: mitkä kentät tulevat näkyville hakusivun vasemman reunan tilastoihin. | ||
91 | |||
92 | (% style="margin-left: 30.0px;" %) | ||
93 | //Filter size//: kuinka monta vaihtoehtoa tilastoihin tulee näkyville. | ||
94 | |||
95 | (% style="margin-left: 30.0px;" %) | ||
96 | //Result options//: mitkä kentät tulevat näkyville hakutulostaulukkoon. | ||
97 | |||
98 | Selain muistaa nämä asetukset, joten omia suosikkiasetuksia ei tarvitse säätää joka kerta uudelleen samaa selainta käytettäessä. | ||
99 | |||
100 | **Hakutulostaulukon sarakeotsikkoja** klikkaamalla tuloksia voi järjestellä. Jos haet näytteitä kartan avulla ja otat mukaan **Wgs84Location**-kentän, voi sen perusteella järjestää tulokset etäisyyden mukaan. | ||
101 | |||
102 | **Specimens I've edited or created today** -linkkiä klikkaamalla saat nopeasti haettua äsken tallentamasi näytteet. Voit myös käyttää linkin hakua toisen haun pohjana ja muuttaa esimerkiksi päivämäärärajausta hakulaatikkoon. | ||
103 | |||
104 | === Hakutulokset === | ||
105 | |||
106 | Hakutulostaulukossa jokainen "alanäyte" näkyy omana rivinään. Jos näytteeseen kuuluu yksi varsinainen näyte ja viisi seuralaislajihavaintoa, ne kaikki näkyvät omina riveinään, mikäli ne kaikki täsmäävät hakuehtoihin. | ||
107 | |||
108 | Jos hakutuloksia on kohtuullinen määrä (nyt 1000 kpl), ilmestyy lomakkeelle sinisiä nappeja, joiden kautta tulokset saa ulos eri muodoissa: | ||
109 | |||
110 | **Print labels**: tulostaa näytetiedot valitunlaisille etiketeille. Etiketit tulostuvat ainoastaan näytteistä, ei seuralaishavainnoista. | ||
111 | |||
112 | **Export to Excel** tekee tuloksista Excel-taulukon. Tässä on valittavana useita muotoja: | ||
113 | |||
114 | * **In Kotka format**: Kotkan tallennusformaatissa. Näytetietoja voi muokata tässä taulukossa ja viedä ne sitten takaisin sisään (ellei kukaan muu ole muokannut näytteitä sillä aikaa Kotkassa.) | ||
115 | * **Simply export the results**: Excel-taulukkoon tulevat ne kentät, jotka olet valinnut näkymään tulostaulukossa. Kätevä esim. raportteihin. | ||
116 | * **Hertta format**: Hertta-järjestelmän käyttämässä muodossa. Kätevä, jos tietoja kopioidaan Herttaan (kunnes tämä automatisoidaan Lajitietokeskuksen kautta). | ||
117 | |||
118 | === Filters (suodattimet) === | ||
119 | |||
120 | Hakusivun vasemmassa reunassa on lisää valintoja hakutulosten suodattamiseksi. | ||
121 | |||
122 | * **Only accepted**: kohdistaa taksonihaut vain niihin määrityksiin, jotka on merkitty hyväksytyiksi, ja näyttää tuloslistassa vain hyväksytyt määritykset. Vaikuttaa siis vain näytteisiin joilla on useita määrityksiä. | ||
123 | * **Only with picture**: hakee vain näytteet, joihin on liitetty kuva | ||
124 | * **Only type specimens**: hakee vain näytteet, jotka on merkitty tyyppinäytteiksi | ||
125 | * **By location**: maapallonappia klikkaamalla pääsee tekemään haun kartalla (piste + säde). Haku kohdistuu niihin näytteisiin, joilla on koordinaatit Kotkan ymmärtämässä muodossa. | ||
126 | |||
127 | ===== Filter facets ===== | ||
128 | |||
129 | Alemmaksi vasempaan palstaan tulee näkyville tilastoja hakutuloksista. Näytettävät kentät voi valita hammasratas-ikonin kautta (ks. edempänä). | ||
130 | |||
131 | Kentistä näytetään yleisimmät niihin kirjatut sisällöt. Kutakin riviä klikkaamalla hakutuloksia voi rajata näiden mukaan. Rajauksen voi poistaa punaisesta ruksista. Tämän logiikka selviää parhaiten kokeilemalla! | ||
132 | |||
133 | === Monipuolisia hakuehtoja === | ||
134 | |||
135 | AND-, OR- ja NOT-hakuja voi myös yhdistellä määrittelemällä sulkujen avulla mitkä niistä liittyvät toisiinsa. Tällaiset haut pitää kirjoittaa itse, sillä Kotka ei osaa täydentää sulkuja. | ||
136 | |||
137 | * **leg: "Heikkinen, Mikko" AND (municipality: "Espoo" OR municipality: "Asikkala")** (% style="color: rgb(0,0,0);" %)((%%)[[linkki>>url:https://kotka.luomus.fi/specimens/search?q=leg:%20%22Heikkinen,%20Mikko%22%20AND%20(municipality:%20%22Espoo%22%20OR%20municipality:%20%22Asikkala%22)||shape="rect"]](% style="color: rgb(0, 51, 102); color: rgb(0, 0, 0)" %))(%%) - 153 tulosta: hakee Mikko Heikkisen keräämät näytteet Espoosta ja Asikkalasta | ||
138 | * **(leg: "Heikkinen, Mikko" AND municipality: "Espoo") OR municipality: "Asikkala"** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=(leg:%20%22Heikkinen,%20Mikko%22%20AND%20municipality:%20%22Espoo%22)%20OR%20municipality:%20%22Asikkala%22||shape="rect"]]) - 604 tulosta: hakee Mikko Heikkisen keräämät näytteet Espoosta sekä kaikkien keräämät näytteet Asikkalasta | ||
139 | * **country: "Finland" AND NOT (municipality: "Helsinki" OR municipality: "Espoo")** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=country:%20%22Finland%22%20AND%20NOT%20(municipality:%20%22Helsinki%22%20OR%20municipality:%20%22Espoo%22)||shape="rect"]]) - näytteet Suomesta, paitsi Helsingistä ja Espoosta | ||
140 | |||
141 | Sanan voi merkitä pakolliseksi myös plusmerkillä (+) ja kielletyksi miinusmerkillä (-) | ||
142 | |||
143 | * **+mountain +forest -meadow -dry** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=%2Bmountain%20%2Bforest%20-meadow%20-dry||shape="rect"]]) - näytteessä pitää olla sanat //mountain// ja //forest// mutta ei sanoja //meadow// tai //dry//. | ||
144 | * **mountain AND forest NOT (meadow OR dry)** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?accepted=1&q=mountain%20AND%20forest%20NOT%20%28meadow%20OR%20dry%29&sortBy=documentQName&sortDirection=ASC||shape="rect"]]) - tämä vastaa edellistä hakua | ||
145 | |||
146 | Samankaltaisia sanoja voi hakea jättämällä lainausmerkit pois hakusanan ympäriltä ja lisäämällä tilde-merkin (~~) hakusanan perään. | ||
147 | |||
148 | * **municipality: Helsinki~~** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=municipality: Helsinki~~&sortBy=documentQName&sortDirection=ASC||shape="rect"]]) - palauttaa näytteet joissa kunnan nimessä on esim. sana //Helsingin// tai //Helsinge// (huomaa, että hakuehto ei ole lainausmerkeissä) | ||
149 | * **municipality: Helsinki~~ AND NOT municipality: "Helsinki"** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=municipality:%20Helsinki~~%20AND%20NOT%20municipality:%20%22Helsinki%22||shape="rect"]]) - palauttaa näytteet joissa kunnan nimi on melkein, mutta ei täsmälleen Helsinki. Tällä voi esim. etsiä kirjoitusvirheitä. | ||
150 | |||
151 | (% class="_mce_tagged_br" %) | ||
152 | Hakusanan voi katkaista asteriskilla * ja tuntemattoman kirjaimen voi korvata kysymysmerkillä ?, kunhan jättää lainausmerkit pois hakusanan ympäriltä. | ||
153 | |||
154 | * **leg: ?ahlberg** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=leg:%20?ahlberg&sortBy=documentQName&sortDirection=ASC||shape="rect"]]) - palauttaa näytteet, joissa kerääjänä esim. //Sahlberg//, //Dahlberg// tai //Wahlberg//. | ||
155 | * **leg: Sahlb*** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=leg: Sahlb*&sortBy=documentQName&sortDirection=ASC||shape="rect"]]) - palauttaa näytteet, joiden kerääjän nimi alkaa //Sahlb // | ||
156 | |||
157 | Aksenttimerkkejä ei huomioida haussa, paitsi kirjaimissa å, ä ja ö. | ||
158 | |||
159 | * **country: "Sao Tome"** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=country:%20%22Sao%20Tome%22||shape="rect"]]) - palauttaa myös näytteet, joissa maan nimessä on //São Tomé//. | ||
160 | * **municipality: "Aanekoski"** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=municipality:%20%22Aanekoski%22||shape="rect"]]) - **ei** palauta näytteitä Äänekoskelta | ||
161 | |||
162 | Päivämääräkentistä voi tehdä aikavälihakuja. Näillä kentillä haettaessa Kotka avaa automaattisesti kalenterin, josta voi valita alku- ja loppupäivämäärän ja -kellonajan. Asteriskilla (*) voi jättää päivämäärän vapaaksi | ||
163 | |||
164 | * **dateCreated: [2015-09-28T00:00:00 TO 2015-10-04T00:00:00]** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=dateCreated:%20%5B2015-09-28T00:00:00%20TO%202015-10-04T00:00:00%5D||shape="rect"]]) | ||
165 | * **dateBegin: [2015-01-01 TO *]** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=dateBegin:%20%5B2015-01-01%20TO%20*%5D||shape="rect"]]) - näytteet jotka kerätty 1.1.2015 tai sen jälkeen | ||
166 | |||
167 | Voit myös hakea näytteitä, joista puuttuu tai joissa on tietty tieto mukana. | ||
168 | |||
169 | * **NOT //_//exists_: "municipality"** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=NOT%20_exists_:%20%22municipality%22||shape="rect"]]) näytteet, joihin ei ole kirjattu kunnan nimeä (huom. aiempi hakutermi _missing_: "" ei enää toimi!) | ||
170 | * **_exists_: "municipality"** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=_exists_:%20%22municipality%22||shape="rect"]]) - näytteet, joihin on kirjattu kunnan nimi | ||
171 | |||
172 | Kuvien määrällä voi hakea ja tilastoida pictureCount-kentän avulla. **HUOM:** Tämä kenttä huomioi vain Luomuksessa tallennetut kuvat. Kaikissa Digitariumin digitoimissa kuvissa tämän kentän arvo on 1. | ||
173 | |||
174 | * **pictureCount: [4 TO *]** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=pictureCount:%20%5B4%20TO%20*%5D||shape="rect"]]) - näytteet, joissa on kuvia neljä tai enemmän | ||
175 | * **pictureCount: "3"** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=pictureCount:%20%223%22||shape="rect"]]) - näytteet, joissa on tasan kolme kuvaa | ||
176 | |||
177 | Erikoismerkkejä voi hakea ns. raw-kentistä: | ||
178 | |||
179 | * **taxon.raw: *\.*** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=taxon.raw:%20*.*||shape="rect"]]) - näytteet, joiden taksoninimessä on piste. | ||
180 | * **taxon.raw: *\(* OR taxon.raw: *\)* OR taxon.raw: *\.* OR taxon.raw: *\?* OR taxon.raw: *\/*** ([[linkki>>url:https://kotka.luomus.fi/specimens/search?q=taxon.raw:%20*%5C(*%20OR%20taxon.raw:%20*%5C)*%20OR%20taxon.raw:%20*%5C.*%20OR%20taxon.raw:%20*%5C?*%20OR%20taxon.raw:%20*%5C/*||shape="rect"]]) - näytteet, joiden taksoninimessä on sulkumerkki, piste, kysymysmerkki tai kauttamerkki | ||
181 | |||
182 | |||
183 | |||
184 | Lisää ohjeita monipuolisempiin hakuihin löytyy [[Elastic-hakukoneen ohjeesta, kohdasta //Query String syntax//.>>url:https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-query-string-query.html#query-string-syntax||style="line-height: 1.42857;" shape="rect"]] | ||
185 | |||
186 | |||
187 | |||
188 | |||
189 | |||
190 |