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. OpenSearchin käyttöesimerkki: Tilataan MPKK:n kokoelmiin kohdistetun haun "sukellusvene" -hakutulokset RSS-syötteenä: tart=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. :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),

2 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 (abstract:helikopteri* OR abstract:panssariv*)&start=1&rpp=100&format=rss kk-formaattia: AND (abstract:israel OR abstract:palestiina)&start=1&rpp=100&format=kk

3 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 abstract input yomatrikkeli tyyppi series mainwork publisher rights format programme strategy aliasta vastaavat dc.description.* dc.contributor. dc.creator.* dc.relation.* dc..* dc..* dc.contributor.dis dc.contributor.prt dc.contributor.editor dc..accessioned doria.relation.yomatrikkeli dc.relation.ispartofseries dc.relation.ispartof dc.publisher.* dc.rights.* dc.format.* dc.programme : dc..lutstrategy

4 Theseus (publications.theseus.fi) abstract ontasot organization programme orientation available tyyppi rights ta vastaavat dc.description.abstract dc.contributor. dc..* dc..* dc..* dc..ontasot dc.organization dc.programme dc.orientation dc..available dc.rights.* : Julkari ( publisher dc description publishingplace size images attachments series ta vastaavat dc..* dc.publisher dc..* dc.contributor. dc.description.* dc.x-cityofpublication dc.format.size dc.relation.images dc.relation.attachments dc.relation.ispartof

5 abstract dc.description.abstract tero dc..tero unit dc.unit.* department dc.department.* projectid dc.projectid svtstatus dc.svtstatus svtlink dc.svtlink dataretrievalmethod dc.dataretrievalmethod productid dc.productid productinfo dc.productinfo available dc..available input dc..accessioned contributor dc.contributor.* sourcemetadata dc.source.metadata organization dc.organization series dc.relation.ispartofseries : input-range dc..accessioned: journalnumber dc.journal.number Tampub (tampub.uta.fi) ta vastaavat dublin core kentät dc..* dc.relation.ispartof dc.creator.* dc.contributor. dc.contributor.editor dc.contributor.tayperson year abstract_ dc.description.abstract abstract_ dc. series_journal dc.seriesname series_journal dc.seriesname.electronic series_journal dc.journal.

6 isbn_issn dc..isbn isbn_issn dc.relation.issnprinted isbn_issn dc..issn isbn_issn dc.relation.isformatof dc..iso school_faculty_department dc.administrativeunit school_faculty_department dc.faculty school_faculty_department dc.department dc..study dc..degreeprogramme discipline dc..okm abstract_ dc.description input dc..accessioned publisher dc.publisher : Jukuri (jukuri.mtt.fi) ta vastaavat abstract dc.description.* dc.contributor. dc.creator.* dc.relation.* dc..* dc..* dc.contributor.dis dc.contributor.prt dc.contributor.editor organisation dc.contributor organisation dc.contributor.other hankenumero dc.teh mttperson dc.mttperson journal dc.relation.journal

7 number volume lukeperson metlaperson dc.relation.journalnumber dc.relation.journalvolume dc.lukeperson dc.metlaperson Fennougrica (fennougrica.kansalliskirjasto.fi) abstract iso journal available ta vastaavat dc.description.* dc.contributor. dc.creator.* dc.relation.* dc..* dc. dc.contributor.dis dc.contributor.prt dc.contributor.editor dc..iso dc..journal dc..available : Hyödyllisiä linkkejä Syötteiden tilaukset kokoelmittain tai koko arkistosta (rss 2.0 ja atom 1.0) Esimerkkinä

8 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.d Spacen 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. istinen&start=0&sort_by=3&order=desc&rpp=50&format=rss