Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
 

Doel

...

Table of Contents
 

Doel

Titelbank stelt aan boekhandels, uitgevers en andere derde partijen titelinformatie beschikbaar in ONIX 3.0 formaat, met het doel dat zij deze titelinformatie kunnen importeren in hun eigen artikeldatabank en/of tonen op hun website. ONIX for Books versie 3.0 is een internationale standaard voor het uitwisselen van titelgegevens die wordt beheerd door Editeur. Dit document beschrijft de functionele specificaties voor ONIX 3.0 product records die komen uit Titelbank.

...


DATA ELEMENT

FIELD

XML REFERENCE NAME

M/O (Onix)

M/O

(TB)

LIST

A|N

POS.

Naam van het veld

Veld zoals gebruikt in de Editeur documentatie

Naam van het veld zoals gebruikt binnen het bericht

Verplicht of optioneel (Mandatory/optional) volgens ONIX

Verplicht of optioneel (Mandatory/Optional) bij titelbank

 Gebruikte ONIX codelijst (indien van toepassing)

 Alfanumeriek of numeriek

Aantal posities 

Opbouw ONIX 3.0 bericht


Message declaration

WIjzigt m.i.v.  

<?xml version="1.0"?>
<ONIXMessage release="3.0" xmlns="http://www.editeur.org/onix/3.0/reference">


<MessageHeader>Identificatie van afzender, berichtnummer en verzendtijdstip

<Product> 



                Record metadata 

Identificatie van het record

Group P.1 

                Product numbers  

Identificatie van het product

Group P.2 

                <DescriptiveDetail> ………… </DescriptiveDetail> 

Beschrijving van de uiterlijke kenmerken van het product zelf en van de content, bibliografische beschrijving, basistitelgegevens

Block 1 

                <CollateralDetail> …………… </CollateralDetail>

Verrijkte titelgegevens, ondersteunende teksten, bestanden en linkjes

Block 2 

                <ContentDetail> ……………… </ContentDetail>

Beschrijving van individuele hoofdstukken uit het product, wordt in Titelbank niet gebruikt

Block 3 

                <PublishingDetail> ………… </PublishingDetail>

Beschrijving van de uitgever, imprint en verschijningsdatum

Block 4 

                <RelatedMaterial> …………… </RelatedMaterial>

Verwijzingen naar gerelateerde producten

Block 5 

                <ProductSupply> ……………… </ProductSupply>

Beschrijft de beschikbaarheid van het product in de markt

Block 6 

 </Product>  

</ONIXMessage>


Message Header - Opbouw Headerrecord


DATA ELEMENT

FIELD

XML REFERENCE NAME

M/O
Onix

M/O
TB

LIST

A | N

POS.

Toelichting


<ONIXMessage release=”3.0”>

M

M


A



Header composite


<Header>

M

M





Sender composite


   <Sender>

M

M





Sender identifier composite


      <SenderIdentifier>

O*

M





Sender identifier type code

H.1

         <SenderIDType>      

M

M

44



Bevat waarde 10 waarmee wordt aangeduid dat <IDValue> een CB_relatie_id betreft

Identifier value

H.3

         < IDValue>

M

M




Wordt gevuld met waarde 8894126, het CB_relatiie_id van CB

Sender name

H.4

      <SenderName>

O

O


A


Wordt gevuld met 'Titelbank'.

Message sequence number

H.13

   <MessageNumber>

O

O


N


Wordt gevuld met volgnummer ONIX bericht

Message creation date/time

H.15

   <SentDateTime>

M

M


A

13

Wordt gevuld met datum/tijd in formaat yyyymmddThhmm


Voorbeeld van MessageHeader Expand source

Het bericht wordt afgesloten met een sluit tag </OnixMessage>.

Opbouw ProductRecord


<Product> 

Toelichting


                Record metadata 

Identificatie van het record

Group P.1 

                Product numbers  

Identificatie van het product

Group P.2 

                <DescriptiveDetail> ………… </DescriptiveDetail> 

Beschrijving van de uiterlijke kenmerken van het product zelf en van de content, bibliografische beschrijving, basistitelgegevens

Block 1 

                <CollateralDetail> …………… </CollateralDetail>

Verrijkte titelgegevens, ondersteunende teksten, bestanden en linkjes

Block 2 

                <ContentDetail> ……………… </ContentDetail>

Beschrijving van individuele hoofdstukken uit het product, wordt in Titelbank niet gebruikt

Block 3 

                <PublishingDetail> ………… </PublishingDetail>

Beschrijving van de uitgever, imprint en verschijningsdatum

Block 4 

                <RelatedMaterial> …………… </RelatedMaterial>

Verwijzingen naar gerelateerde producten

Block 5 

                <ProductSupply> ……………… </ProductSupply>

Beschrijft de beschikbaarheid van het product in de markt

Block 6 

 </Product>  




Record metadata (Group P1 en P2)


DATA ELEMENT

FIELD

XML REFERENCE NAME

