gebruikershandleiding ONIX 3.0 Versie maart 2013

Transcriptie

1 gebruikershandleiding ONIX 3.0 Versie maart 2013

2 2 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

3 Inhoudsopgave 1. INLEIDING Opbouw document Uitgangsdocumentatie 5 2. Opbouw ONIX bericht Toelichting Headerrecord Sender composite, Sender name Addressee composite, Addressee identifier composite Product record Group P.1 (Record reference number, type and source ) en P P1.1 Record reference number P1.2 Notification or update type code P1.4 Record source type code De Product identifier composite BLOCK 1 DescriptiveDetail Group P.3 Product form Group 4 Product Part (wordt niet gebruikt in Titelbank) Group P.5 Collection Group P.6 Title Group P.7 Authorship Group P.9 Edition Group P.10 Language Group P.11 Extents and other content Group P.12 Subject Group P.13 Audience BLOCK 2 CollateralDetail Group P.14 Descriptions and other text Group P.15 Cited content Group P.16 Links to supporting resources BLOCK 3 ContentDetail BLOCK 4 PublishingDetail Group P.19 Publisher Group P.20 Global publishing status / copyright BLOCK 5 RelatedMaterial P.23 Related products Fout! Bladwijzer niet gedefinieerd BLOCK 6 ProductSupply P.26 Supply detail Onix-berichten downloaden Algemeen Totaalbestanden Mutatiebestanden Uitgeverbestanden Mapping ProductForms naar verschijningsvormen Voorbeeld Onix Bestand Header Titel (ProductRecord) Bijlage: Taalcodes (ONIX codelijst 74) 36 3 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

4 Wijziging in versie 3.1 Epub versie toegevoegd Short tags verwijderd uit de specificaties 4 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

5 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 Dit document is gepubliceerd op de website van de ONIX Werkgroep, 5 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

6 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 Voor elk besproken veld (data element) van het bestand worden in een tabel volgende punten aangegeven: DATA ELEMENT FIELD XML REFERENCE NAME (Onix) (TB) LIST A N POS. Waarbij: Data Element Field XML Reference Name Onix 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

7 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 FIELD XML REFERENCE NAME <ONIXMessage release= 3.0 > Onix Header composite <Header> M M Sender composite <Sender> M M Sender identifier composite <SenderIdentifier> O* M TB M M A Sender identifier type code H.1 <SenderIDType> M M 44 Identifier value H.3 < IDValue> M M Sender name H.4 <SenderName> O O A Addressee composite <Addressee> O O Addressee identifier composite Addressee identifier type code <AddresseeIdentifier> O O H.7 <AddresseeIDType> M M 44 N LIST A N POS. Identifier value H.9 <IDValue> M M N 7 Message sequence number H.13 <MessageNumber> O O N Message creation date/time H.15 <SentDateTime> M M A 13 H.1 <SenderIDType> Bevat 10, komt uit Code-list 44 en duidt aan dat het een Titelbank Relatie_ID betreft. H.3 < IDValue > Bevat het Relatie_ID van de uitgever. H.4 <SenderName> Bevat Titelbank in het uitgaande en de naam van de uitgever in het inkomende bericht. H.7 <AddresseeIDType> 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. H.9 <IDValue> Bevat het Relatie_ID van de uitgever. Wordt in het inkomende bericht bij de verwerking genegeerd. H.13 <MessageNumber> Bevat het volgnummer van het mutatiebericht. H.15 <SentDateTime> Bevat het datum en tijdstip waarop dit bericht gemaakt volgens het formaat YYYYMMDDTHH24MI waarin: 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) 7 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

8 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 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 Product record Het product record bevat de eigenlijke informatie per titel. Het record is als volgt ingedeeld: <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> 2.4. Group P.1 (Record reference number, type and source ) en P.2 DATA ELEMENT FIEL D XML REFERENCE NAME Onix TB LIS T A N P.1 Record reference number and type Record reference number P.1.1 <RecordReference> M M A 13 Notification or update type code P.1.2 <NotificationType> M M 1 N Record source type code P.1.4 <RecordSourceType> O O 3 N P.2 Product numbers Product identifier composite <ProductIdentifier> M M Product identifier type code P.2.1 pe> <ProductIDTy M M 5 N Identifier value P.2.3 <IDValue> M M N 13 P.1.1 <RecordReference> Bevat het ISBN van de titel. P.1.2 <NotificationType> Bevat 03 ( (Volledig record)) of 04 Update (Block Update). P1.4 <RecordSourceType> Bevat in het uitgaande bericht altijd 01 (Publisher). P2.1 <ProductIDType> POS. 8 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

