Krav til metadata

I tillegg til kravet om en metadatafil i informasjonspakkene (SIP), krever Nasjonalbiblioteket at et sett med metadata også leveres via submission-API-et ved avlevering. Dette skal sikre at et minimum av metadata knyttet til de avleverte representasjonene blir indeksert og søkbare.

Metadatakravene våre bygger på Dublin Core, en internasjonal ISO-standard som er mye brukt innen arkiv, bibliotek og digitale samlinger. Dublin Core-standarden ble valgt fordi den er relativt enkel å forstå, lett å implementere, og er både fleksibel og utvidbar. Vi har supplert standarden med attributter for type, rolle og språk i enkelte felt for å gjøre metadataene mer strukturerte.

De fleste metadataelementene er valgfrie, men vi oppfordrer til å fylle dem ut så grundig som mulig. Dette gir bedre søkbarhet og forståelse av ressursene – også i et langtidsperspektiv.

For å gjøre de avleverte pakkene mest mulig selvforklarende i et bevaringsperspektiv, og for å sikre kontroll med filformater, skriver vi i tillegg metadataene til en XML-fil som legges ved arkivpakken (AIP). XML er velegnet for langtidsbevaring. Formatet er åpent, utbredt i bruk og et velkjent utvekslingsformat for metadata. For bevaring er det en fordel at formatet er tekstbasert og lesbart for både maskiner og mennesker.

Generelle retningslinjer for bruk av standarder

Tegnsetting for utfylling av felter følger UTF-8.
ISO 639-2 brukes som standard for å angi språk når attributt lang brukes.
ISO 8601-2 brukes som standard for angivelse av tid/dato.
ISO 3166-2 brukes for angivelse av land.

Metadataelementer

Retningslinjer for bruk:

Tillatte typer for beskrive av ressursen:

Tekst: Bok, Avis, Tidsskrift, Artikkel, Småtrykk, Brev, Epost, Manuskript, Musikkmanuskript, Noter, Programrapport, Programstatistikk.

Bilder: Bilde, Kart, Plakat, Postkort, Referansemateriale.

Lyd: Lydbok, Musikk, Radio.

Levende bilder: Film, Fjernsyn.

Det vil være muligheter for å få lagt til medietyper ved behov.

Eksempel:

{"type":"Bilde"}

Retningslinjer for bruk:

• Eksempler på identifikatorer kan være URN, PID, URI til post i en katalog/metadatasystem, dokID, hefteID, eksemplarnummer, ISBN, ISSN, ISMN, ISNI, DOI, plateetikett etc.

• Det må defineres type identifikator. Bruk av type-attributt bør gi mening for avleverer, gjenspeile metadatakatalog/system, og bruken bør være konsekvent (standardisert skriveform).

Eksempler:

{"identifier": [
  {
    "type": "URN",
    "value": "URN:NBN:no-nb_digifoto_20220311_00191_NB_PE_VM_M_05_09_01_036"
  },
  {
    "type": "bilde-id",
    "value": "NB_PE_VM_M_05_09_01_036"
  },
  {
    "type": "hyllesignatur",
    "value": "POEL00003975"
  }
]}

Retningslinjer for bruk:

• En del ressurser har allerede en forhåndsdefinert tittel, som bøker, tidsskrift, artikler, malte verk, kunstfoto osv. Der tittel mangler er anbefalt praksis å gi ressursen en “meningsbærende” tittel. Med meningsbærende menes noe som gir mening for gjenkjennelse og identifikasjon av ressursen (navn som gir mening for avleverer).

• Språkkode må angis for titler oppgitt på andre språk enn norsk (lang-attributt). ISO 639-2 brukes som standard for å angi språk når attributt lang brukes.

Eksempler:

{"title": {
  "value": "Ola og Kari på fisketur i Rondane",
  "lang": "nor"
}}

{"title": {
  "value": "Negativopptak fra juni 1972 [bilde 394]",
  "lang": "nor"
}}

{"title": {
  "value": "20131007.jpg"
}}

Retningslinjer for bruk:

• For å bedre muligheter for søk på tittel anbefales det å legge til alternativ tittel der tittelen inneholder tall og/eller spesialtegn, eller der tall opprinnelig er skrevet som tekst. Eksempler:
  title: 1-2-3 Matematikk = alternative: en to tre matematikk.
  title: Kari & Bjarne på fisketur = alternative: Kari og Bjarne på fisketur.
  title: Tusen fjelltopper = alternative: 1000 fjelltopper.

