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
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 Headerrecord
DATA ELEMENT | FIELD | XML REFERENCE NAME | M/O | M/O | 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 |
<?xml version="1.0"?> <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>3719</MessageNumber> <SentDateTime>20170112T2200</SentDateTime> </Header>
Het bericht wordt afgesloten met een sluit tag </OnixMessage>.
Opbouw ProductRecord
<Product> |
|
Record metadata | Group P.1 |
Product numbers | Group P.2 |
<DescriptiveDetail> ………… </DescriptiveDetail> | Block 1 |
<CollateralDetail> …………… </CollateralDetail> | Block 2 |
<ContentDetail> ……………… </ContentDetail> | Block 3 |
<PublishingDetail> ………… </PublishingDetail> | Block 4 |
<RelatedMaterial> …………… </RelatedMaterial> | Block 5 |
<ProductSupply> ……………… </ProductSupply> | Block 6 |
</Product> |
|
Record metadata (Group P1 en P2)
DATA ELEMENT | FIELD | XML REFERENCE NAME | M/O | M/O | LIST | A | N | POS. | Toelichting |
P.1 Record reference number and type |
|
|
|
|
|
|
| |
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) | |
P.2 Product numbers |
|
|
|
|
|
|
| |
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.
<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 | A/S | 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 |
<DescriptiveDetail> <ProductComposition>00</ProductComposition> <ProductForm>ED</ProductForm> <ProductFormDetail>E101</ProductFormDetail> <ProductFormFeature> <ProductFormFeatureType>10</ProductFormFeatureType> <ProductFormFeatureValue>2</ProductFormFeatureValue> </ProductFormFeature> <EpubTechnicalProtection>02</EpubTechnicalProtection>
Group P4 Product Part (wordt niet gebruikt in Titelbank)
Group P5 Collection
In Group 5 worden de gegevens van de bibliografische reeks opgenomen.
DATA ELEMENT | FIELD | XML REFERENCE NAME | M/O | M/O | LIST | A | N | POS. | Toelichting |
Collection composite | <Collection> | O | O | |||||
Collection type code | P.5.1 | <CollectionType> | M | M | 148 | A | 2 | Bevat '10'(Publishers collection) |
Title detail composite | <TitleDetail> | O | O | |||||
Title type | P.5.6 | <TitleType> | M | M | 15 | A | 2 | Bevat '01'(distinctive title) |
Title elementcomposite | <TitleElement> | M | M | |||||
Title element level | P.5.7 | <TitleElementLevel> | M | M | 149 | A | 2 | Bevat '02' (Collection) |
Part number | P.5.8 | <PartNumber> | O | O | N | 1020 | Bevat het nummer van het betreffende deel uit de reeks | |
Title text | P.5.10 | <TitleText> | M | M | A | 1020 | Bevat de reeksnaam | |
No collection (empty element) | P.5.62 | <NoCollection/> | O | O | Wordt opgenomen indien de titel geen onderdeel uitmaakt van een reeks |
<Collection> <CollectionType>10</CollectionType> <TitleDetail> <TitleType>01</TitleType> <TitleElement> <TitleElementLevel>02</TitleElementLevel> <TitleText>F.C. De Kampioenen</TitleText> </TitleElement> </TitleDetail> </Collection>
<DescriptiveDetail> <ProductComposition>00</ProductComposition> <ProductForm>BB</ProductForm> <NoCollection/>
Group P6 Title
DATA ELEMENT | FIELD | XML REFERENCE NAME | M/O | M/O | 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 | |
Title element composite | <TitleElement> | M | M | |||||
Title element level | P.6.2 | <TitleElementLevel> | M | M | 149 | A | Bevat '01', '02'of '03' | |
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 |
|
Indien de publikatie waarover de gegevens gaan alleen een hoofdtitel heeft, wordt de TitleDetail composite als volgt gevuld:
- <TitleDetail>
- P.6.1 <TitleType> Bevat ‘01’ (Distinctive title), uit Code List 15.
- <TitleElement>
- P.6.2 <TitleElementLevel> Bevat ‘01’ (Product)
- P.6.5 <TitleText> Bevat de hoofdtitel
Indien de publicatie waarover de gegevens gaan een hoofdtitel en een ondertitel heeft, wordt de TitleDetail composite als volgt gevuld:
- <TitleDetail>
- P.6.1 <TitleType> Bevat ‘01’ (Distinctive title), uit Code List 15.
- <TitleElement>
- P.6.2 <TitleElementLevel> Bevat ‘01’ (Product)
- P.6.5 <TitleText> Bevat de hoofdtitel
- P.6.8 <Subtitle> Bevat de ondertitel
Indien de publicatie waarover de gegevens gaan een hoofdtitel en een deeltitel heeft, wordt de TitleDetail composite als volgt gevuld;
- <TitleDetail>
- P.6.1 <TitleType> Bevat ‘01’ (Distinctive title), uit Code List 15.
- <TitleElement>
- P.6.2 <TitleElementLevel> Bevat ‘01’ (Product)
- P.6.5 <TitleText> Bevat de deeltitel
- P.6.2 <TitleElementLevel> Bevat ‘02’ (Collection)
- P.6.5 <TitleText> Bevat de hoofdtitel
Indien de publicatie waarover de gegevens gaan een hoofdtitel , een deelnummer en een deeltitel heeft, wordt de TitleDetail composite als volgt gevuld;
- <TitleDetail>
- P.6.1 <TitleType> Bevat ‘01’ (Distinctive title), uit Code List 15.
- <TitleElement>
- P.6.2 <TitleElementLevel> Bevat ‘01’ (Product)
- P.6.3 <PartNumber> Bevat het deelnummer
- P.6.5 <TitleText> Bevat de deeltitel
- P.6.2 <TitleElementLevel> Bevat ‘02’ (Collection)
- P.6.5 <TitleText> Bevat de hoofdtitel
Indien de publicatie waarover de gegevens gaan een hoofdtitel , een deelnummer en een deeltitel en een sectietitel heeft, wordt de TitleDetail composite als volgt gevuld;
- <TitleDetail>
- P.6.1 <TitleType> Bevat ‘01’ (Distinctive title), uit Code List 15.
- <TitleElement>
- P.6.2 <TitleElementLevel> Bevat ‘01’ (Product)
- P.6.5 <TitleText> Bevat de sectietitel
- P.6.2 <TitleElementLevel> Bevat ‘02’ (Collection)
- P.6.5 <TitleText> Bevat de hoofdtitel
- P.6.2 <TitleElementLevel> Bevat ‘03’ (Subcollection)
- P.6.3 <PartNumber> Bevat het deelnummer
- P.6.5 <TitleText> Bevat de deeltitel
Indien de publicatie waarover de gegevens gaan een hoofdtitel , een ondertitel en een deeltitel heeft, wordt de TitleDetail composite als volgt gevuld;
- <TitleDetail>
- P.6.1 <TitleType> Bevat ‘01’ (Distinctive title), uit Code List 15.
- <TitleElement>
- P.6.2 <TitleElementLevel> Bevat ‘01’ (Product)
- P.6.5 <TitleText> Bevat de deeltitel
- P.6.2 <TitleElementLevel> Bevat ‘02’ (Collection)
- P.6.5 <TitleText> Bevat de hoofdtitel
- P.6.8 <Subtitle> Bevat de ondertitel
Indien de publicatie waarover de gegevens gaan een hoofdtitel , een sectietitel, een deelnummer en een deeltitel heeft, wordt de TitleDetail composite als volgt gevuld;
- <TitleDetail>
- P.6.1 <TitleType> Bevat ‘01’ (Distinctive title), uit Code List 15.
- <TitleElement>
- P.6.2 <TitleElementLevel> Bevat ‘01’ (Product)
- P.6.5 <TitleText> Bevat de sectietitel
- P.6.2 <TitleElementLevel> Bevat ‘02’ (Collection)
- P.6.5 <TitleText> Bevat de hoofdtitel
- P.6.8 <Subtitle> Bevat de ondertitel
- P.6.2 <TitleElementLevel> Bevat ‘03’ (Subcollection)
- P.6.5 <TitleText> Bevat de deeltitel
Indien de publicatie waarover de gegevens gaan een hoofdtitel , een ondertitel , een sectietitel en een deeltitel en een deelnummer heeft, wordt de TitleDetail composite als volgt gevuld;
- <TitleDetail>
- P.6.1 <TitleType> Bevat ‘01’ (Distinctive title), uit Code List 15.
- <TitleElement>
- P.6.2 <TitleElementLevel> Bevat ‘01’ (Product)
- P.6.5 <TitleText> Bevat de sectietitel
- P.6.2 <TitleElementLevel> Bevat ‘02’ (Collection)
- P.6.5 <TitleText> Bevat de hoofdtitel
- P.6.8 <Subtitle> Bevat de ondertitel
- P.6.2 <TitleElementLevel> Bevat ‘03’ (Subcollection)
- P.6.3 <PartNumber> Bevat het deelnummer
- P.6.5 <TitleText> Bevat de deeltitel