Wiki source code of Hakutoiminto

Last modified by akuusija@helsinki_fi on 2024/02/07 06:51

Show last authors
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