9 Bevat altijd 03 (EAN), uit Code-list 05 duidt aan dat het om een EAN.UCC GTIN- 13 gaat. P2.3 <IDValue> Bevat het EAN/ISBN-13 van de titel 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 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 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 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 <RecordReference> 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

10 2.5. BLOCK 1 DescriptiveDetail <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 Group P.11 Illustrations and ancillary content Group P.11 Subject Group P.12 Audience Group P.13 </DescriptiveDetail> 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 P3.1 <ProductComposition> M M 2 A 2 Product Form Code P.3.2 <ProductForm> M A 150 A Product Form Detail P.3.3 <ProductFormDetai ;> O S 175 A 5 Product Form Feature Composite <ProductFormfeature> O ProductFormFeatureType Code P.3.4 <ProductFormFeatureType> M A 79 N 2 ProductFormFeatureValue P.3.5 <ProductFormfeatureValue> M A N 1 Einde ProductFormFeature Composite </ProductFormFeature> ProductForm Description P.3.8 ProductFormdescription O S A 255 Epub technical Protection P. <EpubtechnicalProtection> O O 144 N P.3.1 <Product composition> 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. P.3.2 <ProductForm> P.3.3 <ProductFormDetail> 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. Oni x A/ S CB LIS T A N POS. 10 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

11 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 <ProductFormFeature> composite. Hieronder een voorbeeld van een epub3: <ProductForm>ED</ProductForm> <ProductFormDetail>E101</ProductFormDetail> <ProductFormFeature> <ProductFormFeatureType>10</ProductFormFeatureType> <ProductFormFeatureValue>3</ProductFormFeatureValue> </ProductFormFeature> <EpubTechnicalProtection>02</EpubTechnicalProtection> 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 ED E101 3 Eboek: Epub zonder DRM, download ED E101 0 Eboek: Epub met digitaal watermerk, download ED E101 2 Eboek: bundel, download ED E101 Eboek: Epub, Adobe DRM, download/online EB E101 3 Eboek: Epub, digitaal waterwerk, download/online EB E101 0 Eboek: Epub zonder DRM, download/online EB E101 2 Eboek: bundel, download/online EB E101 Eboek: PDF met Adobe DRM ED E107 3 Eboek: PDF zonder DRM ED E107 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

12 XA XB XC XD XE Promotiemateriaal Display (leeg) Display (gevuld) Display (leeg) Display (gevuld) 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 Group P.5 Collection In Group 5 worden de gegevens van de bibliografische reeks opgenomen. DATA ELEMENT FIELD XML REFERENCE NAME Onix Collection composite <Collection> O O TB Collection type code P.5.1 <CollectionType> M M 148 A Title detail composite <TitleDetail> O O Title type P.5.6 <TitleType> M M 15 A Title elementcomposite <TitleElement> M M Title element level P.5.7 <TitleElementLevel> M M 149 A Part number P.5.8 <PartNumber> O O LIST A N POS. N Title text No series indicator (empty element) P.5.10 M M A <TitleText> P.5.62 <NoCollection/> O O <Collection> Collection wordt alleen uitgeschreven als de titel onderdeel is van een reeks P.5.1 <CollectionType> Bevat 10 (Publisher collection) <TitleDetail> P.5.6 <TitleType> Bevat 01 (Distinctive title) uit Code list 15 <TitleElement> P.5.7 <TitleElementLevel> Bevat 02 (Collection) uit Code list 149 P.5.8 <PartNumber> Bevat het reeks nummer P.5.10 <TitleText> Bevat de reeks naam. P.5.62 <NoCollection/> 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

