Lista över metadataelement

R101 - *Identifierare

Unik och beständig identfierare för resursen.

Används vid återkoppling till leverantören och för att identifiera nya versioner av samma resurser. Beständig innebär att identifieraren förblir samma även om själva resursen eller dess metadata förändras (och nya versioner tillgängliggörs till KB, se Grundförutsättningar Länk till annan webbplats.).

Elementet är obligatoriskt.

Namn på XML-element

<guid>

XML-hierarki

XPATH: /rss/channel/item/guid

Värde på XML-element

Formatet är valfritt. Observera att värdet är skiftlägeskänsligt (case sensitive). Värde “pub-001” är alltså inte samma värde som “Pub-001”.

KB rekommenderar att använda en identifierare som är globalt unikt som t.ex. ett UUID eller GUID. Om det inte finns att tillgå måste det vara långsiktigt unikt och beständigt inom den leveranspliktiga organisationen, t.ex. article-2451 eller ett löpnummer som t.ex. 39. Om KB återkopplar till er om en specifik pliktleverans behöver ni kunna hitta den i era system.

KB rekommenderar inte att använda samma värde som i Nätadress eftersom Nätadress ibland inte är beständig.

Notis: Attributet isPermaLink används inte av KB trots att den anges i specifikationen för RSS 2.0 Länk till annan webbplats, öppnas i nytt fönster..

Exempel

R101 - Identifierare med typvärde (R)

Unik och beständig identifierare för resursen.

Flera identifierare av olika typ kan anges (elementet kan upprepas). För att ange typvärde med attributet @xsi:type, måste även namespace för xsi finnas med, KB rekommenderar att det anges i rotelementet <rss>. Attributets typvärde måste ha samma prefix som det man använt för namespace http://purl.org/dc/terms/ i roten, se Format och namnrymder Länk till annan webbplats.

KB rekommenderar att använda standardiserade identifierare.

Namn på XML-element

<dcterms:identifier>

Namn på XML-attribut

@xsi:type

XML-hierarki

XPATH: /rss/channel/item/dcterms:identifier[@xsi:type]

Värde på XML-element

I dagsläget har KB stöd för följande format: doi, ean, hdl, isan, isbn, ismn, isrc, issue-number, matrix-number, upc, uri, urn, uuid, local.

Varje enskilt format kan ha krav på formatering, t.ex. doi, isbn och urn.

Värde på XML-attribut

Giltiga värden är följande kontrollerade värdemängd: dcterms:doi, dcterms:ean, dcterms:hdl, dcterms:isan, dcterms:isbn, dcterms:ismn, dcterms:isrc, dcterms:issue-number, dcterms:matrix-number, dcterms:upc, dcterms:uri, dcterms:urn, dcterms:uuid, dcterms:local.

Beroende på vilket format som används ska motsvarande typ anges i detta attribut, se exempel.

Exempel

R102 - *Nätadress

Nätadress (URL) till den elektroniska resursen, dvs. till den internetadress där resursen är tillgängliggjord för allmänheten.

Elementet är obligatoriskt. URL i <link> används för att hämta resursen.

Om denna URL uppdateras behöver resursen inte omlevereras till KB.

Namn på XML-element

<link>

XML-hierarki

XPATH: /rss/channel/item/link

Värde på XML-element

• URL måste inledas med "http://" eller "https://"
• URL ska peka mot en nedladdningsbar fil

Exempel

R103 - *Publiceringsdatum

Tidpunkt för publicering.

Elementet anger tidpunkten då resursen publiceras eller uppdateras. En uppdatering av en redan levererad resurs ses som en ny resurs och skall levereras på nytt med ett uppdaterat pubDate.

Element är obligatoriskt.

Namn på XML-element

<pubDate>

XML-hierarki

XPATH: /rss/channel/item/pubDate

Värde på XML-Element

