Cantook Édition

Importer des métadonnées en format ONIX 3.0

Vous pouvez importer facilement un lot de nouvelles publications, ou modifier les métadonnées de publications existantes, en utilisant un fichier formaté selon le standard ONIX 3.0.

Pour une description générale du processus d'importation, consultez cet article. Vous pouvez aussi importer vos données en utilisant le rapport Excel dynamique.

Notez que l'importation par ONIX de métadonnées d'un livre audio comporte des particularités.

Formater le fichier ONIX 3.0

Structure du fichier ONIX 3.0

Vous trouverez ci-dessous une description de chacune des balises ONIX 3.0 disponibles.

Tableau des balises ONIX 3.0


Balise ONIX 3.0 

Obligatoire Facultatif
Répétable

Liste de codes ONIX

Valeurs ou Format

Description

<ONIXMessage release="3.0">





<Header>





<Sender>





<SenderIdentifier>





<SenderIDType>

Facultatif

44

6

06: GLN

<IDTypeName>

Facultatif


GLN

« GLN »

<IDValue>

Facultatif




</SenderIdentifier>





<SenderName>

Facultatif




<ContactName>





<EmailAddress>





</Sender>





<MessageNumber>

Facultatif


1


<SentDateTime>

Facultatif


Date

Ex. 20110309T022935Z

<DefaultLanguageOfText>

Facultatif


fre


<DefaultCurrencyCode>

Facultatif

96

Code de 3 lettres

ISO 4217 - Ex. 'CAD', 'USD', 'EUR', 'GBP'

</Header>





<Product>





<RecordReference>

Obligatoire

1

Texte

Numéro interne d'identification

<NotificationType>

Obligatoire

1

03; 04; 05

03: Confirmation publication reçue
04: Mise à jour
05: Suppression

<ProductIdentifier>

Répétable




<ProductIDType>

Obligatoire

5

01; 02; 03; 15

01: Clé interne
02: ISBN 10
03: EAN
15: ISBN 13

<IDValue>

Obligatoire


Nombre

Identifiant (ex. ISBN)

</ProductIdentifier>





<DescriptiveDetail>

Obligatoire




<ProductComposition>

Obligatoire

2

0

00: Item en vente

<ProductForm>

Obligatoire

150

EA

EA: Numérique

<ProductFormDetail>

Facultatif
(seulement si ProductForm=EA)

175

E101; E107; E127

E101: EPUB
E107: PDF
E127: MOBI
E200 (avec E101) - Reformatable
E201 (avec E101) – Mise en page fixe

<ProductFormFeature>





<ProductFormFeatureType>

Facultatif

79

09; 12; 15

09: Métadonnées d'accessibilité

12: Dangers

15: Version EPUB

<ProductFormFeatureValue>

Facultatif

143 (Dangers)

196 (Accessibilité)

220 (Version EPUB)

Toutes les valeurs possibles de chaque liste

Voir

Niveau d'accessibilité - Valeurs possibles

<ProductFormFeatureDescription>

Facultatif


Texte

Complément d'information (par exemple, une URL, etc.)

</ProductFormFeature>





<EpubTechnicalProtection>

Facultatif
(seulement si ProductForm=EA)

144

00; 02; 03; 06

00: Aucune
02: Filigrane
03: DRM Adobe
06: Readium LCP

<EpubUsageConstraint>

Répétable




<EpubUsageType>

Obligatoire

145

02; 03; 04

02: Imprimer
03: Copier / Coller
04: Partage

<EpubUsageStatus>

Obligatoire

146

01; 02; 03

01: Permis sans restrictions
02: Permis avec restrictions
03: Interdit

<EpubUsageLimit>

Répétable




<Quantity>

Facultatif


Nombre

Quantité permise, ex.: 6

<EpubUsageUnit>

Facultatif
(seulement si EpubUsageType=04)

147

06; 09

06: Nombre maximal d'appareils autorisés
09: jours

</EpubUsageLimit>





</EpubUsageConstraint>





<TitleDetail>





<TitleType>


15

01


<TitleElement>





<TitleElementLevel>


149

01


<TitleText>




Titre

<Subtitle>




Sous-titre

</TitleElement>





</TitleDetail>





