| 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"?> | |
| <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 | 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 |
| Code Block | ||||
|---|---|---|---|---|
|
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
| |||
<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> |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<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 | M/O | 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.
Blok 1 DescriptiveDetail (beschrijvende metadata)
...