13 <Collection> <Collectiontype>10</CollectionType> Publisher collection <TitleDetail> <TitleType>01</TitleType> <TitleElement> <TitleElementLevel>02</TitleElementLevel> Collection level <PartNumber>III</PartNumber> <TitleText> Memoire en Images </TitleText> Publisher s series title </TitleElement> </TitleDetail> </Collection> Group P.6 Title In Group 6 worden de titelgegevens opgenomen: hoofdtitel, deeltitel, sectietitel en ondertitel. DATA ELEMENT FIELD XML REFERENCE NAME Onix TB LIST A N Title detail composite <TitleDetail> M M Title type P.6.1 <TitleType> M M 15 A Title element <TitleElement> M M composite Title element level P.6.2 <TitleElementLevel> M M 149 A POS. Title text P.6.5 <TitleText> O M A 2000 Subtitle P.6.8 <Subtitle> O O A 2000 Title element Composite <TitleElement> O O Title element level P.6.2 <TitleElementLevel> M M 149 A Part number P.6.3 <PartNumber> O M N Title text P.6.5 <TitleText> O M A 2000 Title element <TitleElement> O O Composite Title element level P.6.2 <TitleElementLevel> M M 149 A Title text P.6.5 <TitleText> O M A 2000 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

14 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) 14 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

15 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> 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 Voorbeeld meerdelig werk met hoofdtitel, ondertitel, sectietitel, deelnummer en deeltitel: (Percent - 2 Economie Bovenbouw HAVO Antwoordenboek) Product Identifier <ProductIdentifier> Identifier of product <ProductIDType>03</ProductIDType> GTIN-13 / ISBN <IDValue> </IDValue> </ProductIdentifier> Product form <ProductComposition>00</ProductComposition> Single-item product <ProductForm>BC</ProductForm> Paperback book Product title <TitleDetail> <TitleType>01</TitleType> <TitleElement> <TitleElementLevel>02</TitleElementLevel> Collection Level <TitleText>Percent</TitleText> 15 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

16 <Subtitle>samen boeken we succes</subtitle> </TitleElement> <TitleElement> <TitleElementLevel>03</TitleElementLevel> Subcollection Level <PartNumber>2</PartNumber> <TitleText>Economie bovenbouw Havo</TitleText> </TitleElement> <TitleElement> <TitleElementLevel>01</TitleElementLevel> Product Level <TitleText>Antwoordenboek</TitleText> </TitleElement> <TitleDetail> Als er een TitleElementLevel 02 (Collection) of 03(Subcollection) wordt aangeleverd, dan moet ofwel PartNumber ofwel TitleText zijn gevuld, beiden mogen gevuld zijn 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 FIELD XML REFERENCE NAME Onix TB LIST A N POS. Contributor <Contributor> O O composite Contributor N 3 P.7.1 <SequenceNumber> O M sequence number Contributor role 17 A P.7.2 <ContributorRole> M M code Person name part A 255 P.7.12 <NamesBeforeKey> O O 2 Person name part A 255 P.7.13 <PrefixToKey> O O 3 Person name part A 255 P.7.14 <KeyNames> O O 4 Corporate name P.7.19 <CorporateName> O O A 255 No authorship indicator (empty element) P.7.50 <NoContributor/> O O <Contributor> Wordt geschreven per betrokkene. Wanneer er geen betrokkene is wordt P.7.50 geschreven. P.7.1 <SequenceNumber> Bevat het volgnummer van de betrokkene P.7.2 <ContributorRole> Bevat de soort betrokkenheid, afkostig uit Code List / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

17 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 <NamesBeforeKey> P.7.13 <PrefixToKey> 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 <KeyNames> Bevat de achternaam van de betrokkene P.7.19 <CorporateName> 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: <Contributor> <ContributorRole>Z99</ContributorRole> <UnnamedPersons>03</UnnamedPersons> </Contributor> P.7.50 </NoContributor> Wordt geschreven wanneer er geen betrokkenen zijn 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

18 DATA ELEMENT FIELD XML REFERENCE NAME Onix TB LIST A N POS. Edition number P.9.2 <EditionNumber> O O N 30 Edition version O A 3 P.9.3 <EditionVersionNumber> O number Edition statement P.9.4 <EditionStatement> O O 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 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 /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 ELEMENT Language composite FIELD XML REFERENCE NAME <Language> Onix O TB M LIST A N POS. Language role P.10.1 <LanguageRole> M M 22 A Language M 74 A 3 P.10.2 <LanguageCode> M code <Language> Wordt alleen geschreven wanneer er een taalkode aanwezig is bij deze titel P.10.1 <LanguageRole> 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 <LanguageCode> Bevat de taalkode volgens de ISO 639-2/B standaard, aanwezig in Code list 74. Deze codelijst kunt u vinden in bijlage 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 Onix TB LIST A N POS. 18 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

