Retningslinjer for bruk av metadata levert av Bokbasen

For å bidra til effektiv utnyttelse av metadata i verdikjeden har Bokbasen etablert noen retningslinjer for våre metadatakunder. Retningslinjene gjelder alle som forhandler / selger bøker på nettsteder eller i apper f.eks nettbokhandler eller abonnementstjenester.

Å følge retningslinjene er frivillig for våre metadatakunder, men Bokbasen har innført økonomiske incentivordninger knyttet til etterlevelse av retningslinjene for de metadatakunder som bruker våre data på handelsplattformer.

Retningslinjer for bruk av metadatapostenes innhold

Der ikke annet er angitt gjelder retningslinjene både på nettsteder og i apper.

Følgende metadatafelt må vises i treffliste og detaljbilde:

Serietittel og serienummer/Annen tilknytning og nummer for leserekkefølge: må vises både i treffliste og på den enkelte boks detaljbilde.

Annen tilknytning og nummer for leserekkefølge bør behandles og vises på samme måte som Serie for sluttbruker.
Forhandlere av læremidler må vise navn på læreverk

ONIX-element:

<Collection>
<CollectionType>10</CollectionType>
<CollectionIdentifier>
<CollectionIDType>01</CollectionIDType>
<IDTypeName>Bokbasen_ProprietaryID</IDTypeName>
<IDValue>150028092</IDValue>
</CollectionIdentifier>
<TitleDetail>
<TitleType>01</TitleType>
<TitleElement>
<TitleElementLevel>02</TitleElementLevel>
<TitleText>Serietittel</TitleText>
</TitleElement>
<TitleElement>
<TitleElementLevel>01</TitleElementLevel>
<PartNumber>Serienummer</PartNumber>
</TitleElement>
</TitleDetail>
</Collection>

CollectionType: 10= serie, 20= annen tilknytning
TitleText: serietittel eller navn på annen tilknytning
PartNumber: serienummer eller nummer for leserekkefølge

Onix element læreverk:

<Collection>
<CollectionType>20</CollectionType>
<SourceName>Bokbasen_Schoolbooks</SourceName>
<CollectionIdentifier>
<CollectionIDType>01</CollectionIDType>
<IDTypeName>Bokbasen_ProprietaryID</IDTypeName>
<IDValue>20190605171054147</IDValue>
</CollectionIdentifier>
<TitleDetail>
<TitleType>01</TitleType>
<TitleElement>
<TitleElementLevel>02</TitleElementLevel>
<TitleText>navn på læreverket</TitleText>
</TitleElement>
</TitleDetail>
</Collection>

CollectionType = 20 (annen tilknytning)
SourceName = Bokbasen_Schoolbooks
TitleText = navn på læreverket

Tittel: både hovedtittel og undertittel må vises både i treffliste og på detaljbilde og begge bør være søkbare. Merk at en bok kan ha mer enn én undertittel. Rekkefølgen undertitlene sendes i i Onix er meningsbærende slik at første undertittel skal vises først osv.

Onix-element:

<TitleDetail>
<TitleType>01</TitleType>
<TitleElement>
<SequenceNumber>1</SequenceNumber>
<TitleElementLevel>01</TitleElementLevel>
<TitleText>Hovedtittel</TitleText>
<Subtitle>Undertittel</Subtitle>
</TitleElement>
</TitleDetail>

TitleText = hovedtittel
Subtitle = undertittel

Aktører: rekkefølgen aktørene sendes i i Onix er meningsbærende. Den første aktøren er viktigst, uavhengig av hvilken rolle som er angitt.

Minimum den første aktøren må vises i treffliste og på detaljbilde, uansett hvilken rolle som er tilknyttet.

Videresøk på navn og visning av f.eks. bøker av samme forfatter(e) bør baseres på bruk av Bokbasens aktør-ID

Onix-element:

<Contributor>
<SequenceNumber>1</SequenceNumber>
<ContributorRole>A01</ContributorRole>
<NameType>04</NameType>
<NameIdentifier>
<NameIDType>01</NameIDType>
<IDTypeName>Bokbasen_ProprietaryID</IDTypeName>
<IDValue>669230</IDValue>
</NameIdentifier>
<PersonNameInverted>Etternavn, Fornavn</PersonNameInverted>
</Contributor>

Bla-i-boka: Onix-posten kan inneholde lenke til bla-i-boka. Denne lenka skal vises, eller evt. embeddes i tilknytning til visning av andre metadata som beskriver boka. Kravet gjelder ikke for native apper.

Onix-element:

<SupportingResource>
<ResourceContentType>16</ResourceContentType>
<ContentAudience>00</ContentAudience>
<ResouceMode>06</ResourceMode>
<ResourceVersion>03</ResourceVersion>
<ResourceLink>http://www.lenketilblaiboka.no</ResourceLink>
</ResourceVersion>
</SupportingResource>

ResourceContentType: 16 = bla i boka
ResourceLink: lenke til bla i boka-widget

Sitat fra anmeldelse: Sitat fra anmeldelse kan inneholde kun selve sitatet, men kan også inne holde opplysninger om kilden til sitatet, og terningkast eller annen rating. Kravet gjelder ikke for native apper.

Onix-element:
<TextContent>
<TextType>06</TextType>
<ContentAudience>00</ContentAudience>
<Text>Text</Text>
<ReviewRating>
<Rating>5</Rating>
<RatingLimit>6</RatingLimit>
<RatingUnits>Terningkast</RatingUnits>
</ReviewRating>
<TextAuthor>Kari Nordmann</TextAuthor>
<SourceTitle>VG</SourceTitle
</TextContent>

TextType: 06 = sitat fra anmeldelse
Text: selve sitatet
Rating: terningkast eller annen rating
RatingLimit: maks terningkast e.l. det er mulig å oppnå
RatingUnits: type rating, terningkast e.l.
TextAuthor: person som er sitert
SoucreTitle: kilde som sitatet er hentet fra

Thema
Thema emnekategoriene skal vises i detaljbildet og kan også brukes til å bygge opp en oversikt over kategorier i nettbutikken. Eventuelle videresøk f.eks fra detaljbildet eller kategorioversikt bør baseres på kode og ikke tekst.

Onix-element:
<Subject>
<SubjectSchemeIdentifier>93</SubjectSchemeIdentifier>
<SubjectCode>FF</SubjectCode>
</Subject>

Forhandlere som kun tilbyr læremidler kan i stedet for Thema vise Grep-koder.

Onix-element:

<Subject>
<SubjectSchemeIdentifier>44</SubjectSchemeIdentifier>
<SubjectCode>STUSP1</SubjectCode>
<SubjectHeadingText language="nob">Studiespesialisering</SubjectHeadingText>
</Subject>

43 = Utdanningsprogram
44 = programområde
60 = fag

Sletteposter
Metadatakunder må har rutiner for å slette alle metadata om produkter det sendes slettepost for.

For eksempel på Onix klikk her.

Retningslinjer for oppdatering av metadata
Metadatakunder må hente oppdateringer fra Bokbasen minst hver tredje time, 24 timer i døgnet, alle dager i uken.

Trenger du mer informasjon om dette så hjelper vi deg gjerne! Ta kontakt på post@bokbasen.no

Artikler i denne seksjonen

Kommentarer

Artikler i denne seksjonen

Relaterte artikler