Johdanto

Suosittelemme SRU-protokollan toteuttamista uusien tietokantojen saamiseksi mukaan Nelli-hakuun. Kun tietokanta tukee SRU:ta, voidaan sitä käyttää tarvittaessa muuallakin kuin Nellissä. Tässä kuvataan Nellin edellytykset SRU-toteutuksen suhteen. Varsinainen protokollan dokumentaatio, johon suosittelemme tutustumaan, löytyy Kongressin kirjaston SRU-sivuilta.

SRU:n lisäksi Nellissä voidaan käyttää Z39.50-protokollaa, erilaisia XML-rajapintoja tai yksittäistä aineistoa varten toteutettua rajapintaa. Lisäksi on mahdollista haravoida materiaali Nellin omaan tietokantaan OAI-PMH -protokollalla. Lisätietoja eri mahdollisuuksista saa Nelli-toimistosta (nelli-toimisto at helsinki piste fi).

SRU on nykyaikainen protokolla, jonka toteuttaminen on huomattavasti helpompaa kuin esim. perinteisen Z39.50-protokollan. Tässä esimerkki SRU-hausta HELKA-tietokannasta:

http://linnea1.linneanet.fi:7590/voyager?version=1.1&operation=searchRetrieve&startRecord=1&maximumRecords=10&recordSchema=marcxml&query=%22kissa%22+and+%22koira%22

SRU-kyselyn parametrit

Alla on kuvattu lyhyesti Nellin kannalta olennaiset SRU-protokollan parametrit.

Kaikille toiminnoille yhteiset parametrit:

searchRetrieve-toiminnon parametrit:

Hakuehdot

SRU:ssa käytetään CQL-kyselykieltä. Nellissä on käytössä oletuksena sanahaku ja se käyttä vain osaa CQL-kielen ominaisuuksista. Jos käyttäjä kirjoittaa hakukenttään useita hakusanoja, tehdään haku kaikilla sanoilla niin, että niiden väliin lisätään and-operaattori. Haku tehdään fraasina vain, jos hakusanat on kirjoitettu lainausmerkkien sisään. Esimerkkejä:

Tarkennetussa haussa on käytettävissä kaksi hakukenttää ja niiden boolen-operaattori "JA", "TAI" tai "EI". Esimerkkejä:

Hakuehtojen katkaisu tapahtuu tähtimerkillä. Esimerkkejä (Nellissä katkaisumerkkinä toimii kysymysmerkki):

Kaikkien kenttien (kuten yllä) lisäksi haku voidaan kohdistaa myös aiheeseen, nimekkeeseen, tekijään, ISSN-tunnukseen, ISBN-tunnukseen tai vuoteen. Oletuksena hakuindeksit mapataan Nellissä seuraavasti:

Esimerkkejä hauista:

Mappauksia voidaan muokata aineistokohtaisesti, tai ne voidaan määritellä automaattisesti explain-kyselyn antamien tietojen perusteella.

Tietuemuodot

Ilmaisuvoimansa takia suositeltava tietuemuoto on MARCXML. Riippuu kuitenkin aineistosta, miten helppoa sisällön esittäminen MARCXML-muodossa on. MARCXML sisältää MARC 21 -formaatin mukaiset kentät. Suomenkielisestä MARC 21 -oppaasta (bibliografiset tiedot) löytyvät tarkemmat tiedot kenttien sisällöstä. Esimerkkitietue:

Vaihtoehtona on Dublin Core, jonka muodostaminen on helpompaa, mutta tietosisältö rajoittuneempi. Esimerkkitietue:

Linkitys

Jotta käyttäjä voisi päästä tarvittaessa Nellistä aineiston omaan käyttöliittymään eli natiiviliittymään, pitäisi tietueissa olla joko valmiit linkit tai yksilöivät tunnisteet, joiden perusteella Nelli voi luoda linkit. Linkkien tai tunnisteiden muodolle ei ole erityisiä rajoituksia. MARCXML-muotoisissa tietueissa käytetään tyypillisesti 001-kenttää tietueen identifikaationumeron tallentamiseen. Dublin Core -muodossa identifikaationumero löytyy tyypillinen identifier-kentästä.

Autentikointi ja tilastointi

Tarvittaessa haun autentikointiin voidaan käyttää HTTP-autentikaatiota tai erikseen sovittua metodia. Hakujen tilastointia helpottavat organisaatiokohtaiset tunnukset tai hakuosoitteet. Koska Nellissä kaikki haut tulevat samasta IP-osoitteesta organisaatiosta riippumatta, ei IP-osoitetta voida käyttää tilastoinnissa organisaation tunnistamiseen.

Katso myös: