Importer des métadonnées en format ONIX 2.1
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 2.1.
Pour une description générale du processus d'importation, consultez cet article. Vous pouvez aussi importer vos données en utilisant ONIX version 3.0 ou avec 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 2.1
Structure du fichier ONIX 2.1
Vous trouverez ci-dessous une description de chacune des balises ONIX 2.1 disponibles.
Données obligatoires
- Obligatoire-toujours: Indique que l'élément est obligatoire en tout temps.
- Obligatoire-Apple: Champ obligatoire pour l'exportation vers le Apple iBookstore.
- Facultatif-Apple: Champ facultatif pour l'exportation vers le Apple iBookstore. (Ajoute de la valeur et améliore la qualité des données échangées.)
Obligatoire | Type de données | Balise ONIX 2.1 | Description / Valeurs suggérées |
---|---|---|---|
Obligatoire-toujours | Enveloppe du message | <Header> | Permet de distinguer ONIX de l’importation XML Standard sur la plateforme |
Obligatoire-toujours | Nom de l’expéditeur | <FromCompany> | Nom de votre entreprise |
Nom du destinataire | <ToCompany> | ENQC | |
Obligatoire-toujours | 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> | |||
Obligatoire-toujours | Identification de l'article | <Product> | |
Obligatoire-toujours | Identifiant unique | <RecordReference> | Code interne de l’émetteur ; correspond aussi au répertoire renfermant les fichiers importés |
Type d’article | <NotificationType> |
Liste: 1 | |
Obligatoire-toujours | 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> | |||
Obligatoire-toujours | Identification | <ProductIDType> | Il faut un seul de ces identifiants obligatoirement, avec ou sans tirets. La plateforme fera les conversions nécessaires.
Liste: 5 |
Obligatoire-toujours | 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 | |
Facultatif-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. |
Obligatoire-toujours | Relation produit lié | <RelationCode> | Code identifiant la nature de la relation entre deux produits
Liste: 51 |
Obligatoire-toujours | ISBN, EAN ou Custom | <ProductIdentifier> | |
Obligatoire-toujours | Identification | <ProductIDType> | Il faut un seul de ces identifiants obligatoirement, avec ou sans tirets. La plateforme fera les conversions nécessaires.
Liste: 5 |
Obligatoire-toujours | Valeur | <IDValue> | Valeur ISBN, EAN ou Custom |
</ProductIdentifier> | |||
Facultatif-Apple | Type de support | <ProductForm> | Description physique du support et reliure.
Liste: 7 |
Facultatif-Apple | Type de format numérique | <EpubType> | Obligatoire si <ProductForm> = DG.
Liste: 10 |
</RelatedProduct> | |||
<SalesRights> | |||
<SalesRightsType> | Défini le statut de vente
| ||
</SalesRights> | |||
Obligatoire-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é. |
Obligatoire-Apple | <Price> | Cette section est répétable pour chaque pays nécessitant un prix et sa devise. | |
Obligatoire-Apple | Pays | <CountryCode> | Le code de pays ISO 3166-1 (2 caractères) pour lequel le prix est valide. |
Obligatoire-Apple | Type de prix | <PriceTypeCode> | Facultatif si défini dans le message header
Liste: 58 |
Obligatoire-Apple | Montant | <PriceAmount> | Ex.: 18,99 ou 18.99 |
Obligatoire-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> | |||
Facultatif-Apple | Séries | <Series> | |
Facultatif-Apple | Collection | <TitleOfSeries> | Titre complet de la collection |
Facultatif-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> | |||
Obligatoire-Apple | Titre | <Title> | |
Obligatoire-toujours | Type de titre | <TitleType> |
Liste: 15 |
Obligatoire-toujours | Texte du titre | <TitleText> | |
Préfixe du titre | <TitlePrefix> | ||
Sous-titre | <Subtitle> | ||
</Title> | |||
Obligatoire-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. |
Obligatoire-Apple | Séquence | <SequenceNumber> | Position/ordre à lequel doit figuré le contributeur lorsque plusieurs pour une même publication, "1" étant le contributeur primaire. |
Obligatoire-toujours | 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 |
Obligatoire-toujours | 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) | |
Obligatoire-toujours | Identification | <MainSubjectSchemeIdentifier> |
Liste: 26 |
Obligatoire-toujours | Code | <SubjectCode> | Valeur du code. |
</MainSubject> | |||
Classification (Sujets, thèmes ou genres) | <Subject> | Classification additionnelle (Répétable) | |
Obligatoire-toujours | Identification | <SubjectSchemeIdentifier> |
Liste: 26 |
Obligatoire-toujours | 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> | |||
Obligatoire-Apple | Résumé | <OtherText> | |
Obligatoire-Apple | Identification | <TextTypeCode> |
Liste: 33 |
Obligatoire-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> | |||
Facultatif-Apple | Traduit de | <Language> | |
Facultatif-Apple | Rôle | <LanguageRole> |
Liste: 22 |
Facultatif-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.