Datumformat enligt RFC 5322 Länk till annan webbplats, öppnas i nytt fönster. (Publiceringsår ska alltid anges med fyra tecken.)

Tidszon ska anges med siffror. Observera att lokal tid ska anges, dvs. hänsyn måste tas till normaltid / sommartid. Se exempel nedan.

Datumformat kan testas och valideras i KB:s validerings-tjänster Länk till annan webbplats..

Exempel

I det första exemplet sker publicering under normaltid och i det andra under sommartid.

R104 - *Utgivare

Unik identifierare för den aktör som har framställt och/eller tillgängliggjort resursen via internet.

Exempel kan vara utgivare, producent, myndighet eller distributör.

Element är obligatoriskt.

I de fall framställare och tillgängliggörare är olika aktörer bör framställare i första hand anges.

Om flera olika utgivare (t.ex. tidningstitlar) har samma organisationsnr som en gemensam leverantör (distributör, ägare) behövs ett suffix för att särskilja den specifika utgivare (tidningstitel) som publicerat resursen (artikeln). Suffixet ska föregås av bindestreck ’-’ och innehålla minst två tecken [A-Za-z0-9]. Detta ska ske i överenskommelse med KB och behövs endast då flera utgivare innehar samma organisationsnummer. Se exempel nedan.

Namn på XML-element

<dcterms:publisher>

XML-hierarki

/rss/channel/item/dcterms:publisher

Värde på XML-element

Värdet är baserat på svenskt organisationsnummer utan bindestreck ELLER svenskt personnummer (används vid enskild näringsverksamhet) med eventuellt suffix.

http://id.kb.se/organisations/SE<organisationsnummer>[-suffix]

http://id.kb.se/organisations/SE<personnummer>[-suffix]

Exempel

Första exemplet visar vad som anges för KB:s webbartiklar.

Exempel två och tre är de fiktiva tidningarna Dagspressen samt Läslusen. Dessa har egna redaktioner – som är leveranspliktiga – men har samma ägare. Här har då suffixen DP respektive LL överenskommits.

Det fjärde exemplet är ett fiktivt personnummer för en person född 1970-01-01.

R105 - *Titel

Det namn som resursen är känt under.

Elementet är obligatoriskt.

Namn på XML-element

<title>

XML-hierarki

XPATH: /rss/channel/item/title

Värden på XML-element

Ange det namn som resursen är känd under.

Observera att namn som "rapport.pdf" eller "dokument.docx" INTE är godkända värden på titel.

Kontakta e-plikt@kb.se om ni har frågor.

Exempel

R106 - Beskrivning

Kort redogörelse för resursens innehåll.

Exempel kan vara ingress, sammanfattning eller abstract.

Använd inte elementet <content:encoded> för detta syfte.

Namn på XML-element

<description>

XML-hierarki

XPATH: /rss/channel/item/description

Exempel

R107 - *Tillgänglighet vid publicering

Elementet beskriver resursens tillgänglighet vid aktuell publicering.

Ange gratis om resursen är fritt tillgänglig vid aktuell publicering.

Ange restricted, om det – för tillgång till resursen – gäller särskilda villkor (betalning, abonnemang, premium-material).

Element är obligatoriskt.

Namn på XML-element

<dcterms:accessRights>

XML-hierarki

XPATH: /rss/channel/item/dcterms:accessRights

Värde på XML-element

Kontrollerad värdemängd: gratis, restricted.

Exempel

R108 - Licens

Nätadress till ett licensavtal som omfattar alla ingående delar av dokumentet.

Se även F307 - Licens för enskild fil Länk till annan webbplats.

Namn på XML-element

<dcterms:license>

XML-hierarki

XPATH: /rss/channel/item/dcterms:license

Värde på XML-element

Rekommenderat format är URI, om det inte finns tillgängligt kan en kort beskrivning av licensen istället användas.

Exempel

R111 - *Relaterad resurs - Serie (R)