Une collection:





 <Collection> *

Facultatif



* Voir aussi CollateralDetail / TextContent / TextType 17 et WebSite / Web

 <CollectionType>

Obligatoire si collection

 148

11

11: Collection éditoriale

 <TitleDetail>

Obligatoire si collection




 <TitleType>

Obligatoire si collection

 15

01

01: Titre distinctif

 <TitleElement>

Obligatoire si collection




 <TitleElementLevel>

Obligatoire si collection

 149

02

02: Titre de la collection (haut niveau)

 <TitleText>

Obligatoire si collection


Texte

Le titre de la collection, format texte

 </TitleElement>





 </TitleDetail>





 </Collection





Une série:





 <Collection> *

Facultatif



* Voir aussi CollateralDetail / TextContent / TextType 17 et WebSite / Web

 <CollectionType>

Obligatoire si série

 148

10

10: Collection éditeur

 <CollectionIdentifier>

Facultatif




 <CollectionIDType>


 13

01

01: Propriétaire

 <IDValue>

Facultatif



Code interne de la série

 </CollectionIdentifier>





 <TitleDetail>

Obligatoire si série




 <TitleType>

Obligatoire si série

 15

01

01: Titre distinctif

 <TitleElement>

Obligatoire si série




 <TitleElementLevel>

Obligatoire si série

 149

02

02: Titre de la collection (haut niveau)

 <TitleText>

Obligatoire si série


Texte

Le titre de la série, format texte

 </TitleElement>





 <TitleElement>

Facultatif




 <TitleElementLevel>


 149

01

01: Titre

 <PartNumber>



Texte

La partie numérique avec son descriptif, tel qu'il doit être indiqué chez les libraires (ex.: "Volume 1" ou "Tome 2" ou "Décembre 2015".

 </TitleElement>





 </TitleDetail>





 </Collection>





Une collection ET une série





 <Collection>

Facultatif



* Voir aussi CollateralDetail / TextContent / TextType 17 et WebSite / Web

 <CollectionType>


 148

10

10: Collection éditeur

 <CollectionIdentifier>





 <CollectionIDType>


 149

02

02: Titre de la série

 <IDValue>



Texte

Identifiant de la série, exemple son ISSN dans le cas d'un périodique

 <CollectionSequence>





 <CollectionSequenceType>


 197

03

03: Ordre de la publication dans la série

 <CollectionSequenceNumber>



Nombre

Ordre de la publication dans la série. Exemple "2" ou "24". Partie numérique seulement.

 </CollectionSequence>





 </CollectionIdentifier>





 <TitleDetail>





 <TitleType>


 15

01

01: Titre distinctif

 <TitleElement>





 <TitleElementLevel>


 149

02

02: Titre de la collection

 <TitleText>



Texte

Le titre de la collection, en format texte

 </TitleElement>





 <TitleElementLevel>


 149

01

01: Titre distinctif

 <TitleText>



Texte

La partie numérique avec son descriptif, tel qu'il doit être indiqué chez les libraires (ex.: "Volume 1" ou "Tome 2" ou "Décembre 2015".

 </TitleElement>





 </TitleDetail>





 </Collection>





<TitleDetail>

Répétable




<TitleType>

Obligatoire

15

1

01: Type de titre

<TitleElement>





<TitleElementLevel>

Obligatoire

149

1

01: Produit

<TitleText>

Obligatoire


Texte

Titre de la publication

<TitlePrefix>

Facultatif


Texte

Préfixe

<TitleWithoutPrefix>

Facultatif


Texte

Titre sans le préfixe (pour le tri)

<Subtitle>





</TitleElement>





</TitleDetail>





<Contributor>

Répétable




<SequenceNumber>

Obligatoire


Nombre

Un nombre plus élevé indique un contributeur de moindre importance.

<ContributorRole>

Obligatoire

17


