OpenSearch-, RSS- ja ATOM-feedit Kansalliskirjaston julkaisuarkistoissa

Transkriptio

1 OpenSearch-, RSS- ja ATOM-feedit Kansalliskirjaston julkaisuarkistoissa OpenSearch-rajapinta Indeksoitu metadata Hyödyllisiä linkkejä Syötteiden tilaukset kokoelmittain tai koko arkistosta (rss 2.0 ja atom 1.0) OpenSearch-rajapinta OpenSearch-rajapinnan avulla voidaan hakea URL:ään upotettujen Lucene-hakusyntaksilla tehtyjen hakujen mukaisia kyselyjä ja vastaus saadaan XML: nä. OpenSearch korvaa aiemmin käytössä olevaa SRU-rajapintaa, jota ei valitettavasti enää tueta Dspacessa. Toisaalta OpenSearch on SRU:ta monipuolisempi hakujen osalta. OpenSearch -rajapinnan kautta julkaisuarkistossa tehtyjen hakujen tuloksia saa vastauksena RSS- tai Atom-syötteinä, joiden avulla julkaisuista on mahdollista tehdä automaattisesti päivittyviä listauksia esim. omille kotisivuille, muodostaa hakuja RSS-readereiden käyttöön yms. Kansalliskirjaston DSpace-arkistoihin on lisätty syötemuotoisten vastausten lisäksi kk-formaatti, jolla OpenSearch haut saa XML-muodossa, jossa on tulostietueiden kaikki saatavilla oleva metadata näkyvillä. Ohessa OpenSearchin syntaksin esittelyä tarkemmin Doria-julkaisuarkistoon kohdistuvien hakuesimerkkien avulla. Myös muiden Kansalliskirjaston ylläpitämien arkistojen haettavissa oleva metadata on listattu tällä ohjesivulla.

2 OpenSearchin käyttöesimerkki: Tilataan MPKK:n kokoelmiin kohdistetun haun "sukellusvene" -hakutulokset RSS-syötteenä: /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. :sitäjatätä. Sulkujen käyttöä ei kannata säästellä monimutkaisemmissa booleanhauissa. sort_by-parametrilla voi järjestää syötteen seuraavasti: 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. format-parametri voi olla joko atom, rss tai kk. Kk on Kansalliskirjaston omatekemä formaatti, jolla palauttaa kaikki julkisesti saatavilla olevat metadatadatat tulostietueista. scope-parametrilla voi rajoitta haun tiettyyn kokoelmaan tai yhteisöön, arvoksi annetaan handle. Jos scopea ei määritellä, haku kohdistuu koko Dspace-arkistoon. Tässä pari hakuesimerkkejä Doriasta. Haku voi olla myös fraasi: sota" &sort_by=3&order=desc&start=0&rpp=50&format=atom&scope=10024/72633 MPKK:n julkaisemia koptereita tai panssarivaunuja käsitteleviä artikkeleita RSS-feedinä: AND (:helikopteri* OR :panssariv*)&start=1&rpp=100&format=rss kk-formaattia: AND (:israel OR : palestiina)&start=1&rpp=100&format=kk Yksi tapa käyttää Open Search kyselyitä on siis integroida tuloksena saatavien RSS-, Atom- tai xml-muotoinen tieto osaksi omia kotisivuja. Tässä kohtaa on hyödyllistä kuitenkin huomata, että koska Open Searchin tuottama RSS-, Atom tai xml-muotoinen tieto ei sisällä html-muotoilutietoja, pitää syötteiden halutusta ulkoasusta huolehtia websivuston puolella. Tämän toteutus riippuu kotisivujen ylläpitoon käytetystä ohjelmistosta. Indeksoitu metadata Toiveita indeksoitavista kentistä voi esittää meille ja niitä lisätään harkinnan mukaan. Tällä hetkellä ylläpidossamme olevissa julkaisuarkistoissa on seuraavat indeksit: Doria ( alias aliasta vastaavat dublin