19 Extent O <Extent> O composite Extent type <ExtentType> M 23 P.11.1 M code Extent value P.11.2 <ExtentValue> O M A 20 Extent value O A 20 in Roman numerals P.11.3 <ExtentValueRoman> O Extent unit P.11.4 <ExtentUnit> M M 24 Extent composite Extent type code P.11.1 <Extent> <ExtentType> O M O M 23 Extent value P.11.2 <ExtentValue> O M A 50 Extent unit P.11.4 <ExtentUnit> M M 24 Illustrated / not illustrated flag P.11.5 <Illustrated> O M 152 <Extent> Wordt geschreven wanneer het aantal pagina s aanwezig is P.11.1 <ExtentType> Bevat 00 (Main content page count), 03 (proloog) of 04 (epiloog) P.11.2 <ExtentValue> Bevat het aantal pagina s van de hoofdinhoud. P.11.3 <ExtentValueRoman> 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> P.11.2 <ExtentValue> P.11.4 <ExtentUnit> 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 Omvang eenheid Omschrijving Inkomend/ uitgaand Extentunit Extenttype WRD Woorden PGN Pagina s 03 00,03,04 00 UMS Uren, minuten en seconden (HHHMMSS) BYT Bytes KBS Kilobyte MBS Megabytes Uitgaande extenttype P.11.5 <Illustrated> 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

20 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 FIELD XML REFERENCE NAME <Subject> P.12.1 <MainSubject/> O Onix O TB M M LIST A N POS. Subject scheme M 27 P.12.2 <SubjectSchemeIdentifier> M identifier Subject code P.12.5 <SubjectCode> O M A 5 Subject composite Subject scheme identifier <Subject> P.12.2 <SubjectSchemeIdentifier> M M 27 Subject code P.12.5 <SubjectCode> O M A 5 Indien een NUR code wordt aangeleverd, gebeurt dit als volgt: <Subject> P.12.1 <MainSubject/> O 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. P.12.2 <SubjectSchemeIdentifier> Bevat 32 (NUR), afkomstig uit Code list 27 P.12.5 <SubjectCode> Bevat de NUR code O <Subject> P.12.1 <MainSubject> P.12.2 <SubjectSchemeIdentifier> P.12.5 <SubjectCode> 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 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 <Audience> Onix O TB O LIST A N POS. 20 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

21 Audience code type Audience code value P.13.2 <AudienceCodeType> P.13.4 <AudienceCodeValue> M M M 29 M A 10 <Audience> Wordt geschreven als er een AVI code aanwezig is. P.13.2 <AudienceCodeType> Bevat 09 (AVI) P.13.4 <AudienceCodeValue> 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

22 2.6. BLOCK 2 CollateralDetail In dit Block kan verrijkte titelinformatie zoals covers, flapteksten, recensies, inkijktekst en andere promotionele gegevens worden onderhouden. <CollateralDetail> Block 2 Descriptions and other text Group P.14 Cited content Group P.15 Links to supporting resources Group P.16 </ CollateralDetail > 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 FIELD XML REFERENCE NAME Onix Text content composite <TextContent> O O TB Text type code P.14.1 <TextType> M M 153 Text audience P.14.2 <ContentAudience> M M 154 Text P.14.3 <Text> M M A LIST A N POS. Author of quoted text P.14.4 <TextAuthor> O O Corporate source of P.14.5 O O quoted text <TextSourceCorporate> Title of source P.14.6 <SourceTitle> O O 100 Content date composite <ContentDate> O O Content date role P.14.7 <ContentDateRole> M M 155 Date format P.14.8 <DateFormat> M M 55 Date P.14.9 <Date> M M 8 P.14.1 <TextType> Het type content dat wordt aangeleverd wordt bepaald ahv List 153. Een waarde uit deze lijst wordt in het veld PR.14.1 <TextType> 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 <TextType> 06 (recensies) is het verplicht om ook de elementen TextAuthor, TextSourceCorporate en ContentDate te vullen P.14.2 <ContentAudience> Standaard wordt de waarde 03 (eindgebruikers) in het veld 22 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

