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 Books Code Lists Issue 19, October 24, 2012

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.

...

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

...

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

M

A

13

Bevat het ISBN13-EAN

Notification or update type code

P.1.2

M

1

N

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

Note

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

O

3

N

Bevat waarde '01'(Publisher)

P.2 Product numbers

Product identifier composite

M

Product identifier type code

P.2.1

M

5

N

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

Identifier value

P.2.3

M

N

13

Bevat het EAN van de titel

...

Code Block

language	xml
title	Voorbeeld van RecordReference
collapse	true

 <Product>
		<RecordReference>9789065501318</RecordReference>
		<NotificationType>04</NotificationType>
		<RecordSourceType>01</RecordSourceType>
		<ProductIdentifier>
			<ProductIDType>03</ProductIDType>
			<IDValue>9789065501318</IDValue>
		</ProductIdentifier>

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

...

Code Block

language	xml
title	Voorbeeld van Product compositie en verschijningsvorm
collapse	true

<DescriptiveDetail>
			<ProductComposition>00</ProductComposition>
			<ProductForm>ED</ProductForm>
			<ProductFormDetail>E101</ProductFormDetail>
			<ProductFormFeature>
				<ProductFormFeatureType>10</ProductFormFeatureType>
				<ProductFormFeatureValue>2</ProductFormFeatureValue>
			</ProductFormFeature>
			<EpubTechnicalProtection>02</EpubTechnicalProtection>

Group

...

P5 Collection

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

...

Code Block

language	xml
title	Voorbeeld van 'Geen reeks' vermelding
collapse	true

<DescriptiveDetail>
			<ProductComposition>00</ProductComposition>
			<ProductForm>BB</ProductForm>
			<NoCollection/>

Group P6 Title

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

...

Code Block

language	xml
title	Voorbeeld van Hoofdtitel, ondertitel, deeltitel en sectietitel
collapse	true

<TitleDetail>
				<TitleType>01</TitleType>
				<TitleElement>
					<TitleElementLevel>01</TitleElementLevel>
					<TitleText>Werkboek VWO</TitleText>
				</TitleElement>
				<TitleElement>
					<TitleElementLevel>02</TitleElementLevel>
					<TitleText>De Geo Aarde</TitleText>
					<Subtitle>aardrijkskunde voor de bovenbouw havo en vwo</Subtitle>
				</TitleElement>
				<TitleElement>
					<TitleElementLevel>03</TitleElementLevel>
					<TitleText>Klimaatvraagstukken</TitleText>
				</TitleElement>
			</TitleDetail>

Group P7 Authorship

Binnen de zgn. Contributor Composite’ wordt informatie gegeven overr degenen die een bijdrage hebben geleverd aan de publikatie en die als zodanig in de publikatie worden genoemd , de zgn. “auteursvermeldingen”.; Tevens wordt aangegeven in welke rol zij hun bijdrage hebben geleverd, bijvoorbeeld auteurs, samenstellers, illustratoren. Dit kunnen zowel personen zijn als bedrijven, organisaties of instanties (corporaties).

...

Code Block

language	xml
title	Voorbeeld van Betrokkene vermelding
collapse	true

<Contributor>
				<SequenceNumber>2</SequenceNumber>
				<ContributorRole>B06</ContributorRole>
				<PersonName>Rob de Ridder</PersonName>
				<NamesBeforeKey>Rob</NamesBeforeKey>
				<PrefixToKey>de</PrefixToKey>
				<KeyNames>Ridder</KeyNames>
			</Contributor>

Group P9 Edition

De taal waarin het boek is geschreven wordt vastgelegd in de Language Composite.. In het veld Language Code wordt de ISO 6239-2/B taalkode vastgelegd, deze komt uit Lijst74. Titelbank zal echter maximaal 1 taal aanleveren. Wanneer een titel meerdere hoofdtalen heeft, wordt MUL (=Multiple languages) gebruikt

...

Code Block

language	xml
title	Voorbeeld van EditionStatement
collapse	true

<EditionStatement>Heruitgave</EditionStatement>

Group P10 Language

DATA ELEMENT	FIELD	XML REFERENCE NAME	M/O Onix	M/O TB	LIST	A \| N	POS.	Toelichting
Language composite		<Language>	O	M
Language role	P.10.1	<LanguageRole>	M	M	22	A		Bevat '01' (language of text)
Language code	P.10.2	<LanguageCode>	M	M	74	A	3	Bevat de taalcode van de taal waarin het boek is geschreven