3 dc.contributor. dc..* dc.relation.* dc..* dc..issued dc..* dc..* dc.contributor.dis dc.contributor.prt input dc..accessioned yomatrikke li doria.relation.yomatrikkeli tyyppi dc..* series dc.relation.ispartofseries mainwork dc.relation.ispartof publisher dc.publisher.* rights dc.rights.* format dc.format.* programme dc.programme issuedrange dc..issued: dc..available: strategy dc..lutstrategy Theseus (publications.theseus.fi) ta vastaavat dublin dc.description. dc..issued dc.contributor. dc..* dc..* dc..* dc..* ontasot dc..ontasot organization dc.organization programme dc.programme

4 orientation dc.orientation available dc..available dc..* tyyppi dc..* rights dc.rights.* issuedrange dc..issued: dc..available: Julkari ( ) ta vastaavat dublin dc..* dc..issued publisher dc.publisher dc..* dc dc..* dc..* dc..* dc.contributor. description publishingpla ce dc.x-cityofpublication size dc.format.size images dc.relation.images attachments dc.relation.attachments series dc.relation.ispartof dc.description. tero dc..tero unit dc.unit.* dc..* projectid dc.projectid svtstatus dc.svtstatus svtlink dc.svtlink dataretrieval method dc.dataretrievalmethod productid dc.productid productinfo dc.productinfo available dc..available input dc..accessioned contributor dc.contributor.*

5 sourcemetad ata dc.source.metadata organization dc.organization series dc.relation.ispartofseries issued-range dc..issued: dc..available: inputrange dc..accessioned: journalnumb er dc.journal.number Tampub (tampub.uta.fi) ta vastaavat dublin dc..* dc.relation.ispartof dc.contributor. dc.contributor.tayperson year dc..issued _ dc.description. _ dc. series_journal dc.seriesname series_journal dc.seriesname.electronic series_journal dc.journal. dc..isbn dc.relation.issnprinted dc..issn dc.relation.isformatof dc..iso school_faculty_ dc.administrativeunit school_faculty_ dc.faculty school_faculty_ dc. dc..study dc.. degreeprogramme discipline dc..okm _ dc.description input dc..accessioned

6 publisher issued-range available-range dc.publisher dc..issued: dc..available: Jukuri (jukuri.mtt.fi) organisati on organisati on hankenu mero mttperson journal number volume lukeperson metlapers on ta vastaavat dublin dc.contributor. dc..* dc.relation.* dc..* dc..issued dc..* dc..* dc.contributor.dis dc.contributor.prt dc.contributor dc.contributor.other dc.teh dc.mttperson dc.relation.journal dc.relation.journalnumber dc.relation.journalvolume dc.lukeperson dc.metlaperson Fennougrica (fennougrica.kansalliskirjasto.fi) ta vastaavat dublin dc.contributor. dc..* dc.relation.*

7 dc..* dc..issued dc..* dc. dc.contributor.dis dc.contributor.prt iso dc..iso journal available issuedrange dc..journal dc..available dc..issued: dc..available: Hyödyllisiä linkkejä Syötteiden tilaukset kokoelmittain tai koko arkistosta (rss 2.0 ja atom 1.0) Esimerkkinä Koko arkiston RSS-feedien haku rss:nä ja atomina: Haun kohdistaminen tiettyyn kokoelmaan tai yhteisöön (käytä yhteisön/kokoelman handlea) Haku palauttaa niin monta työtä kuin DSpace-arkistossa on määritelty. Tulokset ovat uutuusjärjestyksessä kentän dc..accessioned mukaan.dspacen feedit on kuitenkin huomattavasti rajoittuneempia verrattuna Open Search-rajapinnan käyttöön. Sen tulokset riippuvat kokoelmarakenteesta (hakuja voi tehdä vain joko koko arkistoon, tiettyyn yhteisöön tai kokoelmaan). Lisäksi saatavien tulosten määrä riippuu DSpace-arkiston konfiguraatiosta eikä ole käyttäjän määriteltävissä. DSpacen Open Search -rajapinta on tässä suhteessa paljon monipuolisempi, ja sillä on mahdollista tuottaa esim. verkkosivuille päivittyviä uutuuslistoja aineistosta myös metadatasta tehtävien hakujen pohjalta,eli se ei ole sidoksissa kokoelmarakenteeseen. Tämän lisäksi open searchin avulla käyttäjän on mahdollista määritellä feedissä kerralla näkyvien tietuiden määrä käyttäen rpp-parametria. humanistinen&start=0&sort_by=3&order=desc&rpp=50&format=rss