En referens till en serie som resursen ingår i.

Exempel är en vetenskaplig artikel som tillhör en artikelserie eller en e-bok som tillhör en förlagsserie. I dessa fall är alltså artikelserien/förlagsserien den relaterade resursen. Elementet kan upprepas om en artikel publicerats i flera olika serier, t.ex. en artikel som publicerats i flera olika antologier.

Namn på XML-element

<dcterms:isPartOf>

Namn på XML-attribut

@xsi:type

XML-hierarki

XPATH: /rss/channel/item/dcterms:isPartOf[@xsi:type]

Värde på XML-element

Format: dddd-dddX där d är siffror 0-9 och X kan vara siffror 0-9 eller bokstaven X. För mer info, se informations-sida på issn.org Länk till annan webbplats, öppnas i nytt fönster..

Värde på XML-attribut

Fast värde: "dcterms:issn"

Exempel

R112 - *Relaterad resurs - Värdpublikation (R)

En referens till en publikation som levereras separat och som aktuell resurs ingår i eller hör till.

Om den refererade publikationen (värdpublikationen) också är leveranspliktig (tryckt eller elektronisk) är detta metadataelement obligatoriskt.

Exempel: aktuell resurs är en video som ingår i en separat levererad leveranspliktig artikel. Fältet ska alltså i detta fall referera till artikeln.

Namn på XML-element

<dcterms:isPartOf>

Namn på XML-attribut

@xsi:type

XML-hierarki

XPATH: /rss/channel/item/dcterms:isPartOf[@xsi:type]

Värde på XML-element samt XML-attribut

För formatering, se R101 - Identifierare med typvärde (R) Länk till annan webbplats..

Specialfall

Observera att detta är ett specialfall som främst används när en fil – av olika skäl – inte kan levereras tillsammans med den publikation som filen tillhör.

Standardförfarandet är att "värdpublikationen" är själva resursen och att filen specificeras under XML-elementet F302, F303 - *Fil som ingår i resurs (R) Länk till annan webbplats..

Exempel

R113 - Annat format - Referens

En referens till en resurs som är utgiven i ett annat format men som är identisk till innehållet.

Det kan gälla t.ex. när en resurs ges ut både som pdf och epub. Ange en identifikator för den relaterade resursen. Elementet kan upprepas om flera utgåvor i olika format finns.

Namn på XML-element

<dcterms:isFormatOf>

Namn på XML-attribut

@xsi:type

XML-hierarki

XPATH: /rss/channel/item/dcterms:isFormatOf[@xsi:type]

Värde på XML-element samt XML-attribut

För formatering, se R101 - Identifierare med typvärde (R) Länk till annan webbplats..

Exempel

ISBN tillhör här en tryckt utgåva av den aktuella elektroniska resursen.

R115 - Upphov till resurs - Ansvar (R)

Namn på person (eller organisation) som anges som huvudsakligt upphov till resursen.

Namn på XML-element

<dcterms:creator>

XML-hierarki

XPATH: /rss/channel/item/dcterms:creator

Värde på XML-element

För person: Förnamn Efternamn (roll)

För organisation: Organisationsnamn

Exempel

R115 - Upphov till resurs - Bidrag (R)

Namn på person (eller organisation) som bidragit till resursens intellektuella eller konstnärliga innehåll.

Exempel kan vara illustratör, översättare eller fotograf.

Namn på XML-element

<dcterms:contributor>

XML-hierarki

XPATH: /rss/channel/item/dcterms:contributor

Värde på XML-element

För person: Förnamn Efternamn (roll)

För organisation: Organisationsnamn

Exempel

R116 - Språk (R)

Information om resursens språk.

Upprepa elementet om flera språk förekommer.

Namn på XML-element

<dcterms:language>

XML-hierarki

XPATH: /rss/channel/item/dcterms:language

Värde på XML-element

