Importing metadata in ONIX 2.1
You can easily import a batch of new publications, or modify the metadata of existing publications, using a file formatted according to the ONIX 2.1 standard.
For a general description of the import process, see this article. You can also import your data using ONIX version 3.0 or a dynamic Excel report.
Notez que l'importation par ONIX de métadonnées d'un livre audio comporte des particularités.
Formatting the ONIX 2.1 file
Structure of the ONIX 2.1 file
Below is a description of each of the available ONIX 2.1 tags.
Mandatory data
- Mandatory-always: Indicates that the item is mandatory at all times.
- Mandatory-Apple: Mandatory field for export to the Apple iBookstore.
- Optional-Apple: Optional field for export to the Apple iBookstore. (Adds value and improves the quality of the data exchanged).
Mandatory | Data type | ONIX 2.1 tag | Description / Recommended values |
---|---|---|---|
Mandatory-always | Enveloppe du message | <Header> | Permet de distinguer ONIX de l’importation XML Standard sur la plateforme |
Mandatory-always | Nom de l’expéditeur | <FromCompany> | Nom de votre entreprise |
Nom du destinataire | <ToCompany> | ENQC | |
Mandatory-always | Date d'envoi | <SentDate> | AAAAMMJJ ou AAAAMMJJHHMM |
Message particulier | <MessageNote> | Texte ou commentaire, max 500 cars | |
Langue par défaut des textes | <DefaultLanguageOfText> |
Liste: 74 | |
Type de prix par défaut | <DefaultPriceTypeCode> |
Liste: 58 | |
Devise par défaut | <DefaultCurrencyCode> |
Liste: 96 | |
</Header> | |||
Mandatory-always | Identification de l'article | <Product> | |
Mandatory-always | Identifiant unique | <RecordReference> | Code interne de l’émetteur ; correspond aussi au répertoire renfermant les fichiers importés |
Type d’article | <NotificationType> |
Liste: 1 | |
Mandatory-always | ISBN, EAN ou Custom | <ProductIdentifier> | |
<Publisher> | |||
<PublisherName> | Nom de l'éditeur. Requis seulement lors d'une importation par diffuseur. | ||
<PublisherRole> | 01. Requis seulement lors d'une importation par diffuseur. | ||
</Publisher> | |||
Mandatory-always | Identification | <ProductIDType> | Il faut un seul de ces identifiants obligatoirement, avec ou sans tirets. La plateforme fera les conversions nécessaires.
Liste: 5 |
Mandatory-always | Valeur | <IDValue> | Valeur ISBN, EAN ou Custom |
</ProductIdentifier> | |||
Type de support | <ProductForm> | Description physique du support et reliure.
Liste: 7 | |
Type de format numérique | <EpubType> | Obligatoire si <ProductForm> = DG.
Liste: 10 | |
Type de support - détail | <ProductFormDetail> | Description physique détaillée du support et reliure | |
Optional-Apple | Produit lié | <RelatedProduct> | Groupe répétable d'éléments qui ensemble décrivent un produit possédant un lien spécifié avec le produit décrit dans l'enregistrement ONIX. Permet de ne faire qu’un produit global renfermant tous les formats associés. Un produit papier décrit dans cette section sera automatiquement défini comme format alternatif de la publication en cours. |
Mandatory-always | Relation produit lié | <RelationCode> | Code identifiant la nature de la relation entre deux produits
Liste: 51 |
Mandatory-always | ISBN, EAN ou Custom | <ProductIdentifier> | |
Mandatory-always | Identification | <ProductIDType> | Il faut un seul de ces identifiants obligatoirement, avec ou sans tirets. La plateforme fera les conversions nécessaires.
Liste: 5 |
Mandatory-always | Valeur | <IDValue> | Valeur ISBN, EAN ou Custom |
</ProductIdentifier> | |||
Optional-Apple | Type de support | <ProductForm> | Description physique du support et reliure.
Liste: 7 |
Optional-Apple | Type de format numérique | <EpubType> | Obligatoire si <ProductForm> = DG.
Liste: 10 |
</RelatedProduct> | |||
<SalesRights> | |||
<SalesRightsType> | Défini le statut de vente
| ||
</SalesRights> | |||
Mandatory-Apple | Prix | <SupplyDetail> | Dans le cas d'exportation vers le Apple iBookstore, cette section servira à déterminer les territoires permis à la vente, avec leur prix et leur devise approprié. |
Mandatory-Apple | <Price> | Cette section est répétable pour chaque pays nécessitant un prix et sa devise. | |
Mandatory-Apple | Pays | <CountryCode> | Le code de pays ISO 3166-1 (2 caractères) pour lequel le prix est valide. |
Mandatory-Apple | Type de prix | <PriceTypeCode> | Facultatif si défini dans le message header
Liste: 58 |
Mandatory-Apple | Montant | <PriceAmount> | Ex.: 18,99 ou 18.99 |
Mandatory-Apple | Devise | <CurrencyCode> | Si différent de <DefaultCurrencyCode> (Voir message Header)
Liste: 96 Afin d'importer un prix Groupe Euro, ne pas inclure la balise CountryCode, et inclure le CurrencyCode à EUR pour ce prix. |
</Price> | |||
</SupplyDetail> | |||
Optional-Apple | Séries | <Series> | |
Optional-Apple | Collection | <TitleOfSeries> | Titre complet de la collection |
Optional-Apple | Séries - Titre d’ensemble | <NumberWithinSeries> | Titre complet de l’ensemble |
</Series> | |||
Set | <Set> | ||
Collection | <TitleOfSet> | Titre complet de la collection | |
Numéro dans la collection | <ltemNumberWithinSet> | Numéro du produit dans la collection | |
</Set> | |||
Mandatory-Apple | Titre | <Title> | |
Mandatory-always | Type de titre | <TitleType> |
Liste: 15 |
Mandatory-always | Texte du titre | <TitleText> | |
Préfixe du titre | <TitlePrefix> | ||
Sous-titre | <Subtitle> | ||
</Title> | |||
Mandatory-Apple | Auteur, illustrateur, photographe... | <Contributor> | Dans le cas d'exportation vers le Apple iBookstore, cette section doit comporter au moins un contributeur primaire pour que la publication soit acceptée. |
Mandatory-Apple | Séquence | <SequenceNumber> | Position/ordre à lequel doit figuré le contributeur lorsque plusieurs pour une même publication, "1" étant le contributeur primaire. |
Mandatory-always | Type de contribution | <ContributorRole> | Dans le cas d'exportation vers le Apple iBookstore, au moins 1 contributeur doit correspondre aux codes marqués d'un astérique ci-dessous (contributeur primaire).
Liste: 17 |
Mandatory-always | Nom complet | <PersonName> | Prénom (initiales) et nom de famille |
Nom inversé | <PersonNameInverted> | Nom de famille et prénom (initiales) | |
Pays | <CountryCode> | Pays du contributeur | |
Site Internet | <WebsiteLink> | Site Internet du contributeur | |
Facebook / Twitter | <Website> | ||
<WebsiteRole> | 42 | ||
<WebsiteLink> | http://www.facebook.com/username ou http://twitter.com/username | ||
</Website> | |||
</Contributor> | |||
Classification (Sujets, thèmes ou genres) | <MainSubject> | Classification primaire pour la publication (Unique, et ne peut pas être des mots-clés, voir classification additionnelles) | |
Mandatory-always | Identification | <MainSubjectSchemeIdentifier> |
Liste: 26 |
Mandatory-always | Code | <SubjectCode> | Valeur du code. |
</MainSubject> | |||
Classification (Sujets, thèmes ou genres) | <Subject> | Classification additionnelle (Répétable) | |
Mandatory-always | Identification | <SubjectSchemeIdentifier> |
Liste: 26 |
Mandatory-always | Code | <SubjectCode> | Valeur du code (Obligatoire seulement si MainSubjectSchemeIdentifier n'est pas '20') |
Description | <SubjectHeadingText> | Seulement si MainSubjectSchemeIdentifier est '20': Mots clés séparés par des point-virgules (;) | |
</Subject> | |||
Type de public | <Audience> | ||
Identification liste de public type | <AudienceCodeType> |
Liste: 29 | |
Nom de la liste | <AudienceCodeTypeName> | BTLF; Electre | |
Code local du type de public | <AudienceCodeValue> | Valeur du code. | |
</Audience> | |||
Mandatory-Apple | Résumé | <OtherText> | |
Mandatory-Apple | Identification | <TextTypeCode> |
Liste: 33 |
Mandatory-Apple | Contenu | <Text> | Texte |
</OtherText> | |||
Commentaires | <OtherText> | ||
Identification | <TextTypeCode> |
Liste: 33 | |
Contenu | <Text> | Texte | |
</OtherText> | |||
Présentation | <OtherText> | ||
Identification | <TextTypeCode> |
Liste: 33 | |
Contenu | <Text> | Texte | |
</OtherText> | |||
Photo de l'auteur | <MediaFile> | ||
Identification | <MediaFileTypeCode> |
Liste: 38 | |
<MediaFileFormatCode> |
| ||
Type de lien | <MediaFileLinkTypeCode> |
Liste: 40 | |
Fichier | <MediaFileLink> | Adresse du lien web ou nom complet du fichier envoyé | |
Titre | <DownloadCaption> | Titre du média | |
Description | <TextWithDownload> | Description du média (facultatif) | |
</MediaFile> | |||
Optional-Apple | Traduit de | <Language> | |
Optional-Apple | Rôle | <LanguageRole> |
Liste: 22 |
Optional-Apple | Code de langue | <LanguageCode> |
Liste: 74 |
</Language> | |||
Site web produit | <ProductWebSite> | ||
Lien Internet | <ProductWebsiteLink> | URL du site web produit | |
</ProductWebSite> | |||
Pages en chiffre romain | <PagesRoman> | Nombre de pages en début de publication en chiffre romain | |
Date de publication | <PublicationDate> | ||
<Date> | AAAAMMJJ ou AAAAMMJJHHMM | ||
</PublicationDate> | |||
Type de protection à utiliser | <EpubTechnicalProtection> |
Liste: 144 (ONIX 3) | |
Nombre de pages | <Extent> | Si cet élément n'est pas présent, le nombre de page sera automatiquement déterminé à partir du fichier envoyé | |
<ExtentType> | 00 (nombre de pages du contenu principal) Liste: 23 (ONIX 3) | ||
<ExtentUnit> | 03 (en pages) Liste: 24 (ONIX 3) | ||
<ExtentValue> | Nombre de pages | ||
</Extent> | |||
Texte original | <EditionTypeCode> | ||
<NoEdition> | Ajouter cette balise (vide) si ceci est la version originale du texte | ||
</EditionTypeCode> | |||
</Product> | |||
</ONIXMessage> |
Importer le fichier dans votre catalogue
Référez-vous aux articles sur la procédure d'importation pour structurer et importer vos données.