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 abonnementstjenester (strømming) eller apper som tilbyr kjøp i app.

Å 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
• Krav om visning i trefflister gjelder ikke apper, men det er anbefalt

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.

Krav om visning i treffliste gjelder ikke apper, men det er anbefalt.

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

<Subject>
<SubjectSchemeIdentifier>60</SubjectSchemeIdentifier>
<SubjectCode>PSP5067</SubjectCode>
<SubjectHeadingText language="nob">Tysk, nivå I</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