Type de contribution

      A01: "author"
      A02: "with"
      A03: "screenplay_writer"
      A04: "libretto_writer"
      A05: "lyrics_author"
      A06: "composer"
      A07: "artist"
      A08: "photographer"
      A09: "created_by"
      A10: "from_an_idea_by"
      A11: "designed_by"
      A12: "illustrated_by"
      A13: "photographs_by"
      A14: "text_author"
      A15: "preface_author"
      A16: "prologue_author"
      A17: "summary_author"
      A18: "supplement_author"
      A19: "afterword_author"
      A20: "notes_author"
      A21: "commentaries_author"
      A22: "epilogue_author"
      A23: "foreword_author"
      A24: "introduction_author"
      A25: "footnotes_author"
      A26: "memoir_author"
      A27: "experiments_author"
      A29: "introduction_and_notes_author"
      A30: "software_writer"
      A31: "book_and_lyrics_author"
      A32: "contributions_author"
      A33: "appendix_author"
      A34: "index_compiler"
      A35: "drawings_by"
      A36: "cover_design_or_artwork_by"
      A37: "preliminary_work_by"
      A38: "original_author"
      A39: "maps_by"
      A40: "inked_or_colored_by"
      A41: "pop_ups_by"
      A42: "continued_by"
      A43: "interviewer"
      A44: "interviewee"
      A99: "other_primary_creator"
      B01: "edited_by"
      B02: "revised_by"
      B03: "retold_by"
      B04: "abridged_by"
      B05: "adapted_by"
      B06: "translated_by"
      B07: "as_told_by"
      B08: "translated_with_commentary_by"
      B09: "series_edited_by"
      B10: "edited_and_translated_by"
      B11: "editor_in_chief"
      B12: "guest_editor"
      B13: "volume_editor"
      B14: "editorial_board_member"
      B15: "editorial_coordination_by"
      B16: "managing_editor"
      B17: "founded_by"
      B18: "prepared_for_publication_by"
      B19: "associate_editor"
      B20: "consultant_editor"
      B21: "general_editor"
      B22: "dramatized_by"
      B23: "general_rapporteur"
      B24: "literary_editor"
      B25: "music_arranged_by"
      B26: "technical_editor"
      B99: "other_adaptation_by"
      C01: "compiled_by"
      C02: "selected_by"
      C99: "other_compilation_by"
      D01: "producer"
      D02: "director"
      D03: "conductor"
      D99: "other_direction_by"
      E01: "actor"
      E02: "dancer"
      E03: "narrator"
      E04: "commentator"
      E05: "vocal_soloist"
      E06: "instrumental_soloist"
      E07: "read_by"
      E08: "performed_by_orchestra_band_ensemble"
      E09: "speaker"
      E99: "performed_by"
      F01: "filmed_photographed_by"
      F99: "other_recording_by"
      Z01: "assisted_by"
      Z98: "various_roles"
      Z99: "other"

<PersonName>

Obligatoire


Texte

Prénom et nom de famille

<PersonNameInverted>

Facultatif


Texte

Nom de famille, prénom

<NamesBeforeKey>

Obligatoire


Texte

Première partie du nom. Ex.: René J.

<KeyNames>

Obligatoire


Texte

Deuxième partie du nom. Ex.: Blanchet

<BiographicalNote>



Texte

Note biographique du contributeur

<Website>





<WebsiteRole>

Facultatif

73

01;

01: Site Web de l'éditeur
02: Site Web d'un ouvrage spécifique
14: Site Web spécifiquement consacré à une série

<WebsiteLink>

Facultatif


URL

URL

<Website>





<ContributorPlace>





<ContributorPlaceRelator>


151


04: Habite ce pays
08: Citoyen de

<CountryCode>




Code ISO 3166-1 à deux lettres: "fr", "us", "ca"

</ContributorPlace>





</Contributor>





<NoEdition/>

Facultatif



Si le texte est un original

<Language>

Répétable




<LanguageRole>

Facultatif

22

01; 02

01: Langue
02: Langue d'origine

<LanguageCode>

Facultatif

74

Code de langue ISO 639-2/B.

Ex.: fre; ita; eng

</Language>





<Extent>

Répétable




<ExtentType>

Obligatoire

23

00; 08; 03; 22

00, 08: Nombre de pages

03: Nombre de pages romaines en début du livre22: Poids du fichier

<ExtentValue>

Obligatoire


Nombre

Valeur

<ExtentUnit>

Facultatif
(seulement si ExtentType=22)

24

19

03: Pages
19: Mégaoctects (si ExtentType = 22);