M/O
Onix

M/O
TB

LIST

A | N

POS.

Toelichting

Record reference number and type

P.1








Record reference number

P.1.1

<RecordReference>

M

M


A

13

Bevat het ISBN13-EAN

Notification or update type code

P.1.2

<NotificationType>

M

M

1

N


Bevat waarde '03' bij volledig record of waarde '04'bij een block update

 

Als bestaande gegevens zijn verwijderd, ongeacht uit welk blok, dan wordt altijd het volledige record aangeleverd met NotificationType 03.

Als gegevens in een blok zijn gewijzigd, dan wordt altijd het volledige blok aangeleverd met NotificationType 04.

Record source type code

P.1.4

<RecordSourceType>

O

O

3

N


Bevat waarde '01'(Publisher)

Product numbers

P.2








Product identifier composite


<ProductIdentifier>

M

M





Product identifier type code

P.2.1

                <ProductIDType>

M

M

5

N


Bevat waarde '03'(EAN/GTIN-13)

Identifier value

P.2.3

                <IDValue>

M

M


N

13

Bevat het EAN van de titel


RecordReference/ProductIdentifier

 

P1.1. bevat het referentienummer voor het ProductRecord, P. 2.3 bevat de bibliografische identificatie van de titel met bijbehorende metadata. In de ONIX van Titelbank zijn deze twee altijd identiek.

Voorbeeld van RecordReference Expand source

Blok 1 DescriptiveDetail (beschrijvende metadata)

...


DATA ELEMENT

FIELD

XML REFERENCE NAME

M/O
Onix

A/S
CB

LIST

A | N

POS.

Toelichting

Product Composition

P3.1

<ProductComposition>

M

M

2

A

2

Bevat '00' als het een enkelvoudig product betreft of '10'indien het product begeleidend materiaal heeft

Product Form Code

P.3.2

<ProductForm>

M

A

150

A


Code voor de verschijningsvorm van het product

Product Form Detail

P.3.3

<ProductFormDetail>

O

S

175

A

5

Nadere specificaties van de verschijningsvorm van het product (bijvoorbeeld technisch platform bij ebooks)

Product Form Feature Composite


<ProductFormfeature>

O






ProductFormFeatureType Code

P.3.4

<ProductFormFeatureType>

M

A

79

N

2

Wordt gevuld met waarde 10 (alleen bij epubs)

ProductFormFeatureValue

P.3.5

<ProductFormfeatureValue>

M

A


N

1

geeft aan of een epub versie 2 of versie 3 is

Einde ProductFormFeature Composite


</ProductFormFeature>







ProductForm Description

P.3.8

ProductFormdescription

O

S


A

255

Vrij tekstveld t.b.v. omschrijving begeleidend materiaal

Epub technical Protection

P. 3.16

<EpubtechnicalProtection>

O

O

144

N

2

Type beveiliging bij een ebook
Expand
title

...

Klik hier voor

...

 Klik hier voor een lijst van alle codes voor de verschijningsvormen van ebooks

...

mogelijke verschijningsvormen

Include Page
Product Form fysieke boeken
Product Form fysieke boeken

Include Page
Product Form e-books
Product Form e-books

Group P5 Collection

In Group 5 worden de gegevens van de bibliografische reeks opgenomen.

...


DATA ELEMENT

FIELD

XML REFERENCE NAME

M/O
Onix

M/O
TB

LIST

A | N

POS.

Toelichting

Title detail composite


<TitleDetail>

M

M





Title type

P.6.1

                <TitleType>

M

M

15

A


Bevat '01', (Distinctive Title), of '03', (Original title)

Title element composite


                <TitleElement>

M

M





Title element level

P.6.2

                <TitleElementLevel>

M

M

149

A


Bevat '01', '02' of '03'Bij . Bij meerdere <TitleElementLevels> wordt de <TitleElementLevel> composite herhaald

Bij product met alleen hoofdtitel: : '01' geeft aan dat in <TitleText> de hoofdtitel staat

Bij product met hoofdtitel en deeltitel: '02' geeft aan dan in <TitleText> de hoofdtitel staat, '01'geeft aan dat in <TitleText> de deeltitel staat

Bij product met hoofdtitel, deeltitel en sectietitel: '02' geeft aan dan in <TitleText> de hoofdtitel staat, '01'geeft aan dat in <TitleText> de secteititel staat en '03' geeft aan dat in <TitleText> de deeltitel staat

De <Subtitle> staat altijd op het zelfde <TitleElementLevel> als de hoofdtitel

Title text

P.6.5

                               <TitleText>

O

M


A

2000

Bevat de tekst van de titel

Subtitle

P.6.8

                               <Subtitle>

O

O


A

2000

Ondertitel

Einde Title element Composite


                </TitleElement>

M

M





Einde Title detail composite

P.6.5

</TitleText>

M

M


A



Include Page
Title detail - Bibliografische titel composite template (uitgaand)
Title detail - Bibliografische titel composite template (uitgaand)


...