...

Code Block

title	Language
collapse	true

<Language>
				<LanguageRole>01</LanguageRole>
				<LanguageCode>dut</LanguageCode>
</Language>

Group P11 Extents and other contents

DATA ELEMENT	FIELD	XML REFERENCE NAME	M/O Onix	M/O TB	LIST	A \| N	POS.	Toelichting
Extent composite		<Extent>	O	O
Extent type code	P.11.1	<ExtentType>	M	M	23			Bevat '00', main content page count
Extent value	P.11.2	<ExtentValue>	O	M		A	20	Bevat het aantal pagina's
Extent value in Roman numerals	P.11.3	<ExtentValueRoman>	O	O		A	20
Extent unit	P.11.4	<ExtentUnit>	M	M	24
Extent composite		<Extent>	O	O
Extent type code	P.11.1	<ExtentType>	M	M	23
Extent value	P.11.2	<ExtentValue>	O	M		A	50
Extent unit	P.11.4	<ExtentUnit>	M	M	24
End of extent composite		</Extent>
Illustrated / not illustrated flag	P.11.5	<Illustrated>	O	M	152			Bevat '01 als het boek niet is geillustreerd en '02'als het boek wel is geillustreerd

Code Block

language	xml
title	Voorbeeld van Extent and illustrated/not illustrated
collapse	true

<Extent>
				<ExtentType>00</ExtentType>
				<ExtentValue>320</ExtentValue>
				<ExtentUnit>03</ExtentUnit>
			</Extent>
			<Illustrated>01</Illustrated>

Group 12 Subject

DATA ELEMENT	FIELD	XML REFERENCE NAME	M/O Onix	M/O TB	LIST	A \| N	POS.	Toelichting
Subject composite		<Subject>	O	M
Main subject flag	P.12.1	<MainSubject/>	O	M				Geeft bij meerdere voorkomens van een zelfde subjectcode aan dat dit de 'hoofd' code betreft
Subject scheme identifier	P.12.2	<SubjectSchemeIdentifier>	M	M	27			Bevat '32' in geval dat de subject code een NUR is en '20' in geval dat er trefwoorden worden gecommuniceerd
Subject code	P.12.5	<SubjectCode>	O	M		A	5
SubjectHeadingText		<SubjectHeadingText>	O	O		S		Er kunnen meerdere trefwoorden worden aangeleverd in 1 <Subject. De verschillende trefwoorden zijn dan van elkaar gescheiden door een ;

...

Code Block

language	xml
title	Voorbeeld van trefwoord
collapse	true

<Subject>
				<SubjectSchemeIdentifier>20</SubjectSchemeIdentifier>
				<SubjectHeadingText>dieet</SubjectHeadingText>
</Subject>

Group 14 Audience

Wordt aangeleverd als er een AVI-code is opgenomen.

...

Expand

title	Klik hier voor een lijst van AVI-codes

Include Page

	AVI-code
	AVI-code

Blok 2 CollateralDetail

Dit blok bevat verrijkte titelinformatie in de vorm van teksten, bestanden en linkjes.

Group P14 Descriptions and other text

Bevat ondersteunende teksten.

...

Code Block

language	xml
title	Voorbeeld van Recensie in tekstvorm
collapse	true

<TextContent>
				<TextType>06</TextType>
				<ContentAudience>03</ContentAudience>
				<Text>&quot;Ik hoop dat haar onderzoek bij Sociale Zaken en in de werkloosheidsbranche goed wordt gelezen: wek geen valse illusies, kweek geen losers. Wees er vroeg bij, help mensen voordat moedeloosheid, wantrouwen en zelfhaat toeslaan.&quot; [Aleid Truijens in &apos;de Volkskrant&apos;]</Text>
				<TextAuthor>Aleid Truijens</TextAuthor>
				<TextSourceCorporate>Volkskrant</TextSourceCorporate>
				<SourceTitle>Het gelijkheidsideaal wrijft bij werklozen zout in de wonden.</SourceTitle>
				<ContentDate>
					<ContentDateRole>01</ContentDateRole>
					<DateFormat>00</DateFormat>
					<Date>20160618</Date>
				</ContentDate>
			</TextContent>

Group P15 Cited content

