Gå til indhold

DBC OAI Repo

Denne vejledning beskriver, hvordan der fra DBC OAI Repo kan høstes bibliografiske poster fra databrønden ved brug af OAI-PMH-standarden. Servicen er særligt anvendelig for systemadministratorer og bibliotekspersonale, der arbejder med dataudtræk og -integration.

Senest opdateret: 11. september 2025

Dokumentation

Den tekniske dokumentation for DBC OAI Repo er tilgængelig på GitHub. Afsnittene nedenfor indeholder en introduktion til de grundlæggende koncepter.

OAI-PMH-standarden er tilgængelig hos Open Archives.

Kontakt DBC DIGITALs kundeservice for mere information om adgang til DBC OAI Repo.

Høstning af poster

Der er tre metoder til at høste poster fra DBC OAI Repo:
  1. ListRecords: Bruges til at hente komplette poster i det ønskede format.
  2. ListIdentifiers: Bruges til at hente kun identifierne (posernes id-numre) uden selve posterne.
  3. GetRecord: Bruges til at hente en specifik post baseret på dens identifier.

Sådan fungerer identifiers

Hver post har en unik identifier bestående af basenummer og faustnummer adskilt af en bindestreg. Eksempel: 870970-23645564, hvor 870970 er basenummer og 23645564 er faustnummer.

Datasæt tilgængelige for høstning

Der kan høstes poster fra fire datasæt:

  1. NAT: Nationalbibliografiske poster (fra base 870970 og 870971).
    • Frit tilgængeligt.
  2. ART: Artikelposter (uden anmeldelser) registreret af DBC (fra base 870971).
    • Frit tilgængeligt.
  3. BKM: Bibliotekskatalogiseringer (fra base 870970).
    • Kræver abonnement.
  4. ONL: Online-materialer registreret som nationalbibliografi eller bibliotekskatalogiseringer (fra base 870970).
    • Kræver abonnement.

For at se en aktuel, komplet liste over datasæt, brug funktionen ListSets i servicen.

Tidsstempler

Hver post i DBC OAI Repo har et tidsstempel, der angiver, hvornår posten senest blev opdateret i repositoriet. Bemærk at dette tidsstempel ikke er identisk med tidsstemplet i selve danMARC2-posten. Enhver ændring af posten, for eksempel opdatering af metadata, vil føre til et nyt tidsstempel i repositoriet.

Eksempel på tidsstempel: 2017-05-16T07:09:06.250734Z

Udleveringsformater

Poster kan udleveres i to formater:

  • Dublin Core: Et simpelt format med basale metadatafelter som titel, ophav og sprog.
    • Følgende felter udleveres – parentes henviser til hvilket felt i danMARC2-formatet data kommer fra:
      • dc.title (titel fra felt 245)
      • dc.creator (ophav/opstilling fra felt 100 og 110)
      • dc.publisher (forlagsoplysninger fra felt 260)
      • dc.contributor (ophav og medvirkende fra felt 700 og 710)
      • dc.date (udgivelsesdato fra felt 008)
      • dc.identifier (identifikatorer fra felt 001 og 021)
      • dc.source (originaltitel fra felt 241)
      • dc.language (sprogkode fra felt 008)
  • danMARC2 MarcXchange: Indeholder rå bibliografiske poster som de er lagret i databrønden.
    • Poster udleveres i overensstemmelse med danMARC2-standarden og DBC DIGITALs praksis.
    • Hoved- og sektionsposter vil desuden inkludere felt 015 med faustnumre på underliggende poster, så disse poster kan høstes med servicens GetRecord-funktion
    • Mere information om MarcXchange.

Udleveringsformat vælges i kaldet til servicen. Brug funktionen ListMetaDataFormats for at få overblik over tilgængelige formater.

Håndtering af relaterede poster

  • Når en bindpost høstes, vil dens tilknyttede hoved- og sektionsposter også blive udleveret i en samlet collection (2-3 records, det vil sige hovedpost, eventuel sektionspost og bindpost)
  • Hvis en hoved- eller sektionspost opdateres, kan dette resultere i, at relaterede bindposter også får et nyt tidsstempel.