</Extent>





<Subject>

Répétable



Classifications

<MainSubject/>

Répétable
pour classification primaire



À utiliser seulement pour la classification principale.

<SubjectSchemeIdentifier>

Obligatoire

27

01; 10; 12; 24; 28; 29; 93

01: Dewey
10: BISAC
12: BIC
20: Keywords
24: Custom
28: Electre
29: CLIL
93: Thema

<SubjectSchemeName>





<SubjectCode>

Facultatif



Valeur

<SubjectHeadingText>

Facultatif



Texte de classification - Selon le SubjectSchemeIdentifier

</Subject>





<Audience>

Facultatif
Répétable




<AudienceCodeType>

Facultatif

29

01;02;06;

01: Codes Onix
02: Propriétaire (Groupe d'âges)
06: Public cible (BTLF)
Voir <AudienceCodeTypeName>

<AudienceCodeValue>

Facultatif



Valeurs possibles:

  • 01: Générale

  • 0002: 0 à 2 ans

  • 0305: 3 à 5 ans

  • 0608: 6 à 8 ans

  • 0912: 9 à 12 ans

  • 1399: 13 ans et plus

</Audience>





 <AudienceRange>

Facultatif




 <AudienceRangeQualifier>

Facultatif


17

 17: âges d'intérêt

 <AudienceRangePrecision>

Facultatif


03

 03: À partir de (peu être utilisé seul)

 <AudienceRangeValue>

Facultatif



 Âge minimal

 <AudienceRangePrecision>

Facultatif


04

 04: Jusqu'à

 <AudienceRangeValue>

Facultatif



 Âge maximal

 </AudienceRange>





<Prize>





<PrizeName>

Facultatif


Texte

Nom du prix littéraire

<PrizeYear>

Facultatif


Année

Exemple: 2014

<PrizeCountry>

Facultatif



Code de pays, en format ISO 3166-1

<PrizeCode>

Facultatif


01; 02; 03; 04; 05; 06;

01: Gagnant
02: Second
03: Recommandé
04: Retenu - Liste courte
05: Retenu - Liste longue
06: Gagnant  Ex-eaquo

</Prize>





</DescriptiveDetail>





<CollateralDetail>





<TextContent>

Répétable




<TextType>

Obligatoire

153

02; 03; 04; 05; 06; 09; 10; 12; 14; 17;

Type de texte
02: Commentaire
03: Description
04: Table des matières
05: Présentation
06: Citation d'une critique
09: Éloges et recommandations
10: Phrase promotionnelle
12: Note biographique
14: Court extrait
17: Description de la série (voir <Collection>)

<ContentAudience>

Obligatoire

154

0

Public cible.
00: Sans restrictions

<Texte>

Obligatoire


Texte

Texte.

</TextContent>





<SupportingResource>

Répétable




<ResourceContentType>

Obligatoire

158

01; 02; 03; 04; 11; 15; 16; 17; 20; 21; 24; 26

01: Couverture principale
02: Couverture arrière
03: Autre couverture
04: Photo du contributeur
11: Entrevue
15: Extrait
16: URL du lecteur en ligne
17: Critique
20: Guide du professeur
21: Article
24: Communiqué de presse
26: Bande-annonce
 

<ContentAudience>

Répétable

154

0

Public cible.
00: Sans restrictions

<ResourceMode>

Obligatoire

159

01; 02; 03; 04; 05; 06

1: Application
02: Audio
03: Image
04: Texte
05: Vidéo
06: Multi-mode


Extensions de fichiers:
02: 'mp3', 'wav', 'wma', 'mp4'
03: 'png', 'bmp', 'jpg', 'jpeg', 'gif', 'tif'
04: 'doc', 'docx', 'xls', 'xlsx', 'odp', 'ods', 'odt', 'epub', 'pdf', 'txt', 'rtf'
05: 'flv', 'mpeg', 'mpg', 'avi', 'mov'

<ResourceFeature>

Facultatif




<ResourceFeatureType

Obligatoire

160

2

Texte explicatif d'une ressource (ex. descriptif d'une photographie)
Important: pour lier la photo d'un contributeur avec la description, utiliser 02 ici et le nom du contributeur doit être le même que sur la plateforme.

