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/oai/oai?verb=Identify

Henter grunnleggende informasjon om arkivet, for eksempel navn, URL og protokollversjon.

ListMetadataFormats

https://www.alvin-portal.org/oai/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

1. Permanent lenke, urn:nbn er spesifisert som url: http://urn.kb.se/resolve?urn=urn:nbn:se:alvin:portal:record-1
2. 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

1. Feltene Omfang og Mål er spesifisert som i postene.
2. 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

ListSets

https://www.alvin-portal.org/oai/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

https://www.alvin-portal.org/oai/oai?verb=GetRecord&identifier=oai:ALVIN.org:1&metadataPrefix=oai_dc

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:

1. 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.
2. 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/oai/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/oai/oai?verb=ListIdentifiers&metadataPrefix=oai_dc

Som ListRecords, men henter bare headers (identifikator, set og datostempling), ikke de fullstendige metadatapostene.