Cantook Édition

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.

Tableau des balises ONIX 2.1

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>

    Langue Française

    Liste: 74


    Type de prix par défaut

    <DefaultPriceTypeCode>

      Prix sans taxe

      Liste: 58


      Devise par défaut

      <DefaultCurrencyCode>

      • can: Dollar Canadien

      • eur: Euro

      Liste: 96



      </Header>


      Obligatoire-toujours
      Obligatoire-Apple

      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>

      • 03: Nouveau produit

      • 04: Mise à jour

      Liste: 1

      Obligatoire-toujours
      Obligatoire-Apple

      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
      Obligatoire-Apple

      Identification

      <ProductIDType>

      Il faut un seul de ces identifiants obligatoirement, avec ou sans tirets. La plateforme fera les conversions nécessaires.

      • 01: Propriétaire (custom)

      • 02: ISBN-10

      • 03: EAN

      • 15: ISBN-13

      Liste: 5

      Obligatoire-toujours
      Obligatoire-Apple

      Valeur

      <IDValue>

      Valeur ISBN, EAN ou Custom



      </ProductIdentifier>



      Type de support

      <ProductForm>

      Description physique du support et reliure.

      • BA: Papier

      • DG: Numérique

      Liste: 7


      Type de format numérique

      <EpubType>

      Obligatoire si <ProductForm> = DG.

      • 002: PDF

      • 022: Mobi

      • 023 (029): EPUB

      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
      Facultatif-Apple

      Relation produit lié

      <RelationCode>

      Code identifiant la nature de la relation entre deux produits

      • 01: Inclus (utiliser ce code pour indiquer quels chapitres distincts sont inclus dans cette publication)

      • 02: Est une partie de (utiliser ce code pour indiquer qu'un chapitre distinct est une partie du livre complet)

      • 06: X est un format alternatif du produit Y

      • 13: X est une epublication basée sur le produit papier Y

      Liste: 51

      Obligatoire-toujours
      Facultatif-Apple

      ISBN, EAN ou Custom

      <ProductIdentifier>


      Obligatoire-toujours
      Facultatif-Apple

      Identification

      <ProductIDType>

      Il faut un seul de ces identifiants obligatoirement, avec ou sans tirets. La plateforme fera les conversions nécessaires.

      • 01: Propriétaire (custom)

      • 02: ISBN-10

      • 03: EAN

      • 15: ISBN-13

      Liste: 5

      Obligatoire-toujours
      Facultatif-Apple

      Valeur

      <IDValue>

      Valeur ISBN, EAN ou Custom



      </ProductIdentifier>


      Facultatif-Apple

      Type de support

      <ProductForm>

      Description physique du support et reliure.

      • BA: Papier

      • DG: Numérique

      Liste: 7

      Facultatif-Apple

      Type de format numérique

      <EpubType>

      Obligatoire si <ProductForm> = DG.

      • 002: PDF

      • 023: ePub

      Liste: 10



      </RelatedProduct>




      <SalesRights>




      <SalesRightsType>

      Défini le statut de vente

      • 01: Disponible à la vente

      • 02: Disponible à la vente

      • 03: Consultation seulement



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

        Prix sans taxe

        Liste: 58

        Obligatoire-Apple

        Montant

        <PriceAmount>

        Ex.: 18,99 ou 18.99

        Obligatoire-Apple

        Devise

        <CurrencyCode>

        Si différent de <DefaultCurrencyCode> (Voir message Header)

        • CAD: Dollar Canadien

        • EUR: Euro

        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
        Obligatoire-Apple

        Type de titre

        <TitleType>

        • 01: Titre distinctif

        • 10: Titre du distributeur

        Liste: 15

        Obligatoire-toujours
        Obligatoire-Apple

        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
        Obligatoire-Apple

        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).

        • *A01: Auteur

        • *A02: Avec

        • *A06: Fait par le compositeur

        • *A07: Fait par l'artiste

        • *A08: Fait par le photographe

        • *A99: Autre créateur primaire

        • A12: Illustratations par

        • A15: Préface par

        • A16: Prologue par

        • B06: Traduit par

        • E03: Narrateur

        Liste: 17

        Obligatoire-toujours
        Obligatoire-Apple

        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>

        • 01: Dewey

        • 10: BISAC Subject Heading

        • 24: Genres par défaut

        • 28: Thèmes Electre

        • 29: CLIL

        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>

        • 01: Dewey

        • 10: BISAC Subject Heading

        • 20: Mots clés

        • 24: Genres par défaut

        • 28: Thèmes Electre

        • 29: CLIL

        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>

        • 06: BTLF Audience Code

        • 07: Electre Audience code

        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>

          Description principale (résumé)

          Liste: 33

          Obligatoire-Apple

          Contenu

          <Text>

          Texte



          </OtherText>



          Commentaires

          <OtherText>



          Identification

          <TextTypeCode>

            Commentaires

            Liste: 33


            Contenu

            <Text>

            Texte



            </OtherText>



            Présentation

            <OtherText>



            Identification

            <TextTypeCode>

              Présentation couverture arrière

              Liste: 33


              Contenu

              <Text>

              Texte



              </OtherText>



              Photo de l'auteur

              <MediaFile>



              Identification

              <MediaFileTypeCode>

              • 04: Couverture principale

              • 08: Photo d'un contributeur

              • 0323: Image: Extrait

              • 24: Couverture arrière

              • 27: Couverture autre

              • 32: Entrevue vidéo avec l'auteur

              • 35: Vidéo: Extrait

              • 36: Vidéo promotionel

              • 37: Critique vidéo

              • 42: Entrevue audio avec l'auteur

              • 44: Audio: Extrait

              • 45: Audio promotionel

              • 46: Critique audio

              • 51: Application: Extrait

              Liste: 38



              <MediaFileFormatCode>


                Type de lien

                <MediaFileLinkTypeCode>

                • 01: Lien Web

                • 06: Fichier

                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>

                  Langage original – texte traduit

                  Liste: 22

                  Facultatif-Apple

                  Code de langue

                  <LanguageCode>

                  • eng: Anglais

                  • fre: Français

                  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>

                  • 00: None (open)

                  • 02: Filigrane

                  • 03: Adobe DRM (Adobe Content Server)

                  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.