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å sine nettsteder.

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

Retningslinjer for bruk av metadatapostenes innhold

Følgende metadatafelt må vises i treffliste og/eller 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.

• 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>Serietittel</PartNumber>
  </TitleElement>
  </TitleDetail>
  </Collection>
  
  
  • CollectionType: 10= serie, 20= annen tilknytning
  • TitleText: serietittel eller navn på annen tilknytning
  • PartNumber: serienummer eller nummer for leserekkefølge

• 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.
  
  
  • 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
  
  
  • Onix-element:
    
    <TextContent>
    <TextType>06</TextType>
    <ContentAudience>00</ContentAudience>
    <Text>Sitat</Text>
    </TextContent>
    
    
    • TextType: 06 = sitat fra anmeldelse
    • Text: selve sitatet

• Terningkast eller annen rating fra anmeldelser
  
  
  • Onix-element:
    
    <CitedContent>
    <CitedContentType>01</CitedContentType>
    <ReviewRating>
    <Rating>4</Rating>
    <RatingLimit>6</RatingLimit>
    <RatingUnits language = “nob”>Terningkast</RatingUnits>
    </Rating>
    <SourceTitle>VG</SourceTitle>
    </CitedContent>
    
    
    • RatingUnits: angir hvilken skala som er brukt, f.eks. terningkast, hjerter eller stjerner
    • Rating: det terningkastet e.l. som boka har fått
    • RatingLimit: maks score det er mulig å oppnå
    • SourceTitle: hvem som har gitt vurderinga

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>
  
  

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