1       Ülevaade

Kivikese andmebaasis on realiseeritud teiste süsteemidega integreerimiseks OAI-PMH v2.0 standardile (vt http://www.openarchives.org/OAI/openarchivesprotocol.html) vastav eksportliides. Selles dokumendis antakse juhised selle liidese häälestamiseks ja kasutamiseks klientsüsteemide poolt.
Repositooriumis on realiseeritud andmekogumite (standardis nn. set) põhine andmete grupeerimine selektiivseks andmete ekspordiks. Lisaks standardis ettenähtud Dublin Core formaadis metaandmestiku esitamisele on võimalik andmeid lugeda ka spetsiaalses Kivikese XML esituses. Viimase eeliseks on täielik Kivikese andmestiku esitamine (Dublin Core kaudu on võimalik lugeda ainult säilikute baasinfot). Lisaks on Kivikese metaandmestiku kaudu võimalik ka elektroonselt säilitatava ainese allalaadimine.
 

2       Andmetele juurdepääs

Kivikese OAI-PMH liides on ligipääsetav järgmise URL kaudu:
 
http://kivike.kirmus.ee/oai
 
Liides realisiseerib OAI-PMH v2.0 standardi põhise repositooriumi, mille abil on võimalik ligi pääseda kogu Kivikese andmebaasile (sõltuvalt liidessüsteemile määratud õigustest). Kliendsüsteemide arendajad peavad kindlasti põhjalikult endale selgeks tegema OAI-PMH standardi põhimõtted, antud dokumendis seda ei käsitleta.
Andmetele ligipääsu ulatus on sõltuvuses klientsüsteemile omistatud juurdepääsuõigustest. Antud URL kaudu on tagatud anonüümne juurdepääs, mille kaudu on tehtud kättesaadavaks anonüümsele kasutajale ligipääsetavad materjalid. Kasutades URLi:
 
http://kivike.kirmus.ee/oai/oai
 
Toimub klientsüsteemi autentimine Basic authentication meetodil. Tulemusena tehakse OAI-PMH liidese kaudu klientsüsteemile kättesaadavaks andmed ulatuses, nagu on seda kirjeldatud Kivikese keskkonnas antud kasutajatunnuse jaoks.
 

3       Metaandmestiku formaadid

Kivikese OAI-PMH liides tagastab verbiga ListMetadataFormats päringu vastuseks järgmised metaandmestiku formaadid:
 
Tunnus XML nimeruum XML Schema fail Kirjeldus
oai_dc http://www.openarchives.org/OAI/2.0/oai_dc/ http://www.openarchives.org/OAI/2.0/oai_dc.xsd Dublin Core’i metaandmestik
kivike http://kivike.kirmus.ee/schema/kivike http://kivike.kirmus.ee/schema/kivike.xsd Kivikese metaandmestik
 
Päringut teostav klientsüsteem peab päringus näitama, millises metaandmestiku formaadis ta infot soovib lugeda.
 

3.1     Dublin Core’i metaandmestik

Dublin Core’i metaandmestiku formaadis esitatakse säilikute kohta järgmine metainfo:
 
Kivikese väli Kivikese välja kood Dublin Core’i kood Dublin Core’i kirjeldus
Failitüüp fyld04 format The file format, physical medium, or dimensions of the resource.
Kasutuspiirang inom03 rights Information about rights held in and over the resource.
Keel sisu03 language A language of the resource.
Märksõna sisu10 subject The topic of the resource.
Sisu kirjeldus sisu44 description An account of the resource.
Asutus skat01 contributor An entity responsible for making contributions to the resource.
Viide skat03 title A name given to the resource.
(Originaal)pealkiri skat05 title  
Modifitseeritud pealkiri skat07 title  
Autor skat08 creator  
Modifitseeritud autor skat09 creator An entity primarily responsible for making the resource.
Ajakate skat10 coverage The spatial or temporal topic of the resource, the spatial applicability of the resource, or the jurisdiction under which the resource is relevant.
 

3.2     Kivikese metaandmestik

Kivikese metaandmestiku formaadis esitatakse säiliku kohta kõik metainfo, mis Kivikeses leidub. Metainfo struktuur on järgmine (väljad on esitatud XPath avaldistena):
 
Väli Kirjeldus
/asi/@pid Asja PID – unikaalne tunnus
/asi/jrk Asja järjekorranumber antud eksportfailis
/asi/alamliik Asja alamliigi numbriline kood (vt Kivikese alamliikide kirjeldust)
/asi/viide Asja viide
/asi/nimi Asja nimetus
/asi/lisanimi Asja täiendav nimi
/asi/hetk Asja registreerimise ajamoment
/asi/olek Asja olek (aktiivne või kustutatud)
/asi/paasupilet Asja juurdepääsupiirangu kood
/asi/paasumarkus Asja juurdepääsupiirangu märkus
/asi/asukoht URL, mille kaudu on kättesaadav asja esitus (failide korral)
/asi/allyksus Asja säilitava arhiivi nimi
/asi/kataloogid
 
               @id
               kataloog
                              @id
Asja kataloogiinfo. Kataloogiinfo on herarhiline, kus iga järgnev element on eelmise vanemelement:
Kataloogi unikaalne ID
Kataloogi nimi
Kataloogi unikaalne ID
/asi/projektid
 
               @id
               projekt
                              @id
Asjaga seoatud projekti info. Projektiinfo on hierarhiline, kus iga järgnev element on eelmise vanemelement:
Projekti unikaalne ID
Projekti nimi
Projekti unikaalne ID
/asi/meta
               tunnus
                              @kood
                              @jrk
Asjaga seotud tunnused:
Tunnuse väärtus
Tunnuse kood
Tunnuse järjekorranumber antud nimekirjas
/asi/tekstistused
               tekstistus
                              @id
                              nimi
                              markus
                              sisestaja
                              sisestus_kuupaev
                              sisu
Asja tekstistused:
 
Tekstistuse unikaalne ID
Tekstistuse nimi
Tekstistuse märkus
Tekstistuse seistaja nimi
Tekstistuse sisestamise kuupäev
Tekstistuse sisu
/asi/alamosad
               asi
Asja alamosad
Asja alamosa on analoogse sturktuuriga, kui asi ise. Alamosa võib ka omakorda sisaldada alamosasid
 
Vt ka metainfo struktuuri kirjelduse XSD faili asukohas:
 
http://kivike.kirmus.ee/schema/kivike.xsd
 

4       Andmekogumid

Kivikese andmebaas on liigendatud andmekogumiteks. Andmekogumeid on võimalik Kivikeses dünaamiliselt juurde kirjeldada vastavalt klientsüsteemide vajadustele. Kui päringutes andmekogumit ei määrata, tagastavad päringud kogu Kivikese säilikute hulga.
Kivikeses hetkel realiseeritud andmekogumite nimekirja saab lugeda repositooriumist verbi ListSets abil.
Klientsüsteemil on mõistlik andmeid lugeda konkreetse(te) andmekogumi(te) baasil, vajadusel leppides Kivikese andmebaasi haldajatega kokku uue sobiva andmekogumi kirjeldamise.