Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Kaisu lisätty julkaisuarkistolistaan; pieniä muutoksia (typoja, boldauksia, tarkennus iterointi-kohtaan)

...

Ohessa OpenSearchin syntaksin esittelyä tarkemmin Doria-julkaisuarkistoon kohdistuvien hakuesimerkkien avulla. Ohjeet soveltuvat myös muihin Kansalliskirjaston ylläpitämiin julkaisuarkistoihin eli

Jukuri, Julkari,

...

Kaisu, Lauda, LutPub, Osuva, Taju, Trepo, Theseus, UTUPub, Valto, Fenno-

...

Ugrica, Fragmenta

...

membranea. Korvaa vain https://www.doria.fi -alkuosa jonkin toisen julkaisuarkiston etusivun osoitteella:


Code Block
Julkaisuarkisto/open-search/?query=...

...

Code Block
https://www.doria.fi/open-search/?query=sukellusvene&sort_by=3&order=desc&start=0&rpp=50&format=atom&scope=10024/72633
  • query-parametrin perään voidaan tehdä haku samaan tapaan kuin Dspacessa muutenkin, eli Lucene-hakumoottorin syntaksilla. Voidaan siis esim. kohdistaa haku tiettyyn kenttään hakualiaksien avulla, eli esim. title:sitäjatätä. Julkaisuarkistojemme kenttähakuun tarvittavat aliakset löytyvät täältä. Sulkujen käyttöä ei kannata säästellä monimutkaisemmissa booleanhauissa. 
  • sort_by-parametrilla voi järjestää syötteen seuraavasti: 0 = Relevanssin, 1 = Nimekkeen, 2 = Julkaisuajan, 3 = Syöttöajan mukaan 
  • order-parametrillä voi muuttaa järjestyksen nousevaksi (asc) tai laskevaksi (desc) 
  • start-parametri kertoo, mistä hakutuloksesta aloitetaan näyttäminen. 
  • rpp-parametrillä kerrotaan, kuinka monta tulosta maksimissaan listataan per sivu.
  • format-parametri voi olla joko atom, rss tai kk ja kkf. (kk ja kkf ovat Kansalliskirjaston omatekemiä Kansalliskirjastolla tehtyjä formaatteja, jotka palauttavat kaikki julkisesti saatavilla olevat metadatadatat tulostietueista. Formaateista kkf palauttaa myös tiedostolinkit, esimerkiksi kokotekstien ja kuvien linkit.)
  • scope-parametrilla voi rajoitta rajoittaa haun tiettyyn kokoelmaan tai yhteisöön, arvoksi annetaan kokoelman/yhteisön handle. Jos scopea ei määritellä, haku kohdistuu koko Dspace-arkistoon. 

HUOM! Jotta saat kaikki tulokset, täytyy hakutuloksia iteroidahakuja tehdä useita. Hakutuloksia iteroidaan kasvattamalla start-parametria kasvattamalla sitä  rpp-parametrin verran. Kun tulosjoukko on tyhjä tai pienempi kuin rpp:n arvo, voidaan päätellä, että kaikki tulokset on iteroitu läpi.

...

Haku palauttaa niin monta työtä kuin DSpace-arkistossa on määritelty, määrä vaihtelee neljän ja seitsemän välillä. Tulokset ovat uutuusjärjestyksessä kentän dc.date.accessioned mukaan. Syöteet Syötteet ovat kuitenkin huomattavasti rajoittuneempia verrattuna OpenSearch-rajapinnan käyttöön.  Syöte-hakuja voi rajata vain kokoelmahierarkian perusteella tai kohdistaa ne koko arkistoon. Open Search -rajapinta on tässä suhteessa paljon monipuolisempi, ja sillä ja sillä on mahdollista tuottaa esim. verkkosivuille päivittyviä uutuuslistoja aineistosta myös metadatasta tehtävien hakujen pohjalta, eli se ei ole sidoksissa kokoelmarakenteeseen.