Swepub BIBFRAME

Informationsmodellen i Swepub är baserad på det länkade dataformatet BIBFRAME 2.0 (Bibliographic Framework Initiative).

BIBFRAME utvecklas av Library of Congress. Swepub BIBFRAME är en modifikation av formatet så som det används av Libris, så kallad KBV (KB:s basvokabulär Länk till annan webbplats.). Formatet är fortfarande under utveckling på Library of Congress och KB. Detta innebär att det kommer att ske mindre förändringar även i Swepub BIBFRAME.

Swepub BIBFRAME i JSON

Datadumparna från Swepubs bibliometritjänst är strukturerade i Swepub BIBFRAME enligt formatet JSON Lines. Strukturen i Swepub BIBFRAME beskrivs här med de egenskaper som förekommer i data, med vilka värden de förekommer och hur ofta.

Så här beskrivs egenskaperna i Swepub BIBFRAME

Här visas hur tabellerna för Swepub BIBFRAME i JSON är strukturerade.

Property

Egenskap som beskriver såväl resursens karaktäristika som relationer mellan resurser. Det förekommer 18 övergripande properties i Swepub BIBFRAME.

JSON type

Beskriver hur innehållet i propertyn är strukturerat i ett JSON-dokument.

Definition

Beskrivning av propertyn.

Subproperties

Underliggande properties som i sin tur kan ha ytterligare subproperties.

Värden

Värden består av antingen fria eller fasta värden. Fasta värden i sin tur kan bestå av antingen textsträngar eller URI:er som länkar till en definition av värdet. Swepubspecifika värden består ofta av URI:er till id.kb.se.

Förekomst

Beskriver hur ofta propertyn kan förväntas att finnas med. Observera att förekomsten av subproperties beskriver hur ofta subpropertyn kan förväntas att finnas med i relation till den övergripande propertyn.

Properties

@context


JSON type:

String.

Definition:
Används för att definiera termerna som används i ett JSON-dokument.

Subproperties:
-

Värden:
https://id.kb.se/context.jsonld.

Förekomst:
Alltid.

@id


JSON type:

String.

Definition:
Postens identifikator hos datakällan. Högst upp anges den sammanslagna postens id (master) följd av de bidragande posterna och deras id:n (publications). 

Subproperties:
-

Värden:
Ser olika ut beroende på datakällan. Exempel: oai:DiVA.org:liu-94605.

Förekomst:
Alltid.

@type


JSON type:

String.

Definition:
I BIBFRAME 2.0 organiseras typen av information i tre huvudsakliga abstraktionsnivåer, så kallade kärnklasser, Verk, Instans och Exemplar. I Swepub beskrivs endast själva verket och dess instanser, inte exemplar.

Subproperties:
-

Värden:
Instance.

Förekomst:
Alltid.

instanceOf


JSON type:

Object.

Definition:
Instans av Verk. Verk som den beskrivna instansen manifesterar. Används för att koppla ihop instanser med Verk i en Bibframe-struktur.

Subproperties:
@type, genreForm, language, hasTitle, summary, contribution, subject, hasNote, status. 

Värden:
Se Subproperties av instanceOf för värden.

Förekomst:
Alltid.

Subproperties av instanceOf

identifiedBy


JSON type:

Array.

Definition:
Resursens identifikator. Teckensträng knuten till en resurs som används för att unikt särskilja resursen från andra. 

Subproperties:
@type, value, source, qualifier. 

Värden:
Se Subproperties av identifiedBy för värden.

Förekomst:

  • URI: Alltid.
  • DOI: Ofta.
  • ISBN, PMID, ISI, ScopusID: Ibland.
  • Andra typer av identifikatorer: Mer sällan.

Subproperties av identifiedBy

indirectlyIdentifiedBy


JSON type:

Array.

Definition:
En identifikator som indirekt är knuten till resursen, till exempel identifikator på annat format.

Subproperties:
@type, value, qualifier. Se Subproperties av identifiedBy för ytterligare information. 

Värden:
ISBN.

Förekomst:
Ibland.