23 P14.2 opgenomen. Alleen om commerciële aanbiedingsinformatie door te geven, kan waarde 02 (handel) gebruikt worden. P.14.3 <Text> Hierin wordt de tekst van de content aangeleverd P.14.4 <TextAuthor> De naam van de auteur van een tekst P.14.5 <TextSourceCorporate> De naam van de bron van de tekst P.14.6 <SourceTitle> Wordt alleen geschreven bij recensies en bevat de titel van de recensie <ContentDate> Wordt alleen geschreven bij recensies P.14.7 <ContentDateRole> Bevat 01 (Publication date) P.14.8 <DateFormat> Bevat 00 (YYYYMMDD) waarin Date geschreven wordt P.14.9 <Date> Bevat de datum van de recensie Textcontent TextType (P.14.1) ContentAudience (P.14.2) Voor Annotatie (=Unirestricted) Voor Flaptekst (=Unirestricted) Voor Inhoudsopgave (=Unirestricted) Voor Inkijktekst (=Unirestricted) Voor Recensies (=Unirestricted) Voor Promotionele teksten (=Unirestricted) Text (P.14.3) De annotatie De flaptekst De inhoudsopgave De inkijktekst TextAuthor (P.14.4) De recensie De auteur De bron De promotionele tekst TextSourceCorporate (P.14.5) 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 FIELD XML REFERENCE NAME Onix TB Cited content composite <CitedContent> O O Citation type code P.15.1 <CitedContentType> M M 156 Source type P.15.3 <SourceType> O M 157 Title of source P.15.4 <SourceTitle> O O Link to cited content P.15.8 <ResourceLink> O M URL LIST A N POS. <CitedContent> P.15.1 <CitedContentType> P.15.3 <SourceType> P.15.4 <SourceTitle> P.15.8 <ResourceLink> 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

24 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 FIELD XML REFERENCE NAME Onix TB Supporting resource O <SupportingResource> O composite Resource content type P.16.1 code <ResourceContentType> M M 158 Target audience code P.16.2 <ContentAudience> M M 154 Resource mode code P.16.3 <ResourceMode> M M 159 Resource version composite <ResourceVersion> M M Resource form code P.16.7 <ResourceForm> M M 161 Link to resource content - URL P <ResourceLink> M M LIST A N POS. A 100 <SupportingResource> P.16.1 <ResourceContentType> P.16.2 < ContentAudience > P.16.3 <ResourceMode> P.16.7 <ResourceForm> P <ResourceLink> 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

25 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 <PublishingDetail> Block 4 Publisher Group P.19 Global publishing status / copyright Group P.20 </ PublishingDetail> Group P.19 Publisher DATA ELEMENT FIELD XML REFERENCE NAME Onix TB LIST A N POS. Imprint or brand composite <Imprint> O O Imprint name P.19.4 <ImprintName> O M A 80 Publisher composite <Publisher> O O Publishing role code P.19.5 <PublishingRole> M M 45 Publisher <PublisherIdentifier> O M identifiercomposite Publisher identifier 44 P.19.6 <PublisherIDType> M M type Identifier value P.19.8 <IDValue> M M N 7 <Imprint> 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 <Imprint> <ImprintName>, tag <b079> Naam van de bibliografische imprint </Imprint>. <Publisher> P19.5 <PublishingRole> Wordt gevuld met de waarde 01 (huidige uitgever). <PublisherIdentifier> P.19.6 <PublisherIDType> Bevat 10 uit Code list 44 en geeft aan dat het relatie id dat in <IDValue> staat het Titelbank Relatie_ID 25 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