• Det kreves forklaring til hvilken type tittel som oppgis. Bruk av type-attributt bør gi mening for avleverer, gjenspeile metadatakatalog/system, og bruken bør være konsekvent (standardisert skriveform).

• Bruk av lang-attributt. ISO 639-2 brukes som standard for å angi språk når attributt lang brukes.

Eksempel:

{"alternative": [
  {
    "type": "original tittel",
    "value": "Ola and Kari on fishing trip in Rondane",
    "lang": "eng"
  }
]}

Retningslinjer for bruk:

• Det anbefales bruk av autoritetsregister i de tilfeller dette finnes, både for personnavn og korporasjoner. Det må oppgis hvilket autoritetsregister som er benyttet. Et eksempel på autoritetsregister er Felles autoritetsregister for personer og korporasjoner.

• Creator identiseres i tillegg ved å skrives ut i sin fulle form (navn, etternavn/korporasjon). Fødselsår - dødsår kan legges til bak navnet i parentes. Eksempler: Nesbø, Jo (1960- ), Shakespeare, William (1564-1616).

• Det bør oppgis om det er snakk om personnavn eller korporasjon. Dette er løst på ulike måter i ulike metadatakataloger og autoritetsregistre. Foreløpig er disse verdiene tillat for angivelse av navn/korporasjon (type), men det er mulig å få lagt til flere typer ved behov: Person, Organization, Personal Name, Corporate Name, Meeting Name (konferanse), Uniform Title (traktat, kontrakt).

• Det bør oppgis hvilken rolle (role) navn/korporasjoner har. Eksempler på roller er: forfatter, komponist, filmregissør, fotograf, skaper etc.

• Bruk av role-attributt bør gi mening for avleverer, gjenspeile metadatakatalog/system, og bruken bør være konsekvent (standardisert skriveform).

Eksempler:

{"creator": [
  {
    "name": "Marek, Václav (1908-1994)",
    "type": "Person",
    "role": "fotograf",
    "authority": {
      "source": "Felles autoritetsregister (BARE)",
      "code": "90169632",
      "uri": "https://bibsys-almaprimo.hosted.exlibrisgroup.com/permalink/f/nelpa2/AUTREG90169632"
    }
  }
]}

{"creator": [
  {
    "name": "Shakespeare, William (1564-1616)",
    "type": "Person",
    "role": "forfatter",
    "authority": {
      "source": "Felles autoritetsregister (BARE)",
      "code": "9016555",
      "uri": "https://bibsys-almaprimo.hosted.exlibrisgroup.com/permalink/f/nelpa2/AUTREG9016555"
    }
  }
]}

Retningslinjer for bruk:

Regler for utfylling av Contributor-feltet er de samme som Creator-feltet. Eksempler på roller for Contributor kan være: bidragsyter, avbildet, illustratør, modell, redaktør, designer etc.

Eksempler:

{"contributor": [
  {
    "role": "avbildet",
    "type": "Person",
    "name": "Nordmann, Ola"
  },
  {
    "role": "avbildet",
    "name": "Nordmann, Kari"
  }
]}

{"contributor": [
  {
    "role": "illustratør",
    "type": "Person",
    "name": "Solberg, Erna",
    "authority": {
      "source": "Kulturnav",
      "code": "e762d909-5cce-4d2b-892b-258272514fde",
      "uri": "https://kulturnav.org/e762d909-5cce-4d2b-892b-258272514fde"
    }
  }
]}

Retningslinjer for bruk:

• Vanlig praksis er å beskrive både sted, forlag/korporasjon og år for utgivelse.

• Her brukes også autoritetsregister hvis det finnes. Det må oppgis hvilket autoritetsregister som er benyttet, og hvilken type autoritet det er (type): Person, Organization, Personal Name, Corporate Name, Meeting Name (konferanse), Uniform Title (traktat, kontrakt).

Eksempel:

{"publisher": [
  {
    "name": "Nasjonalbiblioteket",
    "type": "Organization",
    "authority": {
      "source": "Felles autoritetsregister (BARE)",
      "code": "90362181",
      "uri": "https://bibsys-almaprimo.hosted.exlibrisgroup.com/permalink/f/nelpa2/AUTREG90362181"
    }
  }
]}

Retningslinjer for bruk:

• Bruk ISO 3166-2 for angivelse av land. Landekoder skrives bak landet i parentes (NO).

• Vi anbefaler bruk av stedsnavstjenester/registre for angivelse av norske stedsnavn. Et eksempel er Sentralt stedsnavnregister (SSR) fra kartverket. Det må oppgis hvilket register som er benyttet.

• Ved bruk av autoritetsregistre for å angi Spatial, bør man skrive plassering/navn i sin fulle form i tillegg. Brukes ikke register, skrives plassering/navn fortrinnsvis land;region/fylke;kommune;sted;gate;.

• Det er mulig å oppgi koordinater i form av lengde- og breddegrader. Det skal brukes på denne måten: latitude=61.85401 longitude=9.80856

• Eksempler på type sted kan være utgiversted, innspillingssted, handlingssted, trykkested, fødested osv. Bruk av type-attributt her bør gi mening for avleverer, gjenspeile metadatakatalog/system, og bruken bør være konsekvent (standardisert skriveform).

Eksempel:

{"spatial": [
  { 
    "name": "Norge (NO);Innlandet;Stor-Elvdal;Rondane gjestegård",
    "type": "Avbildet sted",
    "authority": {
      "source": "Kulturnav",
      "code": "1031636c-0717-4d12-8895-fb88a7d4e952",
      "uri": "http://kulturnav.org/1031636c-0717-4d12-8895-fb88a7d4e952"
    },    
    "coordinateReferenceSystem": "EPSG:4326",
    "latitude": 61.788453,
    "longitude": 10.224725
  },
  { 
    "name": "Norge (NO);Innlandet;Lillehammer;Lillehammer"
  }  
]}

Retningslinjer for bruk:

• Det må angis type årstall + årstall/verdi. ISO 8601-2 brukes som standard.

• Bruke av type-attributt bør gi mening for avleverer, gjenspeile metadatakatalog/system, og bruken bør være konsekvent (standardisert skriveform).

Eksempler:

{"date": [
  {
    "type": "motivdato",
    "value": "1938"
  },
  {
    "type": "digitalisert",
    "value": "2022-03-05T14:28:12+02:00"
  },
  {
    "type": "publisert",
    "value": "2022-03-12"
  }
]}

Retningslinjer for bruk:

• ISO 639-2 brukes som standard for å angi språk når attributt lang brukes.

• Det må angis type for hva språket representerer. Eksempler på type som språket representerer kan være undertekster, talespråk, skriftspråk etc.

• Bruk av type-attributt bør gi mening for avleverer, gjenspeile metadatakatalog/system, og bruken bør være konsekvent (standardisert skriveform).

Eksempler:

{"language": [
  {
    "type": "undertekster",
    "value": "engelsk",
    "lang": "nor"
  }
]}

{"language": [
  {
    "type": "skriftspråk",
    "value": "fransk",
    "lang": "nor"
  }
]}

Retningslinjer for bruk:

• Språkkode bør angis (lang-attributt). ISO 639-2 brukes som standard for å angi språk når attributt lang brukes.

Eksempler:

{"isPartOf": [
  {
    "value": "Norge på langs med Ola og Kari",
    "lang": "nor"
  }
]}

{"isPartOf": [
  {
    "value": "Chronicles of Narnia",
    "lang": "eng"
  }
]}

Retningslinjer for bruk:

• Språkkode bør angis (lang-attributt). ISO 639-2 brukes som standard for å angi språk når attributt lang brukes.

Eksempel:

{"provenance": [
  {
    "value": "Samlingen ble donert til Nasjonalbiblioteket av Václav Marek 1979-05-12",
    "lang": "nor"
  }
]}

Retningslinjer for bruk:

• Feltet brukes for å beskrive hva ressursen inneholder/handler om. Eksempler på dette er ord eller uttrykk som forteller noe om emne, tema, hendelser, landemerker, bygninger eller tidsperioder som har betydning for ressursen.

• Desimalklassifikasjon er også gyldige verdier.

• Språkkode bør angis (lang-attributt). ISO 639-2 brukes som standard for å angi språk når attributt lang brukes.

Eksempler:

{"subject": [
  {
    "lang": "nor",
    "value": "rondane"
  },
  {
    "lang": "nor",
    "value": "fisketur"
  },
  {
    "lang": "nor",
    "value": "natur"
  }
]}

Retningslinjer for bruk:

• Beskrivelsen kan inkludere, men er ikke begrenset til: et sammendrag, en innholdsfortegnelse, en grafisk representasjon eller en fritekst om ressursen.

• Språkkode bør angis (lang-attributt). ISO 639-2 brukes som standard for å angi språk når attributt lang brukes.

Eksempel:

{"description": [
  {
    "value": "Bildet er en del av samlingen etter John Doe, der han fulgte Ola og Kari Nordmann Norge på langs. Václav Marek var en engelskmann som var interessert i Norge og norsk natur.",
    "lang": "nor"
  }
]}

Eksempel som inneholder alle metadataelementene:

{
  "objectId": "av_6e8bc430-9c3a11d9",
  "priority": 50,
  "metadata": {
    "type": "Bilde",
    "identifier": [
      {
        "type": "URN",
        "value": "URN:NBN:no-nb_digifoto_20220311_00191_NB_PE_VM_M_05_09_01_036"
      },
      {
        "type": "bilde-id",
        "value": "NB_PE_VM_M_05_09_01_036"
      },
      {
        "type": "hyllesignatur",
        "value": "POEL00003975"
      }
    ],
    "title": {
      "value": "Ola og Kari på fisketur i Rondane",
      "lang": "nor"
    },
    "alternative": [
      {
        "type": "original tittel",
        "value": "Ola and Kari on fishing trip in Rondane",
        "lang": "eng"
      }
    ],
    "creator": [
      {
        "name": "Marek, Václav",
        "type": "Person",
        "role": "fotograf",
        "authority": {
          "source": "Felles autoritetsregister (BARE)",
          "code": "90362181",
          "uri": "https://bibsys-almaprimo.hosted.exlibrisgroup.com/permalink/f/nelpa2/AUTREG90362181"
        }
      }
    ],
    "contributor": [
      {
        "role": "avbildet",
        "type": "Person",
        "name": "Nordmann, Ola"
      },
      {
        "role": "avbildet",
        "type": "Person",
        "name": "Solberg, Erna",
        "authority": {
          "source": "Kulturnav",
          "code": "e762d909-5cce-4d2b-892b-258272514fde",
          "uri": "https://kulturnav.org/e762d909-5cce-4d2b-892b-258272514fde"
        }
      }
    ],
    "publisher": [
      {
        "name": "Nasjonalbiblioteket",
        "type": "Organization",
        "authority": {
          "source": "Felles autoritetsregister (BARE)",
          "code": "90362181",
          "uri": "https://bibsys-almaprimo.hosted.exlibrisgroup.com/permalink/f/nelpa2/AUTREG90362181"
        }
      }
    ],
    "spatial": [
      { 
        "name": "Norge (NO);Innlandet;Stor-Elvdal;Rondane gjestegård",
        "type": "Avbildet sted",
        "authority": {
          "source": "Kulturnav",
          "code": "1031636c-0717-4d12-8895-fb88a7d4e952",
          "uri": "http://kulturnav.org/1031636c-0717-4d12-8895-fb88a7d4e952"
        },    
        "coordinateReferenceSystem": "EPSG:4326",
        "latitude": 61.788453,
        "longitude": 10.224725
      },
      { 
        "name": "Norge (NO);Innlandet;Lillehammer;Lillehammer"
      }  
    ],
    "date": [
      {
        "type": "motivdato",
        "value": "1938"
      },
      {
        "type": "digitalisert",
        "value": "2022-03-05T14:28:12+02:00"
      },
      {
        "type": "publisert",
        "value": "2022-03-12"
      }
    ],
    "language": [
      {
        "type": "undertekster",
        "value": "engelsk",
        "lang": "nor"
      }
    ],
    "isPartOf": [
      {
        "value": "Norge på langs med Ola og Kari",
        "lang": "nor"
      }
    ],
    "provenance": [
      {
        "value": "Samlingen ble donert til Nasjonalbiblioteket av Václav Marek 1979-05-12",
        "lang": "nor"
      }
    ],
    "subject": [
      {
        "lang": "nor",
        "value": "rondane"
      },
      {
        "lang": "nor",
        "value": "fisketur"
      },
      {
        "lang": "nor",
        "value": "natur"
      }
    ],
    "description": [
      {
        "value": "Bildet er en del av samlingen etter John Doe, der han fulgte Ola og Kari Nordmann Norge på langs. Václav Marek var en engelskmann som var interessert i Norge og norsk natur.",
        "lang": "nor"
      }
    ]
  }
}