<FeatureValue>

Facultatif


Texte

Titre du média

<FeatureNote>

Facultatif


Texte

Description

</ResourceFeature>





<ResourceVersion>





<ResourceForm>

Obligatoire

161

01; 02

01: Ressource liée
02: Lien de téléchargement

<ResourceVersionFeature>





<ResourceVersionFeatureType>


162

01; 02; 03; 04

01: Format de fichier
02: Hauteur de l'image en pixels
03: Largeur de l'image en pixels
04: Nom du fichier

<FeatureValue>

Facultatif
(seulement si 02, 03)


Nombre

Valeur

</ResourceVersionFeature>





<ResourceLink>

Obligatoire


URL

URL de la ressource
http://.../large.jpg
http://.../small.jpg

<ContentDate>

Facultatif




<ContentDateRole>

Obligatoire


17

Date de mise à jour de la couverture

<DateFormat>

Obligatoire


00;

00: AAAAMMJJ
La plupart des types de dates pris en charge par ONIX. Ici, un exemple simple.

<Date>

Obligatoire


Date

Ex.: 20120501

</ContentDate>

Obligatoire




</ResourceVersion>





</SupportingResource>





</CollateralDetail>





<PublishingDetail>





</Imprint>





</ImprintName>





</Imprint>





<Publisher>





<PublishingRole>

Obligatoire

45

01;

01: Éditeur

<PublisherIdentifier>





<PublisherIDType>

Obligatoire

44

06;

06: GLN

<IDTypeName>

Obligatoire


GLN

« GLN »

<IDValue>

Obligatoire


Nombre

Identifiant interne de l'éditeur

</PublisherIdentifier>

Obligatoire




<PublisherName>



Texte

Nom de l'éditeur

<Website>

Répétable




<WebSiteRole>

Obligatoire

73

01; 02; 14

01: Site Web de l'organisation
14: Site de la collection (voir <Collection>)

<WebSiteLink>

Obligatoire


URL

URL

</Website>





</Publisher>





<PublishingStatus>

Obligatoire

64

04; 08;

04: Actif
08: Inactif

<PublishingDate>





<PublishingDateRole>

Facultatif


01; 09; 19

01: Date de publication
09: Date d'annonce au publique
13: Date de fin de disponibilité
19: Date de publication du format papier

<DateFormat>



00; 14

00: AAAAMMJJ
14: AAAAMMJJThhmmss. Peut aussi avoir un suffixe Z pour les temps UTC ou avec + ou – selon le fuseau horaire (Ex.: 20120530T131243-0400)

<Date>





</PublishingDate>





<SalesRights>

Obligatoire




<SalesRightsType>

Obligatoire

46

01; 03;

01: En vente avec droits exclusifs sur les territoires suivants
03: N'est pas en vente sur les territoires suivants

<Territory>





<CountriesIncluded>

Obligatoire

91

Codes de pays ISO 3166-1 Alpha-2

Pays inclus. Ex.: CA FR

<RegionsIncluded> 



WORLD

WORLD: Tous les pays ouverts sur la plateforme seront autorisés.

</Territory>





</SalesRights>





<SalesRestriction>





<SalesRestrictionType>

Facultatif

71

00; 06; 07; 09;

00: Numéro de l'offre bibliothèque (voir SalesRestrictionNote)
06: Produit bibliothèque (voir PriceQualifier)
07: Produit offert aux bibliothèques scolaires
09: ou vide (par défaut): Produit grand public

 <SalesRestrictionNote>

Facultatif


offer_id={id}

offer_id={id}


{id}: ID de l'offre bibliothèque

</SalesRestriction>





</PublishingDetail>





<RelatedMaterial>





<RelatedProduct>

Répétable




<ProductRelationCode>

Obligatoire

51

00
01
02
03
05
06
07
08
09
10
11
12
13
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