26 Group P.20 Global publishing status / copyright DATA ELEMENT FIELD XML REFERENCE NAME Onix TB LIST A N POS. Global A publishing status P.20.1 <PublishingStatus> O O 64 Publishing date <PublishingDate> O O composite Publishing <PublishingDateRole> A date role code P.20.3 M M 163 Date A P.20.4 <DateFormat> M M 55 format Date P.20.5 <Date> M M N 4 P.20.1 <PublishingStatus> Alleen titels met de status Verkrijgbaar worden gecommuniceerd in het ONIX bericht van Titelbank. Dit wordt aangegeven met PublishingStatus 04. <PublishingDateRole> Bevat 01 (Publication date) uit Code list 163 P.20.4 <DateFormat> 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 <Date> De (vermoedelijke) verschijningsdatum van de titel 2.9. BLOCK 5 RelatedMaterial <RelatedMaterial> Block 5 Related products Group P.23 </ RelatedMaterial> 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 FIELD XML REFERENCE NAME Onix TB LIST A N POS. Related product <RelatedProduct> O O composite Relation code P.23.1 <ProductRelationCode> M M 51 Product identifier <ProductIdentifier> O O composite Product identifier type 5 P.23.2 <ProductIDType> M M code Identifier value P.23.4 <IDValue> M M A / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

27 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. <RelatedMaterial> <RelatedProduct> <ProductRelationCode>01</ProductRelationCode> <ProductIdentifier> <ProductIDType>11</ProductIDType> <IDValue>A AF36</IDValue> </ProductIdentifier> </RelatedProduct> </RelatedMaterial> <RelatedMaterial> <RelatedProduct> <ProductRelationCode>02</ProductRelationCode> <ProductIdentifier> <ProductIDType>11</ProductIDType> <IDValue> A </IDValue> </ProductIdentifier> </RelatedProduct> 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 <RelatedMaterial> <RelatedProduct> <ProductRelationCode>05</ProductRelationCode> <ProductIdentifier> <ProductIDType>03</ProductIDType> <IDValue> </IDValue> </ProductIdentifier> </RelatedProduct> </RelatedMaterial> 27 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

28 2.12. BLOCK 6 ProductSupply <ProductSupply> Block 6 Supply detail Group P.26 </ ProductSupply> P.26 Supply detail Het Block ProductSupply wordt in Titelbank gebruikt om gegevens over de prijzen te communiceren. DATA ELEMENT FIELD XML REFERENCE NAME Onix TB LIS T A N POS. Supply detail composite <SupplyDetail> M O Supplier composite <Supplier> M M Supplier role P.26.1 <SupplierRole> M M 93 Supplier name P.26.5 <SupplierName> O O Product availability P M M 7 <ProductAvailability> Price composite <Price> O M Price type code P.26.4 <PriceType> M M 58 3 Price amount P <PriceAmount> M M N 6 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 <PriceType> wordt altijd 02 P < PriceAmount > Bevat de prijs van de titel in format / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

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

30 uitgevers beschikbaar in de FTP-map /data/uitgevers/<u >/download/. Met de term <U > 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

31 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

32 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 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1

33 5. Voorbeeld Onix Bestand 5.1. Header <ONIXMessage release="3.0" xmlns=" <Header> <Sender> <SenderName>Titelbank</SenderName> </Sender> <Addressee> <AddresseeIdentifier> <AddresseeIDType>10</AddresseeIDType> </AddresseeIdentifier> <IDValue> </IDValue> </Addressee> <SentDateTime> T1613</SentDateTime> </Header> 5.2. Titel (ProductRecord) <Product> <RecordReference> </RecordReference> <NotificationType>03</NotificationType> <RecordSourceType>01</RecordSourceType> <ProductIdentifier> <ProductIDType>03</ProductIDType> <IDValue> </IDValue> </ProductIdentifier> <DescriptiveDetail> <ProductComposition>00</ProductComposition> <ProductForm>00</ProductForm> <NoCollection/> <TitleDetail> <TitleType>01</TitleType> <TitleElement> <TitleElementLevel>02</TitleElementLevel> <TitleText>Bekijk het!</titletext> <Subtitle>bio & verzorging</subtitle> </TitleElement> <TitleElement> <TitleElementLevel>03</TitleElementLevel> <TitleText>15 Vmbo-Lwoo/B Het beste uit de test</titletext> </TitleElement> <TitleElement> <TitleElementLevel>01</TitleElementLevel> <TitleText>Werkboek</TitleText> </TitleElement> </TitleDetail> <Contributor> <SequenceNumber>1</SequenceNumber> 33 / Titelbank gebruikershandleiding ONIX 3.0 versie 3.1