Kansalliskirjaston julkaisuarkistoissa on käytössä seuraavat OAI-PMH rajapinnat (esimerkit Doriasta, korvaa www.doria.fi -alku halutulla arkistolla):
- dublin core (haravointiosoite muotoa https://www.doria.fi/oai/request?verb=ListRecords&metadataPrefix=oai_dc)
- qualified dublin core (haravointiosoite muotoa https://www.doria.fi/oai/request?verb=ListRecords&metadataPrefix=qdc)
- kk:n xml-formaatti, joka on qualified dublin coren laajennus sisältäen myös tiedostolinkit ja tietoa kokoelmista (haravointiosoite muotoa https://www.doria.fi/oai/request?verb=ListRecords&metadataPrefix=kk )
- Finnaa varten laadittu formaatti qdc_finna, joka on räätälöity Finnan tarpeisiin (haravointiosoite muotoa https://www.doria.fi/oai/request?verb=ListRecords&metadataPrefix=qdc_finna)
Alla esimerkkinä käytetään KK:n omaa formaattia. Se listaa julkaisuarkiston tiedot 100:n tietueen jaksoissa. ResumptionTokenin avulla voidaan aina hakea seuraava jakso.
Ensimmäiset 100 saadaan seuraavasti: Tämän jälkeen pitää tarkastaa ResumptionTokenin arvo ensimmäisen vastauksen lopusta eli: <resumptionToken expirationDate= "2013-01-23T10:05:47Z" > 0001 - 01 -01T00: 00 :00Z/ 9999 - 12 -31T23: 59 :59Z //kk/100</resumptionToken> ja sen jälkeen seuraavat haetaan haulla, jossa XXX on edellisestä hausta saatu ResumptionTokenin arvo: https: //www.doria.fi/oai/request?verb=ListRecords&resumptionToken=0001-01-01T00:00:00Z/9999-12-31T23:59:59Z//kk/XXXXX Jokaisen haun jälkeen tarkistetaan resumptionTokenin arvo ja seuraava haku tehdään sen avulla, kunnes resumptionToken on tyhjä eli kaikki tulokset on saatu. |
Näin listaat kaikki serverin tukemat OAI-PMH metadataformaatit:
Haravoinnin kohdistaminen tiettyyn yhteisöön (setin edessä com_ -etuliite ennen handlea, handlen /-merkit korvattu _ -merkillä)
https://www.doria.fi/oai/request?verb=ListRecords&metadataPrefix=kk&set=com_10024_lhandlen_loppuosa
Haravoinnin kohdistaminen tiettyyn kokoelmaan (setin edessä col_ etuliite ennen handlea, handlen /-merkit korvattu _ -merkillä)
https://www.doria.fi/oai/request?verb=ListRecords&metadataPrefix=kk&set=col_10024_handlen_loppuosa
Haravoinnin kohdistaminen tiettyyn tietueeseen (esimerkkinä dorian tietue)
Muun arkiston ollessa kyseessä, korvaa molemmat kohdat, joissa doria.fi on mainittu, kyseisen arkiston nimellä.
https://www.doria.fi/oai/request?verb=GetRecord&metadataPrefix=oai_dc&identifier=oai:www.doria.fi:10024/handlen_loppuosa