Bevat links naar recensies van derde partijen waar mogelijk copyright op rust. Daarom moet de auteur en de bron vermeld worden.

...

Code Block

language	xml
title	Voorbeeld van Link naar recensie
collapse	true

<CitedContent>
				<CitedContentType>01</CitedContentType>
				<SourceType>02</SourceType>
				<SourceTitle>‘Succes wordt toegeschreven aan talent en inspanning. Falen aan onvermogen’</SourceTitle>
				<ResourceLink>http://www.newscientist.nl/nieuws/15060/</ResourceLink>
				<ContentDate>
					<ContentDateRole>01</ContentDateRole>
					<DateFormat>00</DateFormat>
					<Date>20160713</Date>
				</ContentDate>
			</CitedContent>

Group P16 Links to supporting resources

Bevat verwijzingen naar ondersteunende bestanden. Deze bestanden zijn opgenomen in de zip file die ook het ONIX bestand bevat.

...

Code Block

language	xml
title	Voorbeeld van Link naar front cover
collapse	true

<SupportingResource>
				<ResourceContentType>01</ResourceContentType>
				<ContentAudience>03</ContentAudience>
				<ResourceMode>03</ResourceMode>
				<ResourceVersion>
					<ResourceForm>01</ResourceForm>
					<ResourceLink>9789082186994_VRK.jpg</ResourceLink>
				</ResourceVersion>
</SupportingResource>

Blok 4 PublishingDetail

Group P19 Publisher

DATA ELEMENT	FIELD	XML REFERENCE NAME	M/O Onix	M/O TB	LIST	A \| N	POS.	Toelichting
Imprint or brand composite		<Imprint>	O	O
Imprint name	P.19.4	<ImprintName>	O	M		A	80	Uitgeversnaam/merknaam zoals in/op het product vermeld staat
End of Imprint or brand composite		</Imprint>
Publisher composite		<Publisher>	O	O
Publishing role code	P.19.5	<PublishingRole>	M	M	45			Is gevuld met '01', huidige uitgever
Publisher identifiercomposite		<PublisherIdentifier>	O	M
Publisher identifier type	P.19.6	<PublisherIDType>	M	M	44			Is gevuld met '10', wat aangeeft dat in IDValue het CB_relatie_id van de prefixhouder staat
Identifier value	P.19.8	<IDValue>	M	M		N	7
End of publisher ideifier composite		</PublisherIdentifier>
Publisher name		<PublisherName>						Naam van de uitgever
End of publisher composite		</Publisher>

Code Block

language	xml
title	Voorbeeld van Publisher composite
collapse	true

<PublishingDetail>
			<Imprint>
				<ImprintName>Stichting de Driehoek</ImprintName>
			</Imprint>
			<Publisher>
				<PublishingRole>01</PublishingRole>
				<PublisherIdentifier>
					<PublisherIDType>10</PublisherIDType>
					<IDValue>9763559</IDValue>
				</PublisherIdentifier>
				<PublisherName>Driehoek, Stichting De</PublisherName>
			</Publisher>

Group P20 Global publishing status and copyright

...

DATA ELEMENT	FIELD	XML REFERENCE NAME	M/O Onix	M/O TB	LIST	A \| N	POS.	Toelichting
Global publishing status	P.20.1	<PublishingStatus>	O	O	64	A		Is gevuld met waarde '04' (Verkrijgbaar)
Publishing date composite		<PublishingDate>	O	O
Publishing date role code	P.20.3	<PublishingDateRole>	M	M	163	A		Is gevuld met waarde '01' (Verschijningsdatum)
Date format	P.20.4	<DateFormat>	M	M	55	A		Is gevuld met waarde '00', YYYYMMDD
Date	P.20.5	<Date>	M	M		N	4	De (vermoedelijke) verschijningsdatum van de titel

Code Block

language	xml
title	Voorbeeld van Verschijningsdatum
collapse	true

<PublishingStatus>04</PublishingStatus>
			<PublishingDate>
				<PublishingDateRole>01</PublishingDateRole>
				<DateFormat>00</DateFormat>
				<Date>20160610</Date>
			</PublishingDate>

Blok 5 RelatedMaterial