00: Non spécifié
01: Inclus
02: Fait partie de
03: Remplace
05: Remplacé par
06: Format alternatif
07: Est un auxilaire à la publication
08: La publication est auxiliaire à
09: Est soldé comme
10: Est un invendu de
11: Est une version dans une autre langue
12: Est une alternative à la publication
13: Publication basée sur la version papier
16: Est une version imprimée à la demande qui remplace
17: Est remplacé par une version imprimée à la demande
18: Est une édition spéciale de
19: Possède une édition spéciale
20: Est une édition reliée de
21: Est l'original d'une édition reliée
22: Est du même auteur
23: Est un produit similaire
24: Est un fac-similé de
25: Est l'orignal du fac-similé
26: Est une licence de
27: Version électronique
28: Est une version améliorée de la publication
29: Est une version simplifiée de la publication
30: Est dans la même collection
31: Alternative dans un autre marché
32: Possède une version équivalente pour un marché différent
33: Possède une version alternative pour un marché différent
34: Cite
35: Est cité par

<ProductIdentifier>





<ProductIDType>

Obligatoire

5

01; 02; 03; 15

01: Clé interne
02: ISBN 10
03: EAN
15: ISBN 13

<IDValue>

Obligatoire


Nombre

Identifiant (ISBN)

</ProductIdentifier>





</RelatedProduct>





</RelatedMaterial>





<ProductSupply>





<Market>





<Territory>





<CountriesIncluded>



Codes de pays ISO 3166-1 Alpha-2

Pays autorisés pour la vente. Exemple: <CountriesIncluded>AD AR AT BE BG</CountriesIncluded>

</Territory>





<Market>





<SupplyDetail>





<Supplier>





<SupplierRole


93

01; 06

01: Éditeur vers libraire
06: Diffuseur vers libraire

<SupplierIdentifier>





<SupplierIDType>

Obligatoire

SupplierIDType

06;

06: GLN

<IDValue>

Obligatoire

IDValue

Nombre

Identifiant éditeur / distributeur

</SupplierIdentifier>





<SupplierName>



Texte

Nom de l'éditeur

<Website>





<WebSiteRole>

Obligatoire

73


01: Site Web de l'éditeur

<WebSiteLink>

Obligatoire



URL

</Website>





</Supplier>





<ProductAvailability>

Obligatoire

65

20; 40

20: Disponible
40: Non disponible

<SupplyDate>





<SupplyDateRole>


166

8

08: Date de disponibilité

<DateFormat>


55

0

00: AAAAMMJJ

<Date>



Date. ISO 8601

Date

</SupplyDate>





<Price>

Répétable




<PriceType>

Obligatoire

58

03; 04

03: Prix fixe, excluant les taxes
04: Prix fixe, incluant les taxes

<PriceQualifier>

Obligatoire

59

05; 10; 11; 14; 16

05: Prix de vente au détail (note : cette valeur est utilisée dans certains cas par Cantook Hub pour des produits destinés aux bibliothèques publiques, académiques et d'entreprise en tant que valeur rétrocompatible)
10: Prix pour bibliothèques publiques et scolaires. Avec SalesRestrictionType 06.
11: Prix pour l’usage scolaire en classe. Avec SalesRestrictionType 07.
14: Prix pour bibliothèque scolaire (enseignements primaire (collège) et secondaire (lycée)). Avec SalesRestrictionType 07.
16: Prix de vente aux bibliothèques publiques. Avec SalesRestrictionType 06.

<PriceStatus>

Obligatoire

61

02;

02: Ferme

<PriceAmount>

Obligatoire


Montant

Ex.: 20,85

<CurrencyCode>

Obligatoire

96

Code devise. ISO 4217

Ex.: EUR

<Territory>





<CountriesIncluded>

Obligatoire


Code pays 2 caractères ISO 3166-1 Alpha-2
ou
WORLD

Pays où ce prix est en vigueur. Peux contenir plusieurs pays, séparés par des espaces. Ex.: <CountriesIncluded>US CA</CountriesIncluded>
Pour un prix à appliquer à tous les pays, on peut utiliser le mot-clé WORLD.

</Territory>





<PriceDate>





<PriceDateRole>

Obligatoire


14

14: Date début

<DateFormat>

Obligatoire


0

00: AAAAMMJJ

<Date>

Obligatoire


Date. ISO 8601

Date en format ISO 8601. Although the DateFormat. Ex. 2010-05-27T11:44:24+01:00

</PriceDate>





</Price>





</SupplyDetail>





</ProductSupply>





</Product>





</ONIXMessage>