OAI-PMH
Metadata Harvesting (OAI-PMH) er en protokoll utviklet for å samle metadatabeskrivelser av poster i et arkiv, slik at tjenester kan bygges ved hjelp av metadata fra flere arkiver. Metadataposter fra Alvin kan hentes via protokollen. OAI-PMH, Version 2.
Alvins metadataposter er fritt tilgjengelig under Creative Commons CC0.
Protokollen består av seks forskjellige typer forespørsler (verb) som spesifiserer hvilken tjeneste som kalles:
Liste over forespørsler
Identify
https://www.alvin-portal.org/alvin/oai?verb=Identify
Henter grunnleggende informasjon om arkivet, for eksempel navn, URL og protokollversjon.
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
Returnerer en liste over metadataformatene som arkivet kan tilby. Poster fra Alvin kan hentes i basisformatet oai_dc (se spesifikasjon av av kartlegging nedenfor).
Dublin Core kartlagt til Alvins format
<dc:title> Tittel
Spesifisert som Hovedtittel: undertittel hvis undertittel finnes. Alternative titler er ikke spesifisert.
<dc:creator> Opphavsperson
Hvis en person eller organisasjon har rollen som Forfatter. Angitt som: Etternavn, Fornavn Nummer, Tillegg, år eller Organisasjon. Underorganisasjon.
<dc:subject> Emneord
Alle typer emneord i dette elementet unntatt geografiske ord eller steder (autoritetsposter).
<dc:coverage> Stedsnavn
Autoritetspost for sted som emneord eller geografisk emneord.
<dc:description> Beskrivelse
Beskrivelse/sammendrag.
<dc:publisher> Forlag
Forlag (impressum for tidlige trykte bøker)
<dc:contributor> Bidragsyter
Hvis en person eller organisasjon har en annen rolle enn Forfatter. Angitt som: Etternavn, Fornavn Nummer, Tillegg, år eller Organisasjon. Underorganisasjon.
<dc:date> Opprettelsesår/publiseringsår
Oppgitt som i postene, hvis spesifikke år YYYY-YYYY, ellers som fritekst "Vist som"..
<dc:type> Ressurstype
Faste verdier på engelsk i henhold til Library of Congress Resource Types Scheme.
Liste
<dc:identifier> Identifikator
- Permanent lenke, urn:nbn er spesifisert som url: http://urn.kb.se/resolve?urn=urn:nbn:se:alvin:portal:record-1
- Arkivinstitusjon + samling, plassering, hyllemerke. Mangler plassering og hyllemerke, kun navn. F.eks. Uppsala universitetsbibliotek, Waller Ms se-00004.
<dc:language> Språk
Språk, vist som tekst på engelsk, f.eks. English.
<dc:format> Fysisk beskrivelse
- Feltene Omfang og Mål er spesifisert som i postene.
- Digital versjon + type på engelsk, f.eks. Digital, reformatted digital. Bare hvis digitalt format finnes, kan brukes til å identifisere hvilke ressurser som er publisert digitalt.
<dc:rights> Rettigheter
Gjelder digitalt innhold (filer). Angitt på engelsk i henhold til alternativene for Rettigheter
Liste
<dc:relation> URL till tumnagel som visas i träfflistan
ListSets
https://www.alvin-portal.org/alvin/oai?verb=ListSets
Henter arkivets set-struktur som muliggjør gruppering av poster i delsett. Poster fra Alvin kan hentes i begrensede set basert på eierinstitusjonen.
Id-en for setSpec tilsvarer en arkivinstitusjons id i Alvin.
Eksempel: setSpec 3 inneholder alle poster fra Uppsala universitetsbibliotek (alvin-location:3).
GetRecord
Henter en enkelt, individuell metadatapost. Nødvendige parametere angir identifikatoren (identifier) og formatet (metadataPrefix) for metadataene som skal inkluderes i posten.
En post (record) er metadata uttrykt i ett enkelt format. Den identifiseres unikt ved kombinasjonen av den unike identifikatoren til objektet som posten åpnes fra, metadataprefikset som identifiserer metadataformatet til posten, og postens datostempling. XML-kodingen av poster er organisert i følgende deler:
- header - inneholder objektets unike identifikator samt egenskaper som kreves for selektiv henting. Den består av følgende deler:
- identifier - den unike identifikatoren til et objekt i et arkiv
- datestamp - datoen for opprettelse eller endring av posten, som skal brukes til selektiv henting.
- setSpec - set som posten er en del av, som skal brukes til selektiv henting.
- metadata - en enkelt manifestasjon av metadata fra et objekt. Den inneholder et enkelt rotelement, for eksempel oai_dc:dc, med underelementer som tilhører det tilsvarende metadataformatet.
ListRecords
https://www.alvin-portal.org/alvin/oai?verb=ListRecords&metadataPrefix=oai_dc
Henter komplette metadataposter fra arkivet. Hvis antallet hentede poster overstiger 100, returneres en liste over de første 100 postene + et resumptionToken-element på slutten av svaret, som brukes til å fortsette å hente den komplette listen. Ingen andre parametere kan brukes. Hvis resumptionToken mangler, er metadataPrefix en obligatorisk parameter.
ListIdentifiers
https://www.alvin-portal.org/alvin/oai?verb=ListIdentifiers&metadataPrefix=oai_dc
Som ListRecords, men henter bare headers (identifikator, set og datostempling), ikke de fullstendige metadatapostene.
