OAI-PMH
Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) är ett protokoll som utvecklats för att samla in metadatabeskrivningar av poster i ett arkiv så att tjänster kan byggas med hjälp av metadata från flera arkiv. Metadataposter från Alvin kan hämtas via protokollet OAI-PMH, Version 2.
Metadataposter från Alvin är fritt tillgängliga enligt Creative Commons CC0.
Protokollet består av sex olika typer av förfrågningar (verb) som anger vilken tjänst som anropas:
Lista över förfrågningar
Identify
https://www.alvin-portal.org/oai/oai?verb=Identify
Hämtar grundläggande information om arkivet, som dess namn, URL och protokoll-version.
ListMetadataFormats
https://www.alvin-portal.org/oai/oai?verb=ListMetadataFormats
Returnerar en lista över de metadataformat som arkivet kan tillhandahålla. Poster från Alvin kan hämtas i grundformatet oai_dc (se specifikation av mappning nedan).
Dublin Core-mappning mot Alvins format
<dc:title> Titel
Anges som Huvudtitel : undertitel om undertitel finns. Alternativa titlar anges ej.
<dc:creator> Upphovsman
Om person eller organisation har rollen Författare. Anges som: Efternamn, Förnamn Nummer, Tillägg, Årtal eller Organisation. Underorganisation.
<dc:subject> Ämnesord
Alla typer av ämnesord i detta element utom geografiska eller platser (auktoritetsposter).
<dc:coverage> Platsnamn
Auktoritetspost för plats som ämnesord eller geografiska ämnesord.
<dc:description> Beskrivning
Beskrivning/sammanfattning.
<dc:publisher> Förlag
Förlag (impressum för äldre tryck).
<dc:contributor> Bidragsgivare
Om person eller organisation har annan roll än Författare. Anges som: Efternamn, Förnamn Nummer, Tillägg, Årtal eller Organisation. Underorganisation.
<dc:date> Tillkomstår/utgivningsår
Anges som i posterna, om specifika årtal YYYY-YYYY, annars som fritext "Visas som".
<dc:type> Resurstyp
Fasta värden på engelska enligt Library of Congress Resource Types Scheme.
Lista
<dc:identifier> Identifikator
- Permanent länk, urn:nbn anges som url: http://urn.kb.se/resolve?urn=urn:nbn:se:alvin:portal:record-1
- Arkivinst. + samling, placering, signum. Saknas placering och signum endast namn. Ex. Uppsala universitetsbibliotek, Waller Ms se-00004.
<dc:language> Språk
Språk, visas som text på engelska, ex. English.
<dc:format> Fysisk beskrivning
- Fälten Omfång och Storlek anges som i posterna.
- Digital version + typ på engelska, ex. Digital, reformatted digital. Enbart om det finns Digitalt format, kan användas för att identifiera vilka resurser som är publicerade digitalt.
<dc:rights> Rättigheter
Gäller digitalt innehåll (filer). Anges på engelska enligt alternativen för Rättigheter.
Lista
ListSets
https://www.alvin-portal.org/oai/oai?verb=ListSets
Hämtar arkivets set-struktur som möjliggör gruppering av poster i delmängder. Poster från Alvin kan hämtas i begränsade set utifrån ägande institution.
Id för setSpec motsvarar en arkivinstitutions id i Alvin.
Exempel: setSpec 3 innehåller alla poster från Uppsala universitetsbibliotek (alvin-location:3).
GetRecord
https://www.alvin-portal.org/oai/oai?verb=GetRecord&identifier=oai:ALVIN.org:1&metadataPrefix=oai_dc
Hämtar en enskild, individuell metadatapost. Obligatoriska parametrar anger identifikatorn (identifier) och formatet (metadataPrefix) för de metadata som ska inkluderas i posten.
En post (record) är metadata uttryckta i ett enda format. Den identifieras entydigt genom kombinationen av den unika identifikatorn för det objekt från vilket posten är tillgänglig, metadataprefixet som identifierar postens metadataformat samt postens datumstämpel. XML-kodningen av poster är organiserad i följande delar:
- header - innehåller den unika identifikatorn för objektet samt egenskaper som krävs för selektiv hämtning. Den består av följande delar:
- identifier - den unika identifikatorn för ett objekt i ett arkiv
- datestamp - datumet för skapande eller ändring av posten, att användas för selektiv hämtning.
- setSpec - set som posten ingår i, att användas för selektiv hämtning.
- metadata - en enda manifestation av metadata från ett objekt. Den innehåller ett enda rotelement, til exempel oai_dc:dc, med underelement som tillhör motsvarande metadataformat.
ListRecords
https://www.alvin-portal.org/oai/oai?verb=ListRecords&metadataPrefix=oai_dc
Hämtar fullständiga metadataposter från arkivet. Om antalet hämtade poster överstiger 100 returneras en lista över de första 100 posterna + ett resumptionToken-element i slutet av svaret som används för att fortsätta hämtningen av den kompletta listan. Inga andra parametrar kan då användas. Om resumptionToken saknas är metadataPrefix en obligatorisk parameter.
ListIdentifiers
https://www.alvin-portal.org/oai/oai?verb=ListIdentifiers&metadataPrefix=oai_dc
Som ListRecords men hämtar endast headers (identifikator, set och datumstämpel), inte de fullständiga metadataposterna.