Format: 3-bokstavskod enligt ISO 639-2:1998 eller 2-bokstavskod enligt ISO 639-1:2002

Exempel

R117 - *Filformat

Filformat för resursen.

Anger filformat för den fil som anges i elementet R102 - *Nätadress Länk till annan webbplats..

Elementet är obligatoriskt.

Namn på XML-element

<dcterms:format>

XML-hierarki

XPATH: /rss/channel/item/dcterms:format

Värde på XML-element

Filformat enligt IANA - Media Types Länk till annan webbplats, öppnas i nytt fönster.. Består av: förled / efterled , där förledet anger medietyp och efterledet filformat. Är även känt som "MIME type".

Exempel på värden: application/pdf, text/html, video/mp4, audio/mpeg, image/jpeg, image/gif, image/tiff.

Exempel

R118 - Nyckelord (R)

Beskrivande nyckelord för hela resursen.

Namn på XML-element

<media:keywords>

XML-hierarki

XPATH: /rss/channel/item/media:keywords

Värde på XML-element

Format: Kommaseparerad lista med nyckelord.

Exempel

F302, F303 - Fil som ingår i resurs (R)

Pekar ut enstaka fil(er) som ingår i en resurs.

Exempel kan vara stillbilder, ljudspår, videoklipp, pdf-dokument, undertexter eller andra filer som hör till resursen.

Samlar de två metadataelementen "F302 Nätadress" och "F303 Filformat".

Observera att det som pekas ut i "R102 - *Nätadress" INTE ska placeras också i detta metadataelement, det är duplicerad och oönskad information.

Elementet är obligatoriskt om tillämpligt. Exempel på filer som är obligatoriska:

• Alla bilder i en webbartikel
• Alla videoklipp i en webbartikel
• Undertexter till video - OM undertext finns tillgänglig för slutanvändaren (autogenererad textning är inte obligatorisk)

F302 Nätadress

Filens nätadress vid publicering. Anges med attribut @url.

F303 Filformat

Filformat enligt IANA - Media Types Länk till annan webbplats, öppnas i nytt fönster.. Består av: förled / efterled , där förledet anger mediatyp och efterledet filformat. Anges med attribut @type.

Namn på XML-element

<media:content>

Namn på XML-attribut

@url, @type

XML-hierarki

/rss/channel/item/media:content

/rss/channel/item/media:content/@url

/rss/channel/item/media:content/@type

Värde på XML-element

Textbaserade värden anges inte i elementet men det kan innehålla under-element.

Värde på XML-attribut

@url: URL

• URL ska följa formatet "http://" eller "https://"
• Den ska peka mot en nedladdningsbar fil

@type: förled/efterled

Exempel på värden: application/pdf, text/html, video/mp4, audio/mpeg, image/jpeg, image/gif, image/tiff.

Exempel

F305 - Checksumma för enskild fil (R)

Anger checksumma för en utpekad fil.

I dagsläget har KB stöd för typen MD5.

Namn på XML-element

<media:hash>

XML-hierarki

XPATH: /rss/channel/item/media:content/media:hash

Värde på XML-element

Format: alfanumerisk text.

Exempel

F307 - Licens för enskild fil (R)

Kan användas för att ange en licens som omfattar en viss del av resursen.

Elementvärdet kan lämnas tomt, oavsett innehåll är det attributet @href som används av KB för rättighetshantering.

Namn på XML-element

<media:license>

Namn på XML-attribut

@type, @href

XML-hierarki

XPATH:

/rss/channel/item/media:content/media:license

/rss/channel/item/media:content/media:license[@href]

Värde på XML-element

Format: Text.

Värde på XML-attribut

@type: förled/efterled

För formatering se R117 - *Filformat Länk till annan webbplats..

@href: URI

Exempel

F308 - Upphovsrättsinnehavare till enskild fil (R)

Information om upphovsrättsinnehavare till en enskild fil.

Namn på XML-element

