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/alvin/oai?verb=Identify
Hämtar grundläggande information om arkivet, som dess namn, URL och protokoll-version.
Observera att Alvin inte stödjer deleted records varför selektiv hämtning via tidsstämplar inte är möjlig. För att uppdatera en samling poster till aktuell status måste alltid en fullständig omhämtning av alla poster göras. Borttagna poster kommer då att försvinna från resultatet.
ListMetadataFormats
https://www.alvin-portal.org/alvin/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
<dc:relation> URL till tumnagel som visas i träfflistan
ListSets
https://www.alvin-portal.org/alvin/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
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/alvin/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/alvin/oai?verb=ListIdentifiers&metadataPrefix=oai_dc
Som ListRecords men hämtar endast headers (identifikator, set och datumstämpel), inte de fullständiga metadataposterna.
