gebruikershandleiding ONIX 3.0
Versie 3.1 11 maart 2013
2 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
Inhoudsopgave 1.
2.
3.
4. 5.
6.
INLEIDING 1.1. Opbouw document 1.2. Uitgangsdocumentatie Opbouw ONIX bericht 2.1. Toelichting 2.2. Headerrecord 2.2.1. Sender composite , Sender name 2.2.2. Addressee composite, Addressee identifier composite 2.3. Product record 2.4. Group P.1 (Record reference number, type and source ) en P.2 2.4.1. P1.1 Record reference number 2.4.2. P1.2 Notification or update type code 2.4.3. P1.4 Record source type code 2.4.4. De Product identifier composite 2.5. BLOCK 1 DescriptiveDetail 2.5.1. Group P.3 Product form 2.5.2. Group 4 Product Part (wordt niet gebruikt in Titelbank) 2.5.3. Group P.5 Collection 2.5.4. Group P.6 Title 2.5.5. Group P.7 Authorship 2.5.6. Group P.9 Edition 2.5.7. Group P.10 Language 2.5.8. Group P.11 Extents and other content 2.5.9. Group P.12 Subject 2.5.10. Group P.13 Audience 2.6. BLOCK 2 CollateralDetail 2.6.1. Group P.14 Descriptions and other text 2.6.2. Group P.15 Cited content 2.6.3. Group P.16 Links to supporting resources 2.7. BLOCK 3 ContentDetail 2.8. BLOCK 4 PublishingDetail 2.8.1. Group P.19 Publisher 2.8.2. Group P.20 Global publishing status / copyright 2.9. BLOCK 5 RelatedMaterial 2.9.1. P.23 Related products Bladwijzer niet gedefinieerd. 2.10. BLOCK 6 ProductSupply 2.10.1. P.26 Supply detail Onix-berichten downloaden 3.1. Algemeen 3.2. Totaalbestanden 3.3. Mutatiebestanden 3.4. Uitgeverbestanden Mapping ProductForms naar verschijningsvormen Voorbeeld Onix Bestand 5.1. Header 5.2. Titel (ProductRecord) 7. Bijlage: Taalcodes (ONIX codelijst 74)
3 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
5 5 5 6 6 7 8 8 8 8 9 9 9 9 10 10 12 12 13 16 17 18 18 20 20 22 22 23 24 25 25 25 26 26 Fout! 28 28 29 29 29 29 29 31 33 33 33 36
Wijziging in versie 3.1
Epub versie toegevoegd Short tags verwijderd uit de specificaties
4 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
1. INLEIDING 1.1. Opbouw document 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. . :
1.2. Uitgangsdocumentatie De gebruikte documentatie voor het opstellen van dit document zijn: ONIX for Books Release 3.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
Binnen Nederland en Vlaanderen is er een ONIX gebruikersgroep die onderling afspraken maakt over de elementen uit de ONIX for Books definities die binnen Nederland en Vlaanderen gebruikt kunnen worden. Deze afspraken kunt u aantreffen in het document “Aanleveren artikelgegeens in ONIX 3.0 : handleiding ONIX Werkgroep, versie 1.6, 2 november 2012. Dit document is gepubliceerd op de website van de ONIX Werkgroep, www.onixwerkgroep.org
5 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
2. Opbouw ONIX bericht 2.1. Toelichting Een standaard Onix-bericht 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. Dit document 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 LIST A|N POS. (TB)
Waarbij: Data Element Field XML Reference Name M/O Onix M/O TB List A|N POS
Naam van het veld (data element) Veld zoals gebruikt in Onix-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 Code-list (indien van toepassing) Alfanumeriek of Numeriek Aantal posities
Indien een composite herhaald kan worden, staat achter het data element een (R) (=repeatable). In de ONIX 3.0 berichten die Titelbank aanlevert zal altijd gebruik worden gemaakt van long tags. Niet elk veld (data element) zal worden opgenomen in het Onix-bericht. Per veld wordt aangeduid of het al dan niet verplicht is volgens Onix. Daarnaast zal aangegeven worden of TitelBank het veld altijd vult (A) of soms (S). Een verplicht veld in Onix (M) zal altijd gevuld worden door Titelbank, een Onix (O) veld kan daarnaast ook altijd worden gevuld door Titelbank. Indien een veld niet is opgenomen in dit document, maar wel is vermeld in de officiële Onix documentatie, dan wordt het niet aangeleverd door Titelbank. Verplichtheid geldt op twee niveaus; een composite kan zelf optioneel zijn, maar indien toegevoegd in het bericht, moeten specifieke velden binnen die composite wel ingevuld worden. Daarom staat bij deze composite een ‘O’, maar voor velden binnen de composite een ‘M’. Hetzelfde geldt voor de ‘M’ en ‘O’ waarden van Titelbank.
6 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
2.2. Headerrecord In de header worden zowel de afzender als de geadresseerde van het bericht geïdentificeerd. Er wordt ook een unieke code aan het volledige bericht meegegeven in functie van de verwerking. Een overzicht van de gebruikte composites en velden. * Hieronder wordt middels een asterisk aangeduid dat een gegeven volgens de ONIX Werkgroep Nederland-Vlaanderen verplicht is, terwijl de internationale standaard dit niet afdwingt.
DATA ELEMENT
M/O Onix
M/O TB
M
M
FIELD XML REFERENCE NAME
Header composite
LIST
A|N A
M
M
<Sender> <SenderIdentifier> <SenderIDType> < IDValue>
M O* M M
M M M M
<SenderName>
O
O
O
O
O
O
H.7
M
M
Identifier value
H.9
M
M
N
Message sequence number
H.13
<MessageNumber>
O
O
N
<SentDateTime>
M
M
A
Sender composite Sender identifier composite Sender identifier type code H.1 Identifier value H.3 Sender name
H.4
Addressee composite Addressee identifier composite Addressee identifier type code
Message creation date/time H.15 H.1 <SenderIDType> H.3 < IDValue > H.4 <SenderName> H.7
H.9 H.13 <MessageNumber> H.15 <SentDateTime> volgens het formaat
POS.
44 A
44
N 7
13
Bevat ‘10’, komt uit Code-list 44 en duidt aan dat het een Titelbank Relatie_ID betreft. Bevat het Relatie_ID van de uitgever. Bevat ‘Titelbank’ in het uitgaande en de naam van de uitgever in het inkomende bericht. Bevat ‘10’, komt uit Code-list 44 en duidt aan dat het een Titelbank Relatie_ID betreft. Wordt in het inkomende bericht bij de verwerking genegeerd. Bevat het Relatie_ID van de uitgever. Wordt in het inkomende bericht bij de verwerking genegeerd. Bevat het volgnummer van het mutatiebericht. Bevat het datum en tijdstip waarop dit bericht gemaakt YYYYMMDDTHH24MI waarin:
7 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
YYYY = jaar (vier cijfers) MM = maand (twee cijfers) DD = dag (twee cijfers) T = Geeft aan dat nu de tijd volgt HH24 = uur (twee cijfers 01 t/m 24) MI = minuten (twee cijfers)
2.2.1. Sender composite , Sender name De sender name binnen de Sender composite wordt in het ONIX 3.0 bericht vanuit Titelbank gevuld met de waarde ‘Titelbank’.
2.2.2. Addressee composite, Addressee identifier composite De addressee composite wordt alleen gebruikt in het uitgeversbestand. Dit bestand kan door de uitgevers worden aangevraagd en bevat alle titels waarvan de uitgever eigenaar is. In andere bestanden is deze composite niet aanwezig. In de Addressee identifier composite wordt de afzender van het bericht geïdentificeerd door middel van het Titelbank_relatie_id. Dit is een uniek identificatienummer gebruikt door Titelbank om zowel leveranciers als boekhandels te identificeren.
2.3. Product record Het product record bevat de eigenlijke informatie per titel. Het record is als volgt ingedeeld: Record metadata Product numbers
Group P.1 Group P.2
………… ……………
Block 1 Block 2
………………
Block 3
…………
Block 4
……………
Block 5
………………
Block 6
2.4. Group P.1 (Record reference number, type and source ) en P.2 FIEL D
XML REFERENCE NAME
M/O Onix
M/O TB
P.1.1
M
M
Notification or update type code P.1.2
M
M
1
N
Record source type code P.2 Product numbers
O
O
3
N
M
M
M
M
5
N
M
M
DATA ELEMENT P.1 Record reference number and type Record reference number
P.1.4
Product identifier composite Product identifier type code
P.2.1
Identifier value
P.2.3
P.1.1 P.1.2 . P1.4
LIS A|N T
A
N
Bevat het ISBN van de titel. Bevat ‘03’ ( (Volledig record)) of ‘04’ Update (Block Update) Bevat in het uitgaande bericht altijd ‘01’ (Publisher). P2.1
8 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
POS .
13
13
Bevat altijd ‘03’ (EAN), uit Code-list 05 duidt aan dat het om een EAN.UCC GTIN13 gaat. P2.3 Bevat het EAN/ISBN-13 van de titel.
2.4.1. P1.1 Record reference number Een record met titelgegevens wordt geïdentificeerd in P1.1 in de vorm van een GTIN-13 (Global Trade Identification Number) . We gebruiken hiervoor het ISBN. Dit is een referentienummer voor het record, niet voor de titel die in dit record is opgenomen, deze staat in P2.3. Deze twee zullen echter altijd dezelfde waarde bevatten.
2.4.2. P1.2 Notification or update type code Afhankelijk van het type bestand wordt code ‘03’ of ‘04’ uit code List 1 meegegeven. Bij ‘03’ gaat het om een volledig record, ‘04’ is een Block update. Gebruik van NotificationType bij het aanleveren van gegevens uit Titelbank: Als bestaande gegevens zijn verwijderd ongeacht uit welk Block dan wordt altijd het volledige record aangeleverd met NotificationType 03 Als gegevens in een Block zijn gewijzigd wordt altijd het volledige Block aangeleverd met NotificationType 04
2.4.3. P1.4 Record source type code Deze code geeft aan wat de status is van de informatie dat voor dit record wordt doorgestuurd. veld is verplicht binnen een Onix-bericht en wordt gevuld a.h.v Code-list 01. Het wordt door Titelbank gevuld met ’01’ (Publisher). .
Dit
2.4.4. De Product identifier composite Wordt gebruikt om het EAN van de titel op te nemen in het Onix-bericht. Deze composite zal per titel altijd worden aangeleverd en precies 1 keer. In P.1.1 wordt deze EAN reeds opgenomen, maar daar gaat om een (uniek) referentienummer voor het record, in deze composite over de bibliografische identificatie van de titel.
9 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
2.5. BLOCK 1 DescriptiveDetail
Block 1
Product form
Group P.3
Product part (nog niet actief in Titelbank)
Group P.4
Collection
Group P.5
Product title
Group P.6
Authorship
Group P.7
Edition
Group P.9
Language
Group P.10
Extents Illustrations and ancillary content
Group P.11 Group P.11
Subject Audience
Group P.12 Group P.13
2.5.1. Group P.3 Product form In Group P.3 ProductForm wordt de verschijningsvorm van de titel vastgelegd.
DATA ELEMENT
FIELD
XML REFERENCE NAME
Product Composition Product Form Code Product Form Detail Product Form Feature Composite ProductFormFeatureType Code ProductFormFeatureValue Einde ProductFormFeature Composite ProductForm Description Epub technical Protection
P3.1 P.3.2 P.3.3
P.3.4 P.3.5
P.3.8 P. 3.16
P.3.1
P.3.2 P.3.3
ProductFormdescription <EpubtechnicalProtection>
M/O Oni x M M O O M M
A/ S CB M A S
O O
S O
A A
LIS T 2 150 175 79
144
A | N A A A
POS . 2 5
N 2 N 1
A 255 N 2
Bevat ‘00’ (Single-item product) of ‘10’ (Multi item) indien de titel begeleidend materiaal heeft (bijvoorbeeld een DVD of CD-ROM) of het aantal delen bekend is.
Een aantal verschijningsvormen kan niet afdoende worden gedefinieerd door alleen de ProductForm. Dit speelt met name bij eboeken. De ProductForm EB of ED zegt iets over de beschikbaarstelling van het eboek. ED wil zeggen dat het eboek alleen beschikbaar is via download, EB wil zeggen dat het eboek zowel is te downloaden als on line is te lezen.
10 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
In ProductFormDetail kan door middel van een waarde uit codelijst 175 worden aangegeven op welk technisch platform het eboek draait. Als in ProductForm Detail de waarde E101 is aangegeven, heeft het eboek het formaat ePub. Bij een ePub is van belang dat ook wordt aangegeven welke ePub versie het betreft. Dit kan ePub 2 of ePub3 zijn. EPub 3 is de opvolger van ePub 2. Epub 3 heeft een fixed layout en kan video, audio en interactieve elementen bevatten en is niet op alle op de markt beschikbare apparaten te lezen. Het versienummer is door middel van een 2 of een 3 aangegeven in de composite. Hieronder een voorbeeld van een ePub3: ED E101 10 3 <EpubTechnicalProtection>02
De beveiliging (Epubtechnical Protection) wordt aangegeven door een waarde uit codelijst 144. De in Nederland meest gangbare verschijningsvormen van eboeken kunnen worden herleid uit het onderstaande schema: Eboek productvorm
ProductForm ProductFormDetail DRM
Eboek: Epub met Adobe DRM, download Eboek: Epub zonder DRM, download
ED ED
E101 E101
3 0
Eboek: Epub met digitaal watermerk, download Eboek: bundel, download
ED ED
E101 E101
2
Eboek: Epub, Adobe DRM, download/online EB Eboek: Epub, digitaal waterwerk, download/online EB
E101 E101
3 0
Eboek: Epub zonder DRM, download/online Eboek: bundel, download/online
EB EB
E101 E101
2
Eboek: PDF met Adobe DRM Eboek: PDF zonder DRM
ED ED
E107 E107
3 0
Eboek: PDF met digitaal watermerk
ED
E107
2
Daarnaast bestaan er in codelijst 175 nog een groot aantal andere waardes voor diverse typen leesapparaten en platformen, die minder gangbaar zijn in Nederland en Vlaanderen, maar wel aangemeld kunnen worden voor ISBN registratie en op Titelbank zijn te vinden.
Voor de afnemers van het ONIX 3.0 bericht dat Titelbank aanlevert is van belang om te weten dat publicaties met de onderstaande waardes van ProductForms niet bedoeld zijn voor verkoop aan eindconsumenten, dus niet op de website van een webwinkel getoond moeten worden.
11 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
XA
Promotiemateriaal
XB
Display (leeg)
XC
Display (gevuld)
XD
Display (leeg)
XE
Display (gevuld)
2.5.2. Group 4 Product Part (wordt niet gebruikt in Titelbank) In Group 4 ProductPart kan van een samengesteld artikel worden aangegeven welke individuele onderdelen de samenstelling bevat. Omdat Titelbank niet de mogelijkheid heeft om deze gegevens vast te leggen wordt Group 4 ProductPart niet gebruikt in Titelbank.
2.5.3. Group P.5 Collection In Group 5 worden de gegevens van de bibliografische reeks opgenomen.
DATA ELEMENT
FIELD XML REFERENCE NAME
Collection composite Collection type code P.5.1 Title detail composite Title type P.5.6 Title elementcomposite Title element level P.5.7 Part number
P.5.8
Title text
P.5.10
“No series” indicator (empty element)
<TitleDetail> <TitleType> <TitleElement> <TitleElementLevel> <PartNumber>
<TitleText> P.5.62
P.5.1 <TitleDetail> P.5.6 <TitleType> <TitleElement> P.5.7 <TitleElementLevel> P.5.8 <PartNumber> P.5.10 <TitleText> P.5.62
M/O Onix O M O M
M/O TB O M O M
M
M
M
M
O
O
M
M
O
O
LIST A | N POS.
148
A
15
A
149
A N
A
Collection wordt alleen uitgeschreven als de titel onderdeel is van een reeks Bevat ‘10’ (Publisher collection) Bevat ‘01’ (Distinctive title) uit Code list 15 Bevat ‘02’ (Collection) uit Code list 149 Bevat het reeks nummer Bevat de reeks naam. Wordt geschreven wanneer de titel geen onderdeel uitmaakt van een reeks.
Voorbeeld van een Publisher collection:
12 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
10 Publisher collection <TitleDetail> <TitleType>01 <TitleElement> <TitleElementLevel>02 Collection level <PartNumber>III <TitleText> Memoire en Images Publisher’s series title
2.5.4. Group P.6 Title In Group 6 worden de titelgegevens opgenomen: hoofdtitel, deeltitel, sectietitel en ondertitel. M/O Onix
M/O TB
M
M
<TitleType>
M
M
<TitleElement>
M
M
<TitleElementLevel> M <TitleText> O <Subtitle> O
M M O
<TitleElement>
O
O
P.6.2
<TitleElementLevel> M
M
Part number
P.6.3
M
N
Title text Title element Composite Title element level Title text
P.6.5
O <PartNumber> <TitleText> O
M
A
2000
<TitleElement>
O
O
<TitleElementLevel> M <TitleText> O
M M
A A
2000
DATA ELEMENT Title detail composite Title type Title element composite Title element level Title text Subtitle Title element Composite Title element level
FIELD XML REFERENCE NAME <TitleDetail> P.6.1
P.6.2 P.6.5 P.6.8
P.6.2 P.6.5
LIST A | N
15
A
149
A A A
149
149
POS.
2000 2000
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>
13 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
P.6.1 <TitleType> <TitleElement> P.6.2 <TitleElementLevel> P.6.5 <TitleText> P.6.8 <Subtitle>
Bevat ‘01’ (Distinctive title), uit Code List 15. Bevat ‘01’ (Product) Bevat de hoofdtitel 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> <TitleElement> P.6.2 <TitleElementLevel> P.6.5 <TitleText> P.6.2 <TitleElementLevel> P.6.5 <TitleText>
Bevat ‘01’ (Distinctive title), uit Code List 15. Bevat ‘01’ (Product) Bevat de deeltitel Bevat ‘02’ (Collection) 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> <TitleElement> P.6.2 <TitleElementLevel> P.6.3 <PartNumber> P.6.5 <TitleText> P.6.2 <TitleElementLevel> P.6.5 <TitleText>
Bevat ‘01’ (Distinctive title), uit Code List 15. Bevat ‘01’ (Product) Bevat het deelnummer Bevat de deeltitel Bevat ‘02’ (Collection) 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> <TitleElement> P.6.2 <TitleElementLevel> P.6.5 <TitleText> P.6.2 <TitleElementLevel> P.6.5 <TitleText> P.6.2 <TitleElementLevel> P.6.3 <PartNumber> P.6.5 <TitleText>
Bevat ‘01’ (Distinctive title), uit Code List 15. Bevat ‘01’ (Product) Bevat de sectietitel Bevat ‘02’ (Collection) Bevat de hoofdtitel Bevat ‘03’ (Subcollection) Bevat het deelnummer 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> <TitleElement> P.6.2 <TitleElementLevel> P.6.5 <TitleText> P.6.2 <TitleElementLevel>
Bevat ‘01’ (Distinctive title), uit Code List 15. Bevat ‘01’ (Product) Bevat de deeltitel Bevat ‘02’ (Collection)
14 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
P.6.5 <TitleText> P.6.8 <Subtitle>
Bevat de hoofdtitel 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> <TitleElement> P.6.2 <TitleElementLevel> P.6.5 <TitleText> P.6.2 <TitleElementLevel> P.6.5 <TitleText> P.6.8 <Subtitle> P.6.2 <TitleElementLevel> P.6.5 <TitleText>
Bevat ‘01’ (Distinctive title), uit Code List 15. Bevat ‘01’ (Product) Bevat de sectietitel Bevat ‘02’ (Collection) Bevat de hoofdtitel Bevat de ondertitel Bevat ‘03’ (Subcollection) 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> <TitleElement> P.6.2 <TitleElementLevel> P.6.5 <TitleText> P.6.2 <TitleElementLevel> P.6.5 <TitleText> P.6.8 <Subtitle> P.6.2 <TitleElementLevel> P.6.3 <PartNumber> P.6.5 <TitleText>
Bevat ‘01’ (Distinctive title), uit Code List 15. Bevat ‘01’ (Product) Bevat de sectietitel Bevat ‘02’ (Collection) Bevat de hoofdtitel Bevat de ondertitel Bevat ‘03’ (Subcollection) Bevat het deelnummer Bevat de deeltitel
Voorbeeld meerdelig werk met hoofdtitel, ondertitel, sectietitel, deelnummer en deeltitel: (Percent 2 Economie Bovenbouw HAVO – Antwoordenboek) Product Identifier Identifier of product 03 GTIN-13 / ISBN 9789042538818 Product form 00 Single-item product BC Paperback book Product title <TitleDetail> <TitleType>01 <TitleElement> <TitleElementLevel>02 Collection Level <TitleText>Percent
15 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
<Subtitle>samen boeken we succes <TitleElement> <TitleElementLevel>03 Subcollection Level <PartNumber>2 <TitleText>Economie bovenbouw Havo <TitleElement> <TitleElementLevel>01 Product Level <TitleText>Antwoordenboek <TitleDetail> Als er een TitleElementLevel 02 (Collection) of 03(Subcollection) wordt aangeleverd, dan moet ofwel PartNumber ofwel TitleText zijn gevuld, beiden mogen gevuld zijn.
2.5.5. Group P.7 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).
De gebruikte velden zijn:
DATA ELEMENT Contributor composite Contributor sequence number Contributor role code Person name part 2 Person name part 3 Person name part 4 Corporate name No authorship” indicator (empty element)
M/O Onix
M/O TB
O
O
P.7.1
<SequenceNumber> O
M
P.7.2
M
M
P.7.12
O
O
P.7.13
O
O
P.7.14
O
O
P.7.19
O
O
O
O
FIELD XML REFERENCE NAME
P.7.50
P.7.1 <SequenceNumber> P.7.2
LIST A | N
N 17
POS.
3
A A
255
A
255
A
255
A
255
Wordt geschreven per betrokkene. Wanneer er geen betrokkene is wordt P.7.50 geschreven. Bevat het volgnummer van de betrokkene Bevat de soort betrokkenheid, afkostig uit Code List 17.
16 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
Omschrijving Auteur Bewerker llustrator Redacteur Vertaler Voorlezer Secundaire auteur: verouderde manier om aan te geven dat er meer dan 3 auteurs zijn met dezelfde soort betrokkenheid, en alleen de eerste hiervan wordt vermeld. Komt voor bij oudere records
Code in het Onixbericht uigaand A01 B05 A12 B01 B06 E07
Z99 gevolgd door de Unnamed Perons Composite
P.7.12
P.7.13
Bevat de voornaam van de betrokkene, wanneer de betrokkene alleen bekend is met voorletters dan bevat deze tag de voorletters Waneer de betrokkene een organisatie of instelling is (Corporatie) dan blijft deze tag leeg.. Bevat de eventueel aanwezige voorvoegsels. Waneer de betrokkene een organisatie of instelling is (Corporatie) dan blijft deze tag leeg..
P.7.14 P.7.19
Bevat de achternaam van de betrokkene Bevat de organisatienaam bij soort betrokkenheid COR en komt in TitelBank in het veld achternaam. Dit veld is verplicht. Wordt bij de overige soorten betrokkenheid niet beschreven. Secundaire auteur: In de traditionele bibliografie wordt bij het voorkomen van meer dan 3 auteurs met een identieke rol alleen de eerste van de drie auteurs opgenomen gevolgd door de tekst …. et al. ( en anderen). Deze werkwijze wordt bijvoorbeeld vaak gevolgd bij redactionele werken waar een groot aantal auteurs een bijdrage aan hebben geleverd. In het uitgaande ONIX bericht wordt dit als volgt aangegeven: 1 x een contributor composite met de naam van de betrokkene en betrokkenheid Z99 gevolgd door de 1 x een UnnamedPersonsComposite: Z99 03 P.7.50 Wordt geschreven wanneer er geen betrokkenen zijn.
2.5.6. Group P.9 Edition In dit veld wordt het bibliografische druknummer meegegeven en een mogelijk commercieel druknummer.
17 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
DATA ELEMENT
FIELD XML REFERENCE NAME
Edition number Edition version number Edition statement
P.9.2
<EditionNumber>
M/O Onix O
P.9.3
<EditionVersionNumber>
O
P.9.4
<EditionStatement>
O
M/O TB O O
LIST A | N POS.
O
N A
30 3
A
30
P.9.2 <EditionNumber> Dit wordt gevuld met het druknummer waarmee de betreffende publikatie met het betreffende ISBN voor het eerst is uitgegeven, als deze een numerieke waarde bevat. Het <EditionNumber> wordt in Titelbank vastgelegd bij de basistitelgegevens. Gemiddeld bevat dit veld 1-2 numerieke karakters. P.9.3 <EditionVersionNumber> Wanneer de betreffende publikatie met het zelfde ISBN opnieuw wordt uitgegeven spreken we over een ongewijzigde herdruk met een hoger druknummer. Deze kan worden aangeleverd als het <EditionVersionNumber>. Het <EditionVersionNumber> wordt in Titelbank vastgelegd bij de verrijkte titelgegevens P.9.4 <EditionStatement> Als de drukaanduiding in de publikatie niet is aangegeven dmv een nummer maar door tekst, bijvoorbeeld Herdruk” dan wordt het EditionStatement aangeleverd
2.5.7. Group P.10 Language 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. De gebruikte velden zijn: DATA FIELD ELEMENT Language composite Language role P.10.1 Language P.10.2 code
XML REFERENCE NAME
M/O Onix
O
M
M
M/O TB M M M
LIST
A|N
POS.
22 74
A A
3
Wordt alleen geschreven wanneer er een taalkode aanwezig is bij deze titel P.10.1 Bevat ‘01’ (Language of text) uit Code list 22. Titelbank legt zelf geen oorspronkelijke titel vast. Daarom zal alleen de taal van uitgave worden gecommuniceerd. P.10.2 Bevat de taalkode volgens de ISO 639-2/B standaard, aanwezig in Code list 74. Deze codelijst kunt u vinden in bijlage.7
2.5.8. Group P.11 Extents and other content De extents composite wordt gebruikt voor informatie over illustraties en het aantal pagina’s. De gebruikte velden zijn: DATA ELEMENT
FIELD
XML REFERENCE NAME
18 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
M/O Onix
M/O TB
LIST A | N
POS.
Extent composite Extent type code Extent value Extent value in Roman numerals Extent unit Extent composite Extent type code Extent value Extent unit Illustrated / not illustrated flag
<Extent> <ExtentType>
P.11.1
<ExtentValue>
P.11.3
<ExtentValueRoman> O
P.11.4
<ExtentUnit> <Extent>
P.11.5
<ExtentValue> <ExtentUnit>
23
M O
O
M O
<ExtentType>
P.11.2 P.11.4
M
M
P.11.2
P.11.1
O
O
M O M
M O
24
M
23
M M M
24 152
A A
20 20
A
50
O
<Extent> P.11.1 <ExtentType> P.11.2 <ExtentValue> P.11.3 <ExtentValueRoman>
Wordt geschreven wanneer het aantal pagina’s aanwezig is Bevat ‘00’ (Main content page count), ‘03’ (proloog) of ‘04’ (epiloog) Bevat het aantal pagina’s van de hoofdinhoud. Bevat het aantal pagina’s van de proloog of epiloog, mits deze in Romeinse cijfers geschreven zijn. Of het om een proloog of epiloog gaat is af te lezen in <ExtentType>. Er wordt vanuit gegaan dat een hoofdinhoud altijd numeriek is. Wanneer er slechts 1 getal aanwezig is en deze is in romeinse cijfers, wordt de composite niet geschreven.
P.11.4 <ExtentUnit> <Extent> P.11.1 <ExtentType>
Wordt herleid op basis van onderstaande tabel Wordt geschreven wanneer de omvang gevuld is. Wordt herleid op basis van onderstaande tabel, afhankelijk van de omvangeenheid. Bevat de omvang Wordt herleid op basis van onderstaande tabel
P.11.2 <ExtentValue> P.11.4 <ExtentUnit>
Omvang eenheid WRD PGN UMS BYT KBS MBS P.11.5
Omschrijving Woorden Pagina’s Uren, minuten en seconden (HHHMMSS) Bytes Kilobyte Megabytes
Inkomend/ uitgaand Extentunit 02 03
Uitgaande Extenttype extenttype
16
09
17 18 19
22 22 22
02 00,03,04
02 00 09 22 22 22
Bevat ‘01’ (=N) of ‘02’( = J) uit Code list 152, afhankelijk van of de titel al dan niet illustraties bevat.
19 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
2.5.9. Group P.12 Subject In de ‘subject composite’ wordt de NUR aangegeven. In de ‘subject composite’kunnen ook trefwoorden worden aangegeven maar momenteel bevat Titelbank nog geen trefwoorden. De gebruikte velden zijn: DATA ELEMENT Subject composite Main subject flag Subject scheme identifier Subject code Subject composite Subject scheme identifier Subject code
M/O Onix
FIELD XML REFERENCE NAME <Subject>
O
P.12.1
<MainSubject/>
O
P.12.2
<SubjectSchemeIdentifier> M
P.12.5
<SubjectCode>
O
<Subject>
O
M/O TB M
POS.
M M
27
M O
P.12.2
<SubjectSchemeIdentifier> M
M
P.12.5
<SubjectCode>
M
O
LIST A | N
A
5
A
5
27
Indien een NUR code wordt aangeleverd, gebeurt dit als volgt: <Subject> P.12.1 <MainSubject/> P.12.2 <SubjectSchemeIdentifier> P.12.5 <SubjectCode> <Subject> P.12.1 <MainSubject> P.12.2 <SubjectSchemeIdentifier> P.12.5 <SubjectCode>
Wordt geschreven voor de NUR code Is altijd een lege tag, moet aanwezig zijn om aan te geven dat het om een hoofd-NUR gaat. Bevat ‘32’ (NUR), afkomstig uit Code list 27 Bevat de NUR code Wordt geschreven wanneer een NUR code in de verrijkte titelinformatie aanwezig is. Mag in dit geval juist niet aanwezig zijn, om aan te geven dat het om een secundaire NUR gaat. Bevat ‘32’ (NUR) Bevat de NUR code uit de verrijkte titelinformatie
Indien een of meerdere trefwoorden worden aangeleverd, gebeurt dit als volgt: <Subject> <SubjectSchemeIdentifier> <SubjectHeadingText> <Subject>
Bevat ‘20’(Keywords) De tekst van het trefwoord
2.5.10. Group P.13 Audience Om het benodigd leesniveau aan te geven bestaat er de AVI-code. Dit wordt weergegeven in de Audience composite. DATA ELEMENT Audience composite
FIELD
XML REFERENCE NAME
M/O Onix
O
20 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
M/O TB O
LIST A | N
POS.
Audience code type Audience code value
P.13.2
M
P.13.4
M
P.13.2 P.13.4
M
29
M
A
10
Wordt geschreven als er een AVI code aanwezig is. Bevat ‘09’ (AVI) Bevat de AVI code.
We kennen de volgende AVI codes: Omdat AVI sinds kort vernieuwd is en de oude en nieuwe AVI codes naast elkaar gebruikt worden geven we ook de oude codes weer.
AVI-Start (AVI-Oud 1) AVI-M3 (AVI-Oud 1-2) AVI-E3 (AVI-Oud 2-3) AVI-M4 (AVI-Oud 3-4-5) AVI-E4 (AVI-Oud 4-5-6) AVI-M5 (AVI-Oud 5-6) AVI-E5 (AVI-Oud 6-7-8) AVI-M6 (AVI-Oud 7-8-9) AVI-E6 (AVI-Oud 8-9) AVI-M7 (AVI-Oud 8-9->9) AVI-E7 (AVI-Oud >9) AVI-Plus (AVI-Oud >9) AVI_Oud-1 (AVI Start - M3) AVI-Oud-2 (AVI M3-E3) AVI-Oud-3 (AVI E3-M4) AVI-Oud-4 (AVI M4-E4) AVI-Oud-5 (AVI M4-E4-M5) AVI-Oud-6 (AVI E4-M5-E5) AVI-Oud-7 (AVI E5-M6) AVI-Oud-8 (AVI E5-M6-E6_M7) AVI-Oud-9
(AVI M6-E6-M7)
AVI-Oud > 9 (AVI M7-E7-Plus)
21 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
2.6. BLOCK 2 CollateralDetail In dit Block kan verrijkte titelinformatie zoals covers, flapteksten, recensies, inkijktekst en andere promotionele gegevens worden onderhouden.
Block 2
Descriptions and other text
Group P.14
Cited content
Group P.15
Links to supporting resources
Group P.16
2.6.1. Group P.14 Descriptions and other text Recensies, flapteksten, promotionele teksten die betrekking hebben op de titel worden opgenomen in de Text Content Composite. Teksten (vnl. recensies) van externe partijen die op externe bronnen beschikbaar zijn, worden echter niet hier opgenomen, maar in de volgende Composite, namelijk ‘Cited Content’
DATA ELEMENT Text content composite Text type code Text audience Text Author of quoted text Corporate source of quoted text Title of source Content date composite Content date role Date format Date P.14.1
FIELD
P.14.1 P.14.2 P.14.3 P.14.4 P.14.5 P.14.6 P.14.7 P.14.8 P.14.9
XML REFERENCE NAME <SourceTitle>
M/O Onix O M M M O
M/O TB O M M M O
O
O
O O M M M
O O M M M
LIST A | N
POS.
153 154 A
100 155 55 8
Het type content dat wordt aangeleverd wordt bepaald ahv List 153. Een waarde uit deze lijst wordt in het veld PR.14.1 geplaatst,.: 02 : Short Description Annotation Blurb / korte wervende tekst (350 karakters; aangeleverd door uitgever) 04 : Table of content Inhoudsopgave 05 : Back Cover Copy Flaptekst (aangeleverd door uitgever) 06 : Review quote Recensie, vaak beperkt tot quote (aangeleverd door uitgever) 11 : Promotionele tekst 13: Inkijktekst. Bij 06 (recensies) is het verplicht om ook de elementen TextAuthor, TextSourceCorporate en ContentDate te vullen P.14.2
Standaard wordt de waarde 03 (eindgebruikers) in het veld
22 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
P.14.3 P.14.4 P.14.5 P.14.6
<SourceTitle>
P.14.7 P.14.8 P.14.9 Textcontent Voor Annotatie
TextType (P.14.1) ‘02’
Voor Flaptekst
‘05’
Voor Inhoudsopgave
‘04’
Voor Inkijktekst
’13’
Voor Recensies
‘06’
Voor Promotionele teksten
‘11’
P14.2 opgenomen. Alleen om commerciële aanbiedingsinformatie door te geven, kan waarde 02 (handel) gebruikt worden. Hierin wordt de tekst van de content aangeleverd De naam van de auteur van een tekst De naam van de bron van de tekst Wordt alleen geschreven bij recensies en bevat de titel van de recensie Wordt alleen geschreven bij recensies Bevat ‘01’ (Publication date) Bevat ‘00’ (YYYYMMDD) waarin Date geschreven wordt Bevat de datum van de recensie ContentAudience (P.14.2) ‘03’ (=Unirestricted) ‘03’ (=Unirestricted) ‘03’ (=Unirestricted) ‘03’ (=Unirestricted) ‘03’ (=Unirestricted) ‘03’ (=Unirestricted)
Text (P.14.3)
TextAuthor (P.14.4)
TextSourceCorporate (P.14.5)
De auteur
De bron
De annotatie De flaptekst De inhoudsopgave De inkijktekst De recensie De promotionele tekst
2.6.2. Group P.15 Cited content Om links op te nemen naar productondersteunende teksten (bijvoorbeeld recensies) van derde partijen, waar mogelijk copyright op rust, kan gebruik worden gemaakt van de Cited content composite. Een recensie met dezelfde naam kan niet zowel in P.14 als P.15 worden opgenomen, deze moet ofwel als tekst worden opgenomen in PR14 ofwel als url in P15.
DATA ELEMENT Cited content composite Citation type code Source type Title of source Link to cited content – URL
XML REFERENCE NAME P.15.1 P.15.3 <SourceType> P.15.4 <SourceTitle>
M/O Onix O M O O
M/O TB O M M O
P.15.8
O
M
FIELD
P.15.1 P.15.3 <SourceType> P.15.4 <SourceTitle> P.15.8
LIST A | N POS.
156 157
Wordt geschreven per recensie waar een URL is opgegeven Bevat 01 (Review) Bevat 02 (website) Bevat de titel van recensie Bevat de URL
23 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
2.6.3. Group P.16 Links to supporting resources Naast content in tekstvorm kan ook andere digtiale content worden aangeleverd. Deze wordt opgenomen in de Links to supporting resources composite.
DATA ELEMENT Supporting resource composite Resource content type code Target audience code Resource mode code Resource version composite Resource form code Link to resource content - URL
FIELD
XML REFERENCE NAME <SupportingResource>
P.16.1 P.16.2 P.16.3
M/O Onix O
M M M
M/O TB
M M M
M
M
P.16.7
M
M
P.16.11
M
M
P.16.1 P.16.2 < ContentAudience > P.16.3 P.16.7 P.16.11
POS.
O
<SupportingResource>
LIST A | N
158 154 159
161 A
100
Wordt geschreven per bij de titel behorend bestand (bv PDF, JPG) Afhankelijk van of het een voorkaft (’01’), achterkaft (’02’) of de inkijktekst van het boek (’15’) betreft Bevat ‘00’ (Unrestricted). Bevat ‘03’ (Image). We gebruiken deze code ook bij PDF. Bevat ‘01’ (Linkable resource). Bevat de bestandsnaam welke als volgt is opgebouwd: ISBN_TYPEBESTAND.Extensie o ISBN is het ISBN van de titel o TYPEBESTAND is VRK (front cover, voorkant) of ATK (back cover, achterkant) of FCT (inkijktekst) o Extensie is afhankelijk van de bestandssoort bv JPG (voor voorkant en achterkant) of PDF (voor inkijktekst)
Verwerking covers en backcovers: Als een aangeboden (back)cover kleiner is dan 800x800, dan wordt het aangeboden formaat opgeslagen, zodat er geen kwaliteitsverlies optreedt. Als een aangeboden (back)cover groter is dan 800x800, dan wordt er 800x800 van gemaakt. Dit levert geen kwaliteitsverlies op.
24 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
2.7. BLOCK 3 ContentDetail Het Block ContentDetail binnen ONIX 3.0 wordt gebruikt om informatie vast te leggen betreffende hoofdstukken/delen van de publikatie. Binnen Titelbank wordt dit Block niet gebruikt
2.8. BLOCK 4 PublishingDetail
Block 4
Publisher
Group P.19
Global publishing status / copyright
Group P.20
2.8.1. Group P.19 Publisher DATA ELEMENT Imprint or brand composite Imprint name Publisher composite Publishing role code Publisher identifiercomposite Publisher identifier type Identifier value
M/O Onix
M/O TB
O
O
O O M
M O M
O
M
P.19.6
M
M
P.19.8
M
M
FIELD XML REFERENCE NAME P.19.4
P.19.5
POS.
A
80
N
7
45
44
In Titelbank wordt de bibliografische imprint vermeld. Dit is de uitgeversnaam zoals die in de publicatie vermeld staat; deze kan afwijken van de naam van de prefixhouder. De bibliografische imprint wordt opgenomen in Block 4 – Publishing detail bij het kenmerk P.19.4..
, tag P19.5 P.19.6
LIST A | N
Naam van de bibliografische imprint
Wordt gevuld met de waarde ‘01’ (huidige uitgever). Bevat ‘10’ uit Code list 44 en geeft aan dat het relatie id dat in staat het Titelbank Relatie_ID
.
25 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
2.8.2. Group P.20 Global publishing status / copyright DATA ELEMENT Global publishing status Publishing date composite Publishing date role code Date format Date
FIELD XML REFERENCE NAME
M/O Onix
M/O TB
LIST
P.20.1
O
O
64
O
O
M
M
163
55
A|N
POS.
A
P.20.3
A
P.20.4
M
M
P.20.5
M
M
A N
4
P.20.1 Alleen titels met de status “Verkrijgbaar” worden gecommuniceerd in het ONIX bericht van Titelbank. Dit wordt aangegeven met PublishingStatus 04.
Bevat ‘01’ (Publication date) uit Code list 163 P.20.4 Wordt gevuld met waarde ‘00’ uit codelist 55 en dit correspondeert met het formaat YYYYMMDD dat in P20.5 komt te staan. P.20.5 De (vermoedelijke) verschijningsdatum van de titel
2.9. BLOCK 5 RelatedMaterial Related products
Block 5 Group P.23
In Block 5, RelatedMaterial, wordt het ISTC (International Standard Text Code) van het werk opgenomen. Ook kan in dit Block een vervanger of een alternatief van het ISBN worden vastgelegd. De gebruikte velden zijn:
DATA ELEMENT Related product composite Relation code Product identifier composite Product identifier type code Identifier value
XML REFERENCE NAME
M/O Onix
M/O TB
O
O
P.23.1 M
M
O
O
FIELD
P.23.2
M
M
P.23.4
M
M
26 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
LIST A | N
POS.
51
5 A
13
2.10.
ISTC Voor het weergeven van het ISTC wordt de RelatedMaterial composite 2 x opgenomen. Het bron ISTC wordt aangegeven door middel van ProductRelationCode 01 (Manifestation of). Het afgeleid ISTC wordt aangegeven door middel van ProductRelationCode 02 (Derived from). Een afgeleid ISTC is bijvoorbeeld voor een vertaling, een gewijzigde herdruk of een bewerking, een geannoteerde versie van een oorspronkelijk werk. Door middel van ProductIDType 11 uit codelijst 16 wordt aangegeven dat een ISTC volgt. 01 11 A03201200000AF36 02 11 A142012000000242
2.11.
Vervanger
Indien artikel x , y vervangt, dan zal bij artikel y een RelatedProduct composite worden opgenomen met ProductRelationCode : ‘05’ (= vervangen door) ProductIdType 03 uit codelijst 16 geeft aan dat in IDValue een EAN code volgt En in ID Value staat dan de artikel code van artikel x 05 03 9789043022583
27 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
2.12.
BLOCK 6 ProductSupply
Block 6
Supply detail
Group P.26
2.12.1. P.26 Supply detail Het Block ProductSupply wordt in Titelbank gebruikt om gegevens over de prijzen te communiceren.
DATA ELEMENT
FIELD
Supply detail composite Supplier composite Supplier role Supplier name Product availability Price composite Price type code Price amount
XML REFERENCE NAME <SupplyDetail> <Supplier>
P.26.1 P.26.5 P.26.1 7 P.26.4 3 P.26.6 2
<SupplierRole> <SupplierName>
M/O Onix M
M/O TB O
M
M
M O
M O
M
M
O M
M M
M
M
LIS T
A|N
POS .
N
6
93 65
58
De Supplier composite is als volgt gevuld: <SupplierRole> wordt gevuld met de waarde 00 uit codelijst 93 (unspecified) <SupplierName> wordt gevuld met de waarde “Titelbank”. In het uitgaande ONIX 3.0 bericht wordt de prijs alleen opgenomen wanneer de titel in Titelbank de status ‘VKR’heeft hetgeen overeenkomt met ProductAvailability ‘20’, en de wordt altijd ‘02’ P.26.62 < PriceAmount >
Bevat de prijs van de titel in format 9999.99
28 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
3. Onix-berichten downloaden 3.1. Algemeen Titelbank levert gegevens aan in de vorm van gezipte Onix 3.0 bestanden. Er zijn vier soorten Onix 3.0 bestanden: 1. Totaalbestanden 2. Mutatiebestanden, ook wel updatebestanden genoemd 3. Uitgeverbestanden 4. Aanbiedingbestanden Het Onix-bericht is opgebouwd uit 6 verschillende blokken, waarvan er door Titelbank 5 gebruikt worden. Zie voor een overzicht van de blokken Hoofdstuk 3. De aanlevering wordt gedaan in long tags (in de tabel XML refence names. Op totaalbestanden na zijn deze bestanden te downloaden van de Titelbank FTP-server ftp://rhtvp.boekhuis.nl/. Om een Onix bestand te kunnen downloaden heb je een FTP-account nodig. Je krijgt een FTP-account zodra je voor de eerste keer op de Titelbank-applicatie inlogt.
3.2. Totaalbestanden Maandelijks maakt Titelbank een totaalbestand aan. Het totaalbestand bevat alle beschikbare gegevens van alle titels met een geregistreerd ISBN binnen het nederlands taalgebied sinds 1970. Dit bestand wordt als ONIX bericht aangeleverd. Vanwege de grootte van het bestand wordt dit op een USB harde schijf naar u toegestuurd. Wanneer u deze binnen 10 werkdagen retour stuurt dan zijn aan deze service geen kosten verbonden. Wanneer u de harde schijf later, incompleet of geheel niet terugstuurt, dan wordt u een bedrag van €250 in rekening gebracht. Om het totaal bestand aan te vragen vult u het daarvoor beschikbare formulier in in de Titelbank-applicatie en drukt u op versturen(Tabblad Aanvraag bestand). Een totaalbestand is ongeveer 30 – 40 GB groot en is opgedeeld in segmenten van 4000 records (ISBN’s). Deze opdeling wordt gedaan om te voorkomen dat de verwerking van het bestand in de applicatie van de afnemer vastloopt. Het totaalbestand is niet te downloaden van de Titelbank FTP-server. Totaalbestanden zijn zowel door afnemers als uitgevers in de Titelbank-applicatie aan te vragen.
3.3. Mutatiebestanden Titelbank genereert elke nacht een mutatiebestand. Dit mutatiebestand bevat alle wijzigingen van de laatste periode waarover nog geen mutatiebestand is aangemaakt. Wanneer een gegeven binnen een blok is aangepast, wordt dat blok compleet met alle gegevens, dus ook de niet gewijzigde, aangeleverd. Blokken waarbinnen niets gewijzigd is, worden dan niet aangeleverd. Een periode kan bijvoorbeeld maandag 9 november 22:00 uur tot dinsdag 10 november 22:00 uur zijn. Wijzigingen die in deze periode zijn uitgevoerd worden dan in het mutatiebestand aangeleverd dat in de nacht van dinsdag 10 november op woensdag 11 november bij Titelbank op de FTP-server verschijnt. Mutatiebestanden worden ’s nachts aangemaakt en kunnen worden gedownload van de Titelbank FTP-server. Mutatiebestanden zijn zowel voor afnemers als uitgevers beschikbaar in de FTP-map /data/public/. Indien meer dan 4000 mutatierecords (ISBN’s) in 1 periode moeten worden doorgegeven, wordt het mutatiebestand opgesplitst in meerdere segmenten, waarbij een segment maximaal 4000 records kan bevatten.
3.4. Uitgeverbestanden Een uitgever kan in de Titelbank-applicatie een verzoek doen om een uitgeverbestand aan te laten maken. Een uitgeverbestand bevat alle titels van de uitgever. Uitgeverbestanden worden ’s nachts aangemaakt en kunnen worden gedownload van de Titelbank FTP-server. Uitgeverbestanden zijn uitsluitend voor
29 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
uitgevers beschikbaar in de FTP-map /data/uitgevers//download/. Met de term wordt de FTP-accountnaam van een uitgever bedoeld. Te allen tijde heeft u bij het gebruik van ONIX programmatuur nodig die gegevens in ONIX formaat kan downloaden, inlezen en verwerken in uw webapplicatie. Deze programmatuur maakt geen onderdeel uit van Titelbank.
30 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
4. Mapping ProductForms naar verschijningsvormen
OMSCHRIJVING
Productform
Audio
AA
Audio op MP3-speler
AK
Audio, SD card
AL
Audiocassette (analoog)
AB
Audiocassette (digitaal)
AD
Audiodisc
AE
Audiotape
AF
Blu Ray
VO
CD-Audio
AC
CD-ROM
DN
CDI
DC
Compact Memory Card
DK
DVD
DI
DVD-Audio
AI
Dia
FC
Digitaal
DA
Digitaal, SD-card
DJ
Diskette
DF
Film
FA
Filmstrip
FE
Game cartridge
DE
HDVD
VN
Luisterboek
Default 00
Memory Stick
DL
Microfiche
MA
Microfilm
MA
Microvorm
MA
Minidisc (Sony)
AG
Overhead Projector Transparant
FD
Super Video CD
VM
USB Flash Drive
DM
Video
VA
Betamax Video
VK
Video CD
VL
UMD Video
VP
VHS Video
VJ
Videodisc
VF
31 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
Luisterboek : MP3 download
AJ
Agenda
PB
Hardback
BB
Bladmuziek
PI
Paperback / softback
BA
Bouwkaart, Bouwpakket
PH
Kalender
PC
Samengesteld pakket
Default 00
Bladwijzer
PT
Loose-leaf
BD
Drukwerk
PA
Kaarten
PJ
Kaartspellen
PD
Opbergmap
PM
Pamflet
BF
Poster
PK
Stickers
Default 00
Topografische kaarten
CA
Wandkaart
PO
Display (gevuld)
XC
Display (leeg)
XB
Promotiemateriaal
XA
Speelgoed
ZB
Spel
ZE
T-shirt
ZF
Diversen
00
32 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
5. Voorbeeld Onix Bestand 5.1. Header <Sender> <SenderName>Titelbank 10 7000164 <SentDateTime>20091202T1613
5.2. Titel (ProductRecord) 9789042530638 03 01 03 9789042530638 00 00 <TitleDetail> <TitleType>01 <TitleElement> <TitleElementLevel>02 <TitleText>Bekijk het ! <Subtitle>bio & verzorging <TitleElement> <TitleElementLevel>03 <TitleText>15 Vmbo-Lwoo/B Het beste uit de test <TitleElement> <TitleElementLevel>01 <TitleText>Werkboek <SequenceNumber>1
33 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
B01 van der Kleij L. van der Kleij <EditionNumber>1 01 dut <Extent> <ExtentType>00 <ExtentValue>64 02 <Subject> <MainSubject/> <SubjectSchemeIdentifier>32 <SubjectCode>180 <SupportingResource> 15 00 03 9789042530638_FCT.pdf <SupportingResource> 01 00 03 9789042530638_VRK.jpg 09 10 7000164 01 10 7913 01
34 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
YYYY 2006 <SupplyDetail> <Supplier> <SupplierRole>00 <SupplierName>TitelBank 99
35 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
6. 7. Bijlage: Taalcodes (ONIX codelijst 74) Waarde
Beschrijving
aar abk ace ach ada ady afa afh afr ain aka akk alb ale alg alt amh ang anp apa ara arc arg arm arn arp art arw asm ast ath aus ava ave awa aym aze bad bai bak bal bam ban baq bas bat
Afar Abkhaz Achinese Acoli Adangme Adygei Afroasiatic (Other) Afrihili (Artificial language) Afrikaans Ainu Akan Akkadian Albanian Aleut Algonquian (Other) Southern Altai Amharic English, Old (ca. 450-1100) Angika Apache languages Arabic Aramaic Aragonese Spanish Armenian Mapudungun; Mapuche Arapaho Artificial (Other) Arawak Assamese Asturian; Bable Athapascan (Other) Australian languages Avaric Avestan Awadhi Aymara Azerbaijani Banda languages Bamileke languages Bashkir Baluchi Bambara Balinese Basque Basa Baltic (Other)
36 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
bej bel bem ben ber bho bih bik bin bis bla bnt bos bra bre btk bua bug bul bur byn cad cai car cat cau ceb cel cha chb che chg chi chk chm chn cho chp chr chu
chv chy cmc cop cor cos cpe cpf
Beja Belarusian Bemba Bengali Berber (Other) Bhojpuri Bihari Bikol Bini; Edo Bislama Siksika Bantu (Other) Bosnian Braj Breton Batak languages Buriat Bugis Bulgarian Burmese Blin; Bilin Caddo Central American Indian (Other) Galibi Carib Catalan Caucasian (Other) Cebuano Celtic (Other) Chamorro Chibcha Chechen Chagatai Chinese Truk Mari Chinook jargon Choctaw Chipewyan Cherokee Church Slavic; Old Slavonic; Church Slavonic; Old Bulgarian; Old Church Slavonic Chuvash Cheyenne Chamic languages Coptic Cornish Corsican Creoles and Pidgins, English-based (Other) Creoles and Pidgins, French-based (Other)
37 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
cpp cre crh crp csb cus cze dak dan dar day del den dgr din div doi dra dsb dua dum dut dyu dzo efi egy eka elx eng enm epo est ewe ewo fan fao fat fij fil fin fiu fon fre frm fro frr frs fry ful fur
Creoles and Pidgins, Portuguese-based (Other) Cree Crimean Turkish; Crimean Tatar Creoles and Pidgins (Other) Kashubian Cushitic (Other) Czech Dakota Danish Dargwa Land Dayak languages Delaware Slave Dogrib Dinka Divehi; Dhivehi; Maldivian Dogri Dravidian (Other) Lower Sorbian Duala Dutch, Middle (ca. 1050-1350) Dutch; Flemish Dyula Dzongkha Efik Egyptian Ekajuk Elamite English English, Middle (1100-1500) Esperanto Estonian Ewe Ewondo Fang Faroese Fanti Fijian Filipino; Pilipino Finnish Finno-Ugrian (Other) Fon French French, Middle (ca. 1400-1600) French, Old (ca. 842-1400) Northern Frisian Eastern Frisian Western Frisian Fula Friulian
38 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
gaa gay gba gem geo ger gez gil gla gle glg glv gmh goh gon gor got grb grc gre grn gsw guj gwi hai hat hau haw heb her hil him hin hit hmn hmo hsb hun hup iba ibo ice ido iii ijo iku ile ilo ina inc
Gã Gayo Gbaya Germanic (Other) Georgian German Ethiopic Gilbertese Scottish Gaelic Irish Galician Manx German, Middle High (ca. 1050-1500) German, Old High (ca. 750-1050) Gondi Gorontalo Gothic Grebo Greek, Ancient (to 1453) Greek, Modern (1453-) Guarani Swiss German; Alemannic Gujarati Gwich'in Haida Haitian French Creole Hausa Hawaiian Hebrew Herero Hiligaynon Himachali Hindi Hittite Hmong Hiri Motu Upper Sorbian Hungarian Hupa Iban Igbo Icelandic Ido Sichuan Yi Ijo languages Inuktitut Interlingue Iloko Interlingua (International Auxiliary Language Association) Indic (Other)
39 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
ind ine inh ipk ira iro ita jav jbo jpn jpr jrb kaa kab kac kal kam kan kar kas kau kaw kaz kbd kha khi khm kho kik kin kir kmb kok kom kon kor kos kpe krc krl kro kru kua kum kur kut lad lah lam lao lat
Indonesian Indo-European (Other) Ingush Inupiaq Iranian (Other) Iroquoian (Other) Italian Javanese Lojban Japanese Judeo-Persian Judeo-Arabic Kara-Kalpak Kabyle Kachin; Jingpho Kalâtdlisut Kamba Kannada Karen languages Kashmiri Kanuri Kawi Kazakh Kabardian Khasi Khoisan (Other) Central Khmer Khotanese Kikuyu; Gikuyu Kinyarwanda Kirghiz; Kyrgyz Kimbundu Konkani Komi Kongo Korean Kusaie Kpelle Karachay-Balkar Karelian Kru languages Kurukh Kuanyama Kumyk Kurdish Kutenai Ladino Lahnda Lamba Lao Latin
40 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
lav lez lim lin lit lol loz ltz lua lub lug lui lun luo lus mac mad mag mah mai mak mal man mao map mar mas may mdf mdr men mga mic min mis mkh mlg mlt mnc mni mno moh mol mon mos mul mun mus mwl mwr myn
Latvian Lezgian Limburgish Lingala Lithuanian Mongo-Nkundu Lozi Luxembourgish; Letzeburgesch Luba-Lulua Luba-Katanga Ganda Luiseño Lunda Luo (Kenya and Tanzania) Lushai Macedonian Madurese Magahi Marshall Maithili Makasar Malayalam Mandingo Maori Austronesian (Other) Marathi Masai Malay Moksha Mandar Mende Irish, Middle (ca. 1100-1550) Mi'kmaq; Micmac Minangkabau Miscellaneous languages Mon-Khmer (Other) Malagasy Maltese Manchu Manipuri Manobo languages Mohawk Moldavian Mongolian Mooré Multiple languages Munda (Other) Creek Mirandese Marwari Mayan languages
41 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
myv nah nai nap nau nav nbl nde ndo nds nep new nia nic niu nno nob nog non nor nqo nso nub nwc nya nym nyn nyo nzi oci oji ori orm osa oss ota oto paa pag pal pam pan pap pau peo per phi phn pli pol
Erzya Nahuatl languages North American Indian (Other) Neapolitan Nauru Navajo Ndebele, South Ndebele, North Ndonga Low German; Low Saxon Nepali Newari Nias Niger-Kordofanian (Other) Niuean Norwegian Nynorsk Norwegian Bokmål Nogai Old Norse Norwegian N'Ko Pedi; Sepedi; Northern Sotho Nubian languages Classical Newari; Old Newari; Classical Nepal Bhasa Chichewa; Chewa; Nyanja Nyamwezi Nyankole Nyoro Nzima Occitan (post-1500); Provencal Ojibwa Oriya Oromo Osage Ossetian; Ossetic Turkish, Ottoman Otomian languages Papuan (Other) Pangasinan Pahlavi Pampanga Panjabi Papiamento Palauan Old Persian (ca. 600-400 B.C.) Persian Philippine (Other) Phoenician Pali Polish
42 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
pon por pra pro pus qar qav que raj rap rar roa roh rom rum run rup rus sad sag sah sai sal sam san sas sat scc scn sco scr sel sem sga sgn shn sid sin sio sit sla slo slv sma sme smi smj smn smo sms
Ponape Portuguese Prakrit languages Provençal (to 1500) Pushto Aranés Valencian Quechua Rajasthani Rapanui Rarotongan; Cook Islands Maori Romance (Other) Romansh Romany Romanian Rundi Aromanian; Arumanian; MacedoRomanian Russian Sandawe Sango Yakut South American Indian (Other) Salishan languages Samaritan Aramaic Sanskrit Sasak Santali Serbian Sicilian Scots Croatian Selkup Semitic (Other) Irish, Old (to 1100) Sign languages Shan Sidamo Sinhala; Sinhalese Siouan (Other) Sino-Tibetan (Other) Slavic (Other) Slovak Slovenian Southern Sami Northern Sami Sami languages (other) Lule Sami Inari Sami Samoan Skolt Sami
43 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
sna snd snk sog som son sot spa srd srn srr ssa ssw suk sun sus sux swa swe syr tah tai tam tat tel tem ter tet tgk tgl tha tib tig tir tiv tkl tlh tli tmh tog ton tpi tsi tsn tso tuk tum tup tur tut tvl
Shona Sindhi Soninke Sogdian Somali Songhai languages Sotho Spanish Sardinian Sranan Tongo Serer Nilo-Saharan (Other) Swazi Sukuma Sundanese Susu Sumerian Swahili Swedish Syriac Tahitian Tai (Other) Tamil Tatar Telugu Temne Terena Tetum Tajik Tagalog Thai Tibetan Tigré Tigrinya Tiv Tokelauan Klingon; tlhIngan-Hol Tlingit Tamashek Tonga (Nyasa) Tongan Tok Pisin Tsimshian Tswana Tsonga Turkmen Tumbuka Tupi languages Turkish Altaic (Other) Tuvaluan
44 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
twi tyv udm uga uig ukr umb und urd uzb vai ven vie vol vot wak wal war was wel wen wln wol xal xho yao yap yid yor ypk zap zen zha znd zul zun zza
Twi Tuvinian Udmurt Ugaritic Uighur; Uyghur Ukrainian Umbundu Undetermined Urdu Uzbek Vai Venda Vietnamese Volapük Votic Wakashan languages Walamo Waray Washo Welsh Sorbian languages Walloon Wolof Kalmyk Xhosa Yao Yapese Yiddish Yoruba Yupik languages Zapotec Zenaga Zhuang; Chuang Zande languages Zulu Zuni Zaza; Dimili; Dimli; Kirdki; Kirmanjki; Zazaki
45 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1
Redactie Titelbank p/a Bureau ISBN Postbus 360 4100 AJ Culemborg +31 (0)345 47 5855
[email protected]