ONIX 3.0 Titelbank

ONIX 3.0 Titelbank

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.

Uitgangsdocumentatie

De Titelbank ONIX 3.0 bestanden zijn opgebouwd conform de hieronder genoemde specificaties van Editeur: 

ONIX for Books Release 3.0.0, april 2009, including:

  • Product Information Format Specification

  • Product Information Format Data Element Summary

  • Product Information Format XML Technical Notes

ONIX Books Code Lists Issue 19, October 24, 2012

Aankondiging: Wijzigingen in ONIX Titelbank m.i.v. 06-04-2020

Release 3.0 
Revision 6 
Status: RELEASED

Release date: 2009-04-09 
Revised: 2019-04-26 


Toelichting
Message declarationNamespace aangepast naar http://ns.editeur.org/onix/3.0/reference
P.5.8 - P.5.10In TitelElement composite wordt element P.5.8 Part Number opgenomen voor het element P.5.10
P.7.2ContributorRole waarde A13 (Fotograaf) toegevoegd
P.7.12 - P.7.14In het Contributor Composite worden elementen P.7.12 NamesBeforeKey en P.7.13 PrefixToKey alleen opgenomen indien er ook een P.7.14 KeyNames aanwezig is
P.9.2 - P.9.3P.9.3 EditionVersionNumber zal alleen opgenomen worden als er ook een P.9.2 EditionNumber is
P.14.4In het TextContent composite met TextType waarde 06 wordt element TextAuthor niet meer opgenomen als de auteur van de recensie niet bekend is
P.14.7 - P.14.9In het TextContent composite met TextType waarde 06 wordt het ContentDate composite niet meer opgenomen als de datum waarop de recensie is geschreven niet bekend is
P.15.4CitedContent composite zal niet meer opgenomen worden als P.15.4 SourceTitle niet bekend is
P.20.1Element PublishingStatus zal in ieder Product record opgenomen worden.  PublishingStatus waarde 99 is vervangen door PublishingStatus 00
P.26.70aElement UnpricedItemType met waarde 01 toegevoegd. Voor een ISBN zonder prijs zal geen Price composite worden opgenomen 
P.26.71In het Price composite is element CurrencyCode toegevoegd, de standaard waarde is EUR

Structuur ONIX 3.0 bericht

Een standaard Onix-bericht is een XML bestand dat is opgedeeld in een Header record, een Product record - welke  weer is opgedeeld in blokken -   en binnen de records in composites. Een composite is een groepering van verwante velden (data elements). Een composite kan ook andere, onderliggende composites bevatten. Deze handleiding volgt de groepering van verwante velden en composites zoals beschreven in ONIX for Books, release 3.0, April 2009.

Voor elk besproken veld (data element) van het bestand worden in een tabel volgende punten aangegeven:

 

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. May 4, 2020 

<?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 ONIXMessage Header
<ONIXMessage release="3.0" xmlns="http://www.editeur.org/onix/3.0/reference"> <Header> <Sender> <SenderIdentifier> <SenderIDType>10</SenderIDType> <IDValue>8894126</IDValue> </SenderIdentifier> <SenderName>Titelbank</SenderName> </Sender> <MessageNumber>4909</MessageNumber> <SentDateTime>20200112T2200</SentDateTime> </Header>

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>  

 

 

Volledig Product record
<Product> <RecordReference>9789065507808</RecordReference> <NotificationType>04</NotificationType> <RecordSourceType>01</RecordSourceType> <ProductIdentifier> <ProductIDType>03</ProductIDType> <IDValue>9789065507808</IDValue> </ProductIdentifier> <DescriptiveDetail> <ProductComposition>00</ProductComposition> <ProductForm>BA</ProductForm> <Collection> <CollectionType>10</CollectionType> <TitleDetail> <TitleType>01</TitleType> <TitleElement> <TitleElementLevel>02</TitleElementLevel> <PartNumber>3</PartNumber> <TitleText>Zoekreeks</TitleText> </TitleElement> </TitleDetail> </Collection> <TitleDetail> <TitleType>01</TitleType> <TitleElement> <TitleElementLevel>01</TitleElementLevel> <TitleText>Op zoek naar een biografisch portret in het verleden</TitleText> </TitleElement> </TitleDetail> <Contributor> <SequenceNumber>1</SequenceNumber> <ContributorRole>A01</ContributorRole> <PersonName>K. van der Wiel</PersonName> <NamesBeforeKey>K.</NamesBeforeKey> <PrefixToKey>van der</PrefixToKey> <KeyNames>Wiel</KeyNames> </Contributor> <Contributor> <SequenceNumber>2</SequenceNumber> <ContributorRole>B01</ContributorRole> <PersonName>K. Bossaers</PersonName> <NamesBeforeKey>K.</NamesBeforeKey> <KeyNames>Bossaers</KeyNames> </Contributor> <Contributor> <SequenceNumber>3</SequenceNumber> <ContributorRole>B01</ContributorRole> <PersonName>J. Brugman</PersonName> <NamesBeforeKey>J.</NamesBeforeKey> <KeyNames>Brugman</KeyNames> </Contributor> <Contributor> <SequenceNumber>4</SequenceNumber> <ContributorRole>B01</ContributorRole> <PersonName>J. Knoester</PersonName> <NamesBeforeKey>J.</NamesBeforeKey> <KeyNames>Knoester</KeyNames> </Contributor> <EditionNumber>1</EditionNumber> <Language> <LanguageRole>01</LanguageRole> <LanguageCode>dut</LanguageCode> </Language> <Extent> <ExtentType>00</ExtentType> <ExtentValue>123</ExtentValue> <ExtentUnit>03</ExtentUnit> </Extent> <Illustrated>02</Illustrated> <Subject> <MainSubject/> <SubjectSchemeIdentifier>32</SubjectSchemeIdentifier> <SubjectCode>681</SubjectCode> </Subject> </DescriptiveDetail> <PublishingDetail> <Publisher> <PublishingRole>01</PublishingRole> <PublisherIdentifier> <PublisherIDType>10</PublisherIDType> <IDValue>7300840</IDValue> </PublisherIdentifier> <PublisherName>Verloren b.v., uitgeverij</PublisherName> </Publisher> <PublishingStatus>08</PublishingStatus> <PublishingDate> <PublishingDateRole>01</PublishingDateRole> <DateFormat>00</DateFormat> <Date>20030101</Date> </PublishingDate> </PublishingDetail> <RelatedMaterial/> <ProductSupply> <SupplyDetail> <Supplier> <SupplierRole>00</SupplierRole> <SupplierName>TitelBank</SupplierName> </Supplier> <ProductAvailability>99</ProductAvailability> <Price> <PriceType>02</PriceType> <PriceAmount>19</PriceAmount> </Price> </SupplyDetail> </ProductSupply> </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

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.

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

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.

Blok 1 DescriptiveDetail (beschrijvende metadata)

Group P3 ProductForm

 

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

Voor een fysiek (gedrukt) boek wordt de verschijningsvorm in het ONIX 3.0 bericht gedefinieerd door de ProductForm.  Voor een e-book wordt de verschijningsvorm in het ONIX 3.0 bericht gedefinieerd door de combinatie van de tags ProductForm, ProductFormDetail, ProductFormFeature en EpubTechnicalProtection

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)