|
| 1 | +{# |
| 2 | + Copyright (C) 2021 CERN. |
| 3 | + Copyright (C) 2024 KTH Royal Institute of Technology. |
| 4 | + |
| 5 | + Invenio App RDM is free software; you can redistribute it and/or modify it |
| 6 | + under the terms of the MIT License; see LICENSE file for more details. |
| 7 | +#} |
| 8 | +{%- set title = _("Search guide") %} |
| 9 | +{%- extends config.BASE_TEMPLATE %} |
| 10 | + |
| 11 | +{%- block page_body %} |
| 12 | +<div class="ui container mt-25"> |
| 13 | + <h1>Sökguide</h1> |
| 14 | + <p> |
| 15 | + Denna guide förklarar hur man skriver avancerade sökfrågor med hjälp av lättförståeliga exempel. |
| 16 | + </p> |
| 17 | + <h3>Enkel sökning (en eller flera termer)</h3> |
| 18 | + <p> |
| 19 | + <strong>Exempel:</strong> |
| 20 | + <a href="/search?page=1&size=20&q=open%20science" |
| 21 | + ><code>open science</code></a |
| 22 | + > |
| 23 | + </p> |
| 24 | + <p> |
| 25 | + Resultaten kommer att matcha poster som innehåller <em>termerna</em> <code>open</code> |
| 26 | + <em>eller</em> <code>science</code> i <em>något fält</em>. Observera att grundord används, så exempelvis kommer <code>science</code> även att matcha |
| 27 | + <code>sciences</code>. Sökresultaten rankas enligt en algoritm som tar hänsyn till dina söktermer. |
| 28 | + </p> |
| 29 | + <p> |
| 30 | + Du kan kräva att <em>båda termerna är med</em> med hjälp av antingen |
| 31 | + <code>+</code> eller <code>AND</code> operatorn: |
| 32 | + </p> |
| 33 | + <p> |
| 34 | + <strong>Exempel:</strong> |
| 35 | + <a href="/search?page=1&size=20&q=%2Bopen%20%2Bscience" |
| 36 | + ><code>+open +science</code></a |
| 37 | + > |
| 38 | + eller |
| 39 | + <a href="/search?page=1&size=20&q=open%20AND%20science" |
| 40 | + ><code>open AND science</code></a |
| 41 | + > |
| 42 | + </p> |
| 43 | + <p> |
| 44 | + Du kan kräva att en eller flera termer <em>inte är med</em> med hjälp av antingen |
| 45 | + <code>-</code> eller <code>NOT</code> operatorn: |
| 46 | + </p> |
| 47 | + <p> |
| 48 | + <strong>Exempel:</strong> |
| 49 | + <a href="/search?page=1&size=20&q=-open%20%2Bscience" |
| 50 | + ><code>-open +science</code></a |
| 51 | + > |
| 52 | + eller |
| 53 | + <a href="/search?page=1&size=20&q=NOT%20open%20AND%20science" |
| 54 | + ><code>NOT open AND science</code></a |
| 55 | + > |
| 56 | + </p> |
| 57 | + <h3>Frassökning</h3> |
| 58 | + <p> |
| 59 | + <strong>Exempel:</strong> |
| 60 | + <a href="/search?page=1&size=20&q=%22open%20science%22" |
| 61 | + ><code>"open science"</code></a |
| 62 | + > |
| 63 | + </p> |
| 64 | + <p> |
| 65 | + Resultaten kommer att matcha poster som innehåller <em>frasen</em> |
| 66 | + <code>open science</code> i <em>något fält</em>. |
| 67 | + </p> |
| 68 | + <h3>Fältsökning</h3> |
| 69 | + <p> |
| 70 | + <strong>Exempel:</strong> |
| 71 | + <a href="/search?page=1&size=20&q=metadata.title:open" |
| 72 | + ><code>metadata.title:open</code></a |
| 73 | + > |
| 74 | + </p> |
| 75 | + <p> |
| 76 | + Resultaten kommer att matcha poster som innehåller <em>termen</em> <code>open</code> i |
| 77 | + <em>fältet</em> <code>metadata.title</code>. Om du vill söka efter flera termer |
| 78 | + i titeln måste du <strong>gruppera termerna</strong> med parentes: |
| 79 | + </p> |
| 80 | + <p> |
| 81 | + <strong>Exempel:</strong> |
| 82 | + <a href="/search?page=1&size=20&q=metadata.title:(open%20science%29" |
| 83 | + ><code>metadata.title:(open science)</code></a |
| 84 | + > |
| 85 | + </p> |
| 86 | + <p> |
| 87 | + Se <a href="https://inveniordm.docs.cern.ch/reference/metadata/#metadata" |
| 88 | + >InvenioRDM-dokumentationen</a |
| 89 | + > för en fullständig lista över fält du kan söka i. |
| 90 | + </p> |
| 91 | + <h3>Kombinerad enkel-, fras- eller fältsökning</h3> |
| 92 | + <p> |
| 93 | + <strong>Exempel:</strong> |
| 94 | + <a |
| 95 | + href="/search?page=1&size=20&q=%2Bmetadata.title:%22open%20science%22%20-metadata.title:policy" |
| 96 | + ><code>+metadata.title:"open science" -metadata.title:policy</code></a |
| 97 | + > |
| 98 | + eller t.ex. |
| 99 | + <a href="/search?page=1&size=20&q=metadata.title:(-open%20%2Bscience%29" |
| 100 | + ><code>metadata.title:(-open +science)</code></a |
| 101 | + > |
| 102 | + </p> |
| 103 | + <p> |
| 104 | + Du kan kombinera enkel-, fras- och fältsökning för att konstruera avancerade sökfrågor. |
| 105 | + </p> |
| 106 | + <h3>Intervallsökning</h3> |
| 107 | + <p> |
| 108 | + <strong>Exempel:</strong> |
| 109 | + <a |
| 110 | + href="/search?page=1&size=20&q=metadata.publication_date:%5B2017%20TO%202018%5D" |
| 111 | + ><code>metadata.publication_date:[2017 TO 2018]</code></a |
| 112 | + > |
| 113 | + (notera att du måste skriva <code>TO</code> med versaler). |
| 114 | + </p> |
| 115 | + <p> |
| 116 | + Resultaten kommer att matcha alla poster med ett publiceringsdatum mellan 2017-01-01 och |
| 117 | + 2018-01-01 (båda datumen inkluderade). |
| 118 | + </p> |
| 119 | + <p>Observera att partiella datum utökas till fullständiga datum, t.ex.:</p> |
| 120 | + <ul> |
| 121 | + <li>2017 utökas till 2017-01-01</li> |
| 122 | + <li>2017-06 utökas till 2017-06-01</li> |
| 123 | + </ul> |
| 124 | + <p> |
| 125 | + Använd hakparenteser (<code>[]</code>) för <em>inkluderande</em> intervall och |
| 126 | + måsvingar (<code>{}</code>) för <em>exkluderande</em> intervall, t.ex.: |
| 127 | + </p> |
| 128 | + <ul> |
| 129 | + <li> |
| 130 | + <code>[2017 TO 2018}</code> är ekvivalent med |
| 131 | + <code>[2017-01-01 TO 2017-12-31]</code> på grund av datumutökning och exklusivt övre gräns. |
| 132 | + </li> |
| 133 | + </ul> |
| 134 | + <p>Exempel på andra intervall:</p> |
| 135 | + <ul> |
| 136 | + <li> |
| 137 | + <code>metadata.publication_date:{* TO 2017-01-01}</code>: Alla dagar fram till 2017. |
| 138 | + </li> |
| 139 | + <li> |
| 140 | + <code>metadata.publication_date:[2017-01-01 TO *]</code>: Alla dagar från 2017. |
| 141 | + </li> |
| 142 | + </ul> |
| 143 | + <h3>Rankning/Sortering</h3> |
| 144 | + <p> |
| 145 | + Som standard sorteras alla sökningar enligt en intern rankningsalgoritm som poängsätter varje matchning mot din sökfråga. Både i användargränssnittet och REST API är det möjligt att sortera resultaten efter: |
| 146 | + </p> |
| 147 | + <ul> |
| 148 | + <li>Senaste</li> |
| 149 | + <li>Bästa matchning</li> |
| 150 | + <li>Äldsta</li> |
| 151 | + <li>Mest visade</li> |
| 152 | + <li>Mest nedladdade</li> |
| 153 | + </ul> |
| 154 | + <h3>Reguljära uttryck</h3> |
| 155 | + <p> |
| 156 | + Reguljära uttryck är ett kraftfullt mönsterigenkänningsspråk som tillåter dig att |
| 157 | + söka efter specifika mönster i ett fält. Till exempel, om vi vill hitta |
| 158 | + alla poster med DOI-prefixet 10.5281 kan vi använda en sökning med reguljärt uttryck: |
| 159 | + </p> |
| 160 | + <p> |
| 161 | + <strong>Exempel:</strong> |
| 162 | + <a href="/search?page=1&size=20&q=metadata.subjects.identifier:%2F03yrm5c2%5B1%2C6%5D%2F" |
| 163 | + ><code>metadata.subjects.identifier:/03yrm5c2[1,6]/</code></a |
| 164 | + > |
| 165 | + </p> |
| 166 | + <p> |
| 167 | + Var försiktig, det reguljära uttrycket måste matcha <em>hela</em> fältvärdet. |
| 168 | + Se |
| 169 | + <a |
| 170 | + href="https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-regexp-query.html#regexp-syntax" |
| 171 | + >syntax för reguljära uttryck</a |
| 172 | + > |
| 173 | + för ytterligare detaljer. |
| 174 | + </p> |
| 175 | + <h3>Fält som saknar värden</h3> |
| 176 | + <p> |
| 177 | + Det är möjligt att söka efter poster som antingen saknar ett värde eller har |
| 178 | + ett värde i ett specifikt fält med hjälp av <code>_exists_</code> och |
| 179 | + <code>not _exists_</code> i kombination med fältnamn. |
| 180 | + </p> |
| 181 | + <p> |
| 182 | + <strong>Exempel:</strong> |
| 183 | + <a href="/search?page=1&size=20&q=_missing_:metadata.additional_titles" |
| 184 | + ><code>not _exists_:metadata.additional_titles</code></a |
| 185 | + > |
| 186 | + (alla poster utan metadata.additional_titles) |
| 187 | + </p> |
| 188 | + <p> |
| 189 | + <strong>Exempel:</strong> |
| 190 | + <a href="/search?page=1&size=20&q=_exists_:metadata.creators" |
| 191 | + ><code>_exists_:metadata.creators</code></a |
| 192 | + > |
| 193 | + (alla poster med metadata.creators) |
| 194 | + </p> |
| 195 | + <h3>Avancerade söktekniker</h3> |
| 196 | + <h4>Boosting</h4> |
| 197 | + <p> |
| 198 | + Du kan använda boost-operatorn <code>^</code> när en term är mer relevant |
| 199 | + än en annan. Till exempel kan du söka efter alla poster med frasen |
| 200 | + <em>open science</em> i antingen <em>titel-</em> eller |
| 201 | + <em>beskrivnings-</em> fältet, men ranka poster med frasen i |
| 202 | + <em>titel</em> fältet högre: |
| 203 | + </p> |
| 204 | + <p> |
| 205 | + <strong>Exempel:</strong> |
| 206 | + <a |
| 207 | + href="/search?page=1&size=20&q=metadata.title:%22open%20science%22%5E5%20metadata.description:%22open%20science%22" |
| 208 | + ><code>metadata.title:"open science"^5 metadata.description:"open science"</code></a |
| 209 | + > |
| 210 | + </p> |
| 211 | + <h4>Fuzzy-sök</h4> |
| 212 | + <p> |
| 213 | + Du kan söka efter termer som är liknande men inte exakt samma som din sökterm |
| 214 | + med hjälp av fuzzy-operatorn <code>~</code>. |
| 215 | + </p> |
| 216 | + <p> |
| 217 | + <strong>Exempel:</strong> |
| 218 | + <a href="/search?page=1&size=20&q=oepn~"><code>oepn~</code></a> |
| 219 | + </p> |
| 220 | + <p> |
| 221 | + Resultaten kommer att matcha poster med termer liknande <code>oepn</code> vilket |
| 222 | + till exempel även skulle matcha <code>open</code>. |
| 223 | + </p> |
| 224 | + <h4>Närhetssökningar</h4> |
| 225 | + <p> |
| 226 | + En frassökning med <code>"open science"</code> förväntar sig som standard att alla termer |
| 227 | + är i exakt samma ordning, och skulle därmed till exempel inte matcha en post |
| 228 | + som innehåller frasen <em>"open access and science"</em>. En närhetssökning |
| 229 | + tillåter att termerna inte är i exakt följd och kan inkludera andra termer |
| 230 | + emellan. Graden av flexibilitet specificeras av ett efterföljande heltal: |
| 231 | + </p> |
| 232 | + <p> |
| 233 | + <strong>Exempel:</strong> |
| 234 | + <a href="/search?page=1&size=20&q=%22open%20science%22~5" |
| 235 | + ><code>"open science"~5</code></a |
| 236 | + > |
| 237 | + </p> |
| 238 | + <h4>Wildcard-tecken</h4> |
| 239 | + <p> |
| 240 | + Du kan använda wildcard-tecken i söktermer för att ersätta ett enda tecken (med |
| 241 | + <code>?</code> operatorn) eller noll eller fler tecken (med |
| 242 | + <code>*</code> operatorn). |
| 243 | + </p> |
| 244 | + <p> |
| 245 | + <strong>Exempel:</strong> |
| 246 | + <a href="/search?page=1&size=20&q=ope%3F%20scien*" |
| 247 | + ><code>ope? scien*</code></a |
| 248 | + > |
| 249 | + </p> |
| 250 | + <p> |
| 251 | + Wildcard-sökningar kan vara långsamma och bör normalt undvikas om möjligt. |
| 252 | + </p> |
| 253 | +</div> |
| 254 | +{%- endblock page_body%} |
0 commit comments