incorrectlyIdentifiedBy


JSON type:

Array.

Definition:
En identifikator som är inkorrekt använd för resursen. Identifikatorn i sig kan vara korrekt, ogiltig i formatet, eller indragen. Denna relation används för att klargöra att den inte går att använda för unik identifiering av resursen. Identifikatorn är antingen angiven som ogiltig i originalposten eller av Swepub efter valideringen. 

Subproperties:
@type, value, qualifier. Se Subproperties av identifiedBy för ytterligare information. 

Värden:
ISBN.

Förekomst:
Sällan.

electronicLocator

(tidigare placering instanceOf)


JSON type:

Array.

Definition:
Information om fulltextlänkar.

Subproperties:
@type, label, hasNote, meta, usageAndAccessPolicy.

Värden:
Se Subproperties av electronicLocator för värden.

Förekomst:
Ofta.

Subproperties av electronicLocator

partOf


JSON type:

Array.

Definition:
Information om relaterad värdpublikation, projekt, event eller dataset. 

Subproperties:
@type, genreForm, contribution, hasTitle, hasInstance, identifiedBy, indirectlyIdentifiedBy, incorrectlyIdentifiedBy, hasNote.  

Värden:
Se Subproperties av partOf för värden.

Förekomst:
Ofta.

Subproperties av partOf

hasSeries


JSON type:

Array.

Definition:
Information om serie som resursen har blivit utgiven i. 

Subproperties:
@type, hasTitle, identifiedBy , indirectlyIdentifiedBy, incorrectlyIdentifiedBy.   

Värden:
Se Subproperties av hasSeries för värden.

Förekomst:
Ganska ofta.

Subproperties av hasSeries

meta


JSON type:

Object.

Definition:
Administrativa metadata om datakällan.

Subproperties:
@type, assigner, creationDate, changedDate, sourceConsulted.   

Värden:
Se Subproperties av meta för värden.

Förekomst:
Alltid.

Subproperties av meta

carrierType


JSON type:

Object.

Definition:
Information om bärartyp.

Subproperties:
@type, label, source.

Värden:
Se Subproperties av carrierType för värden.

Förekomst:
Ofta.

Subproperties av carrierType

publication

(publication ingick tidigare i provisionActivity)

JSON type:
Array.

Definition:
Information om utgivningen.

Subproperties:
@type, agent, place, date.   

Värden:
Se Subproperties av publication för värden.

Förekomst:
Alltid för publicerade verk.

Subproperties av publication

provisionActivity

(Här ingick tidigare även utgivningsinformation som nu ligger under publication)

JSON type:
Array.

Definition:
Information om tillgängliggörandet av verket.

Subproperties:
@type, startDate, date.   

Värden:
Se Subproperties av provisionActivity för värden.

Förekomst:
Sällan.

Subproperties av provisionActivity

usageAndAccessPolicy

(Används för poster där det inte kan härledas om fulltextlänkar och information om åtkomst är kopplade till samma objekt. För poster där informationen kan härledas används usageAndAccessPolicy under electronicLocator.)


JSON type:

Array.

Definition:
Villkor för användning och åtkomst.

Subproperties:
@type, @id, label, endDate. 

Värden:
Se Subproperties av usageAndAccessPolicy för värden.

Förekomst:
Ofta.

Subproperties av usageAndAccessPolicy

dissertation


JSON type:

Array.

Definition:
Information om datum för tillgängliggörande av avhandling.

Subproperties:
@type, startDate.

Värden:
Se Subproperties av dissertation för värden.

Förekomst:
Sällan.

Subproperties av dissertation

extent


JSON type:

Array.

Definition:
Information om omfång.

Subproperties:
@type, label.

Värden:
Se Subproperties av extent för värden.

Förekomst:
Ibland.

Subproperties av extent

license


JSON type:

Array.

Definition:
Information om licens.

Subproperties:
@id, @type, startDate.

Värden:
Se Subproperties av license för värden.

Förekomst:
Ibland. På poster som har blivit berikade med information om länk till licens från den externa datakällan Crossref.

Subproperties av license