Krav til metadata

I tillegg til krav om avlevering av en metadatafil i informasjonspakkene (SIP), krever Nasjonalbiblioteket at et sett med metadata også leveres via submission-APIet. Dette skal sikre at et minimum av metadata er knyttet til de avleverte representasjonene. Disse metadataene er i tillegg de eneste som vil blir indeksert og søkbare i bevaringsomgivelsene.

Metadatakravene 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. Standarden er supplert med attributter i feltene for å gjøre metadataene mer strukturerte.

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

Generelle retningslinjer for bruk av standarder

• Tegnsetting for utfylling av felter følger UTF-8.
• ISO 639-3 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

Type

Retningslinjer for bruk:

Tillatte typer for å beskrive ressursen sortert på medietype:

• 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.

Vokabularet har kun norske verdier.

I kravene til METS.xml har vi et påkrevd attributt som heter Content category @TYPE. Content category angir medietype på overordnet nivå.

Eksempel:

{
  "type": "Bilde"
}

Identifier

Retningslinjer for bruk:

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 på identifikatortyper kan være URN, PID, URI til post i en katalog/metadatasystem, dokID, hefteID, eksemplarnummer, ISBN, ISSN, ISMN, ISNI, DOI, plateetikett etc.

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"
    }
  ]
}

Title

Retningslinjer for bruk:

Alle pakker MÅ ha en tittel.

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

Tittelens språk bør angis med språkkode i henhold til ISO 639-3 med lang-attributten.

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"
  }
}

Alternative

Retningslinjer for bruk:

Denne attributten gir mulighet for å oppgi flere titler, for eksempel titler på andre språk, arbeidstitler, etc.

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.

Den alternative tittelen MÅ ha en type, for å beskrive hva slags 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).

Tittelens språk bør angis med språkkode i henhold til ISO 639-3 med lang-attributten.

Eksempel:

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

Creator

Retningslinjer for bruk:

Det anbefales å referere til autoritetsregistre når relevante registre 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
• korporasjon
• konferanse
• standardtittel (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).

Forklaring til bruk av authority-informasjon:

• source: Navnet på autoritetsregisteret verdien er hentet fra, oppgitt som en tekststreng.
• code: En unik identifikator for autoriteten i registeret, ofte i form av en tall- eller alfanumerisk kode.
• URI: En entydig lenke (URI) som peker til autoritetsoppføringen verdien er hentet fra.

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"
      }
    }
  ]
}

Contributor

Retningslinjer for bruk:

Det anbefales å referere til autoritetsregistre når relevante registre 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.

Contributor 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
• korporasjon
• konferanse
• standardtittel (traktat, kontrakt).

Det bør oppgis hvilken rolle (role) navn/korporasjoner har. Eksempler på roller er: bidragsyter, avbildet, illustratør, modell, redaktør, designer etc.

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

Forklaring til bruk av authority-informasjon:

• source: Navnet på autoritetsregisteret verdien er hentet fra, oppgitt som en tekststreng.
• code: En unik identifikator for autoriteten i registeret, ofte i form av en tall- eller alfanumerisk kode.
• URI: En entydig lenke (URI) som peker til autoritetsoppføringen verdien er hentet fra.

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"
      }
    }
  ]
}

Publisher

Retningslinjer for bruk:

Det anbefales å bruke autoritetsregister når relevante registre finnes. Det MÅ oppgis hvilket autoritetsregister som er benyttet, og hvilken type autoritet det er (type):

• person
• korporasjon
• konferanse
• standardtittel (traktat, kontrakt).

Ved bruk av autoritetsregister bør utgiver i tillegg skrives ut i sin fulle form. Sted og/eller år for utgivelse kan legges til i parantes bak navnet. Eksempel: Nasjonalbiblioteket (Oslo, 1984).

Forklaring til bruk av authority-informasjon:

• source: Navnet på autoritetsregisteret verdien er hentet fra, oppgitt som en tekststreng.
• code: En unik identifikator for autoriteten i registeret, ofte i form av en tall- eller alfanumerisk kode.
• URI: En entydig lenke (URI) som peker til autoritetsoppføringen verdien er hentet fra.

Eksempel:

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

Spatial

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).

Forklaring til bruk av authority-informasjon:

• source: Navnet på autoritetsregisteret verdien er hentet fra, oppgitt som en tekststreng.
• code: En unik identifikator for autoriteten i registeret, ofte i form av en tall- eller alfanumerisk kode.
• URI: En entydig lenke (URI) som peker til autoritetsoppføringen verdien er hentet fra.

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"
    }
  ]
}

Date

Retningslinjer for bruk:

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

Bruk 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"
    }
  ]
}

Language

Retningslinjer for bruk:

Verdien skal oppgis i henhold til ISO 639-3.

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": "eng"
    }
  ]
}

{
  "language": [
    {
      "type": "skriftspråk",
      "value": "fre",
    }
  ]
}

Relation

Retningslinjer for bruk:

Bruk av attributter kan varieres, men det kreves alltid bruk av type OG title eller id.

Attributt title angir tittel på relatert ressurs. Tittelens språk bør angis med med lang-attributten i henhold til ISO 639-3.

Attributt type angir hvilken type relasjon det er mellom ressurser. Bruk av termer fra Dublin Core anbefales (conformsTo, hasFormat, hasPart, hasVersion, isFormatOf, isPartOf, isReferencedBy, isReplacedBy, isRequiredBy, isVersionOf, references, replaces, requires) . Hvis andre termer brukes bør de gi mening for avleverer, gjenspeile metadatakatalog/system, og bruken bør være konsekvent (standardisert skriveform).

Eksempel på bruk av attributt id er henvisning til en seriepost, verkspost, eller andre ressurser i samme i serie/verk.

Attributt URI brukes for å angi lenke til relatert ressurs (katalogpost, nettside).

Eksempler:

{
  "relation": [
    {
      "title": "Norge på langs med Ola og Kari",
      "lang": "nor",
      "id": "987654321",
      "type": "IsPartOf",
      "URI": "https://www.nb.no/items/eb57e3c314894b0120cf631104065e74?page"
    }
  ]
}

{
  "relation": [
    {
      "title": "Chronicles of Narnia",
      "lang": "eng",
      "type": "IsPartOf"
    }
  ]
}

{
  "relation": [
    {
      "title": "20161203.jpg",
      "type": "hasPart",
      "URI": "https://www.nb.no/items/83af9a36b005c5737aa33d1fb64f429d?page"
    }
  ]
}

Provenance

Retningslinjer for bruk:

Språket brukt til å beskrive provenance bør oppgis med lang-attributtet for verdien i henhold til ISO 639-3.

Eksempel:

{
  "provenance": [
    {
      "value": "Bildet er del av en digital samling, som ble donert til Nasjonalbiblioteket av Ola Nordmann 2025-01-01.",
      "lang": "nor"
    }
  ]
}

{
  "provenance": [
    {
      "value": "Dette digitale objektet var tidligere en del av samlinga til Museum X mellom 1999 og 2002, før den ble overført til Museum Y. Museum Y deponerte objektet til Nasjonalbiblioteket i 2025",
      "lang": "nor"
    }
  ]
}

{
  "provenance": [
    {
      "value": "Digitisering gjort internt ved Nasjonalbiblioteket i 2022-24. Prosjektet ble startet og ferdigstilt etter det ble oppdaget at filmen var en tapt tysk spillefilm, uten andre kjente kopier. I det digitale arbeidet ble den originale visningskopien (ID-12345) skannet i 2022. Prosjektet hadde som mål å digitalt sikre filmen, med dens originale fargeuttrykk. ",
      "lang": "nor"
    }
  ]
}

Subject

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.

Det kan brukes henvisning til autoritetsregistre der det er relevant. Der det brukes autoritetsregister må emneord skrives i sin fulle form i tillegg.

Forklaring til bruk av authority-informasjon:

• source: Navnet på autoritetsregisteret verdien er hentet fra, oppgitt som en tekststreng.
• code: En unik identifikator for autoriteten i registeret, ofte i form av en tall- eller alfanumerisk kode.
• URI: En entydig lenke (URI) som peker til autoritetsoppføringen verdien er hentet fra.

Eksempler:

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

{
  "subject": [
    {
      "value": "natur",
      "authority": {
        "source": "Kulturnav",
        "code": "1031536c-0717-4d12-8895-fb88a7d4e952",
        "uri": "http://kulturnav.org/1031636c-0717-4d32-8895-fb88a7d4e952"
      }
    }
  ]
}

Description

Retningslinjer for bruk:

Språkkode må angis (lang-attributt). ISO 639-3 brukes som standard for å angi språk når attributt lang brukes.

Eksempel:

{
  "description": [
    {
      "value": "Bildet er en del av samlingen etter Václav Marek, 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": "originaltittel",
        "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": "Korporasjon",
        "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": "nor"
      }
    ],
    "relation": [
      {
        "title": "Norge på langs med Ola og Kari",
        "type": "IsPartOf",
        "id": "987654321",
        "URI": "https://www.nb.no/items/eb57e3c314894b0120cf631104065e74?page",
        "lang": "nor"
      }
    ],
    "provenance": [
      {
        "value": "Samlingen ble donert til Nasjonalbiblioteket av Václav Marek 1979-05-12",
        "lang": "nor"
      }
    ],
    "subject": [
      {
        "value": "rondane"
      },
      {
        "value": "fisketur"
      },
      {
        "value": "natur",
        "authority": {
          "source": "Kulturnav",
          "code": "1031536c-0717-4d12-8895-fb88a7d4e952",
          "uri": "http://kulturnav.org/1031636c-0717-4d32-8895-fb88a7d4e952"
        }
      }
    ],
    "description": [
      {
        "value": "Bildet er en del av samlingen etter Václav Marek, 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"
      }
    ]
  }
}