DATA ELEMENT	FIELD	XML REFERENCE NAME	M/O Onix	M/O TB	LIST	A \| N	POS.	Toelichting
Related material		<RelatedMaterial>	O	O
Related work		<RelatedWork>	O	O
Work relation code		<WorkRelationCode>	M	M				Is gevuld met waarde 01 (Manifestation of)
Workidentifier		<WorkIdentifier>	M	M
Work ID Type		<WorkIDType>	M	M	16	N	2	Is gevuld met waarde 01 (proprietary)
ID Type Name		<IDTypeName>	M	M		A	4	Is gevuld met 'NSTC'
ID Value		<IDValue>	M	M		N	9	Het NSTC
End of workidentifier composite		</Workidentifier>
End of Related work composite		</RelatedWork>
Related product composite		<RelatedProduct>	O	O
Relation code	P.23.1	<ProductRelationCode>	M	M	51			Indien artikel x wordt vervangen door artikel y wordt bij het Productrecord van artikel x ProductRelationCode '05'opgenomen
Product identifier composite		<ProductIdentifier>	O	O
Product identifier type code	P.23.2	<ProductIDType>	M	M	5			Is gevuld met '03'(EAN-GTIN-13)
Identifier value	P.23.4	<IDValue>	M	M		A	13	Het EAN-GTIN-13)
End of Related product composite		</RelatedProduct>
End of Related mtaerial composite		</RelatedMaterial>

...

Code Block

language	xml
title	Voorbeeld van Vervanger
collapse	true

<RelatedMaterial>
	<RelatedProduct>
          <ProductRelationCode>05</ProductRelationCode>
          <ProductIdentifier>
	      <ProductIDType>03</ProductIDType>
	      <IDValue>9789043022583</IDValue>
          </ProductIdentifier>
	</RelatedProduct>
</RelatedMaterial>

Blok 6 ProductSupply

DATA ELEMENT	FIELD	XML REFERENCE NAME	M/O Onix	M/O TB	LIST	A \| N	POS.	Toelichting
Product supply		<ProductSupply>
Supply detail composite		<SupplyDetail>	M	O
Supplier composite		<Supplier>	M	M
Supplier role	P.26.1	<SupplierRole>	M	M	93			Is gevuld met '00'(unspecified)
Supplier name	P.26.5	<SupplierName>	O	O				Is gevuld met 'Titelbank'
End of supplier composite		</Supplier>
Product availability	P.26.17	<ProductAvailability>	M	M	65			Is gevuld met '20'(Verkrijgbaar) of '99'(Onbekend)
Price composite		<Price>	O	M
Price type code	P.26.43	<PriceType>	M	M	58			Is gevuld met '02'(consumentenadviesprijs)
Price amount	P.26.62	<PriceAmount>	M	M		N	6	Is gevuld met het bedrag
End of Price composite		</Price>
End of Supply detail composite		</SupplyDetail>
End of ProductSupply composite		</ProductSupply>

...

Versions Compared

Old Version 32

New Version 33

Key

Uitgangsdocumentatie

Structuur ONIX 3.0 bericht

Opbouw Headerrecord

Opbouw ProductRecord

Record metadata (Group P1 en P2)

Blok 1 DescriptiveDetail (beschrijvende metadata)

Group P3 ProductForm

Group

P5 Collection

Group P6 Title

Group P7 Authorship

Group P9 Edition

Group P10 Language

Group P11 Extents and other contents

Group 12 Subject

Group 14 Audience

Blok 2 CollateralDetail

Group P14 Descriptions and other text

Group P15 Cited content

Group P16 Links to supporting resources

Blok 4 PublishingDetail

Group P19 Publisher

Group P20 Global publishing status and copyright

Blok 5 RelatedMaterial

Blok 6 ProductSupply

Page Comparison

Versions Compared

Old Version 32

New Version 33

Key

Uitgangsdocumentatie

Structuur ONIX 3.0 bericht

Opbouw Headerrecord

Opbouw ProductRecord

Record metadata (Group P1 en P2)

Blok 1 DescriptiveDetail (beschrijvende metadata)

Group P3 ProductForm

Group

P5 Collection

Group P6 Title

Group P7 Authorship

Group P9 Edition

Group P10 Language

Group P11 Extents and other contents

Group 12 Subject

Group 14 Audience

Blok 2 CollateralDetail

Group P14 Descriptions and other text

Group P15 Cited content

Group P16 Links to supporting resources

Blok 4 PublishingDetail

Group P19 Publisher

Group P20 Global publishing status and copyright

Blok 5 RelatedMaterial

Blok 6 ProductSupply