<media:copyright>

Namn på XML-attribut

@url

XML-hierarki

XPATH: /rss/channel/item/media:content/media:copyright

Värde på XML-element

För person: Förnamn Efternamn

För organisation: Organisationsnamn

Värde på XML-attribut

Länk till användningsvillkor eller annan information om upphovsrätt.

Exempel

F308 - Upphov till enskild fil (R)

Namn och roll för person eller institution som skapat eller bidragit till en enskild fils intellektuella eller konstnärliga innehåll

Exempel kan vara författare, fotograf eller produktionsbolag.

Anges antingen enligt specificerat schema eller som fritext, se exempel.

Namn på XML-element

<media:credit>

Namn på XML-attribut

@scheme, @role

XML-hierarki

XPATH: /rss/channel/item/media:content/media:credit

Värde på XML-element

Med schema:

• För person: Förnamn Efternamn

• För organisation: Organisationsnamn

Utan schema:

• För person: Förnamn Efternamn (roll)

• För organisation: Organisationsnamn (roll)

Värde på XML-attribut

@scheme: Ej obligatoriskt. Kontrollerat värde. I dagsläget har KB bara stöd för schemat "urn:ebu".

@role: Ej obligatoriskt. Giltiga värden är följande kontrollerade värdemängd: actor, author, choreographer, composer, conductor, contributor, director, editor, illustrator, lyricist, music arranger, musician, narrator, performer, producer, photographer, reporter, storyteller, vocalist.

Exempel

F311 - Nyckelord för enskild fil (R)

Beskrivande nyckelord för en enskild fil (ett objekt) som hör till resursen.

Namn på XML-element

<media:keywords>

XML-hierarki

XPATH: /rss/channel/item/media:content/media:keywords

Värde på XML-element

Format: Kommaseparerad lista med nyckelord.

Exempel

F302, F303 - *Fil som ingår i resurs - Annat format (R)

Nätadress till en utpekad resurs som är utgiven i ett annat format men som är identisk till innehållet med den aktuella resursen.

Till exempel en webbsida utan annonser, navigering och liknande.

Den utpekade resursen refereras till via attributet @url i en anpassad <media:content>. Anpassningen består av ett element <dcterms:isFormatOf> med samma värde som elementet <link> i aktuell resurs, se exempel.

Namn på XML-element

<media:content>

XML-hierarki

XPATH:

/rss/channel/item/media:content

/rss/channel/item/media:content/dcterms:isFormatOf[@xsi:url]

Värde på XML-element

För formatering av <media:content>, se: F302, F303 - *Fil som ingår i resurs (R) Länk till annan webbplats..

Exempel

En webb-artikel utan reklam pekas ut. Attributet @url refererar till den utpekade resursen och elementet <dcterms:isFormatOf> har samma värde som elementet <link> i den aktuella resursen.

F312 - *Identifikator - Fil som levereras separat (R)

Referens till en fil som levereras separat.

Elementet beskriver fil(er) som levereras separat via en annan leverans-kanal, de medföljer alltså inte media:content.

Notera att referensen som används i detta fält måste användas i den separata leveransen.

Elementet är obligatoriskt om utpekad fil(er) är leveranspliktig.

Exempel på separat leverans är FTP, hårddisk eller ett separat RSS-flöde.

Namn på XML-element

<dcterms:references>

Namn på XML-attribut

@xsi:type

XML-hierarki

XPATH: /rss/channel/item/dcterms:references[@xsi:type]

Värde på XML-element samt XML-attribut

För formatering, se R101 - Identifierare med typvärde (R) Länk till annan webbplats..

Exempel

R119 - Resurs - Löpnummer

Resursens löpnummer - om den publiceras i serie.

Elementet kan användas antingen för ett löpnummer inom en säsong (dvs. 6:an i branschformatet "S03E06") eller för ett löpnummer inom en hel serie, oberoende av säsong. I det förra fallet måste även säsongens löpnummer anges i R123 - Säsong – Löpnummer Länk till annan webbplats..

Tillämpade exempel:

• ett podcastavsnitts löpnummer i dess senaste säsong
• löpnumret för en ljudbok som publiceras i en serie av böcker
• ett videoavsnitt som ingår i en serie av videoklipp

Namn på XML-element

<sdo:episodeNumber>

XML-hierarki

XPATH: /rss/channel/item/sdo:episodeNumber

Värde på XML-element

Format: heltal.

Exempel

R120 - Säsong - Namn

Namnet på den säsong som resursen tillhör.

Namn på XML-element

<sdo:name>

XML-hierarki

XPATH: /rss/channel/item/sdo:partOfSeason/sdo:CreativeWorkSeason/ sdo:name

Värde på XML-element

Format: text.

Exempel

R121 - Säsong - Beskrivning

Kortfattad beskrivning vad resursens säsong handlar om.

Namn på XML-element

<sdo:abstract>

XML-hierarki

XPATH: /rss/channel/item/sdo:partOfSeason/sdo:CreativeWorkSeason/ sdo:abstract

Värde på XML-element

Format: text.

Exempel

R122 - Säsong - Identifierare

Unik identifierare för aktuell säsong.

Namn på XML-element

<sdo:identifier>

XML-hierarki

XPATH: /rss/channel/item/sdo:partOfSeason/sdo:CreativeWorkSeason/ sdo:identifier

Värde på XML-element

Format: text.

Exempel

R123 - Säsong - Löpnummer

Säsongens löpnummer.

Namn på XML-element

<sdo:episodeNumber>

XML-hierarki

XPATH: /rss/channel/item/sdo:partOfSeason/sdo:CreativeWorkSeason/ sdo:seasonNumber

Värde på XML-element

Format: heltal.

Exempel

R124 - Säsong - Totalt antal avsnitt

Totalt antal avsnitt i aktuell säsong.

Om säsongen pågår och/eller totalt antal avsnitt inte är känt ska detta värde inte anges.

Namn på XML-element

<sdo:numberOfEpisodes>

XML-hierarki

XPATH: /rss/channel/item/sdo:partOfSeason/sdo:CreativeWorkSeason/ sdo:numberOfEpisodes

Värde på XML-element

Format: heltal.

Exempel

R125 - Serie - Namn

Namnet på t.ex. en tv-serie, podcast eller bok-serie.

Namn på XML-element

<sdo:name>

XML-hierarki

XPATH: /rss/channel/item/sdo:partOfSeason/sdo:CreativeWorkSeason/ sdo:partOfSeries/sdo:name

Värde på XML-element

Format: text.

Exempel

R126 - Serie - Beskrivning

Kortfattad beskrivning vad serien handlar om.

Namn på XML-element

<sdo:abstract>

XML-hierarki

XPATH: /rss/channel/item/sdo:partOfSeason/sdo:CreativeWorkSeason/ sdo:partOfSeries/sdo:abstract

Värde på XML-element

Format: text.

Exempel

R127 - Serie - Identifierare

Unik identifierare för serien.

Namn på XML-element

<sdo:identifier>

XML-hierarki

XPATH: /rss/channel/item/sdo:partOfSeason/sdo:CreativeWorkSeason/ sdo:partOfSeries/sdo:identifier

Värde på XML-element

Format: text.

Exempel

R128 - Serie - Antal säsonger

Totalt antal säsonger i aktuell serien.

Om serien pågår och/eller totalt antal säsonger inte är känt ska detta värde inte anges.

Namn på XML-element

<sdo:numberOfSeasons>

XML-hierarki

XPATH: /rss/channel/item/sdo:partOfSeason/sdo:CreativeWorkSeason/ sdo:partOfSeries/ sdo:numberOfSeasons

Värde på XML-element

Format: heltal.

Exempel