Création de données au format CSV

Vous pouvez créer des données à charger dans votre base de données avec l'utilitaire de chargement de données dans un fichier au format CSV. Le plus simple pour créer ces données est de télécharger un exemple de fichier CSV à utiliser comme base.

Pourquoi et quand exécuter cette tâche

L'image suivante affiche un exemple de fichier CSV que vous pouvez utiliser pour charger des données de catalogue. Cet exemple télécharge un catalogue de vente :
Image instantanée d'un exemple de fichier CSV de catalogue
Dans le fichier CSV :
  • La première ligne contient le mot clé qui correspond à l'objet métier que vous chargez. Ce mot clé distingue les minuscules des majuscules. Exemple : Catalog pour les catalogues ou CatalogEntry pour les entrées de catalogue.
  • La deuxième ligne contient les en-têtes de colonne pour l'objet que vous chargez. Par exemple, l'objet Identifier ou ShortDescription.
    Important : Ces en-têtes de colonne distinguent les minuscules des majuscules et doivent correspondre au nom auquel la colonne est mappée dans le médiateur d'objet métier. Si le fichier de configuration d'objet métier pour l'objet que vous chargez comprend un mappage pour la colonne, le nom doit correspondre au nom figurant dans le mappage du fichier de configuration. Le fichier de configuration doit alors mapper la colonne au médiateur de l'objet métier.
  • Les lignes restantes du fichier comprennent des valeurs de données qui correspondent aux têtes de colonne que vous incluez dans le fichier.
Important : Si vous chargez des données avec un médiateur reposant sur des composants spécifique, votre fichier CSV doit contenir un type d'objet métier seulement. En d'autres termes, ne combinez pas deux fichiers CSV différents dans un même fichier CSV de plus grande taille. Vos fichiers CSV peuvent contenir plusieurs objets pour un type d'objet métier particulier. Par exemple, vous pouvez charger plusieurs entrées de catalogue dans un seul fichier CSV qui utilise le médiateur d'entrée de catalogue. Si vous spécifiez que l'utilitaire de chargement de données doit utiliser le médiateur reposant sur des objets de table, vous pouvez combiner plusieurs types d'objet métier dans un seul fichier. Pour plus d'informations sur les médiateurs reposant sur les composants et les objets métier disponibles, voir :

Procédure

  1. Téléchargez un exemple de fichier CSV à utiliser comme base. Sauvegardez-le sous un nouveau nom dans un dossier sur votre ordinateur. Si vous chargez des données pour un type d'objet métier qui ne possède pas d'exemple, créez un fichier vide afin d'inclure vos données au format CSV.
    Vous pouvez télécharger un exemple de fichier CSV depuis un échantillon de chargement de données fourni. Pour plus d'informations, voir Exemples : pour l'utilitaire de chargement de données.
  2. Ouvrez le fichier CSV que vous avez téléchargé ou créé.
    Utilisez un éditeur de texte ou de feuille de calcul capable d'enregistrer au format UTF-8, tel qu'Open Office Calc.
    Remarque :
    • Avant d'éditer le fichier CSV, assurez-vous de lire la rubrique suivante : Meilleures pratiques générales de chargement de données pour les fichiers d'entrée CSV.
    • Les données CSV formatées sont très flexibles et sujettes aux erreurs. La modification manuelle de données délimitées par des virgules peut entraîner une segmentation involontaire ou des erreurs de mise en forme qui peuvent rendre vos données non chargeables ou incorrectes.
  3. Facultatif : Editez la première ligne de votre fichier afin de spécifier un mot clé identifiant le type d'objet métier que vous chargez. Le mot clé est facultatif pour l'utilitaire de chargement de données, mais il est recommandé de l'inclure s'il est applicable. En spécifiant un mot clé, vous pouvez charger le fichier CSV avec l'utilitaire de chargement de données ou fournir le fichier aux professionnels pour qu'ils l'éditent et l'utilisent avec la fonction de téléchargement de catalogue du centre de gestion.
    Lorsque vous spécifiez un mot clé, sélectionnez l'un des mots clés ci-après. La distinction des minuscules et des majuscules s'applique aux mots clés ; par conséquent, veillez à les saisir exactement tels qu'ils apparaissent dans cette liste :
    • Attachment
    • AttachmentAsset
    • AttachmentAssetLanguage
    • AttachmentDescription
    • AttributeDictionaryAttributeAllowedValues
    • AttributeDictionaryAttributeAndAllowedValues
    • AttributeDictionaryAttributeFolderRelationship
    • Catalog
    • CatalogDescription
    • CatalogGroup
    • CatalogGroupAsset
    • CatalogGroupAssociation
    • CatalogGroupAttachment
    • CatalogGroupCalculationCode
    • CatalogGroupDescription
    • CatalogGroupRelationship
    • CatalogGroupSEO
    • CatalogEntry
    • CatalogEntryAsset
    • CatalogEntryAssociation
    • CatalogEntryATPInventory
    • CatalogEntryAttachment
    • CatalogEntryAttributeDictionaryAttributeRelationship
    • CatalogEntryCalculationCode
    • CatalogEntryComponent
    • CatalogEntryDescription
    • CatalogEntryDescriptiveAttributeAndValue
    • CatalogEntryDescriptionOverride
    • CatalogEntryDescriptionUpdate
    • CatalogEntryInventory
    • CatalogEntryOfferPrice
    • CatalogEntryParentCatalogGroupRelationship
    • CatalogEntryParentProductRelationship
    • CatalogEntrySEO
    • CatalogEntryUpdate
    • CatalogFilter
    • CatalogFilterCategory
    • CatalogFilterCatentry
    • CatalogFilterCondition
    • CatalogFilterConditionGroup
    • ListPriceList
    • MarketingActivity
    • MarketingCampaign
    • MarketingContent
    • MarketingContentAttachment
    • MarketingContentAttachmentDescription
    • MarketingContentDescription
    • MarketingContentImageMap
    • MarketingElement
    • MarketingElementNVP
    • MarketingSpot
    • MarketingSpotDefaultContent
    • MarketingSpotDefaultTitle
    • MemberGroup
    • MemberGroupCondition
    • MemberGroupDescription
    • Offer
    • ProductDefiningAttributeAndAllowedValues
    • SKUDefiningAttributeValue
  4. Facultatif : Sur la deuxième ligne, éditez les en-têtes de colonne afin d'identifier les données pour un objet métier. Ajoutez ou supprimez des en-têtes de colonne facultatifs pour adapter les valeurs de données que vous chargez.
    Pour plus d'informations sur les colonnes que vous pouvez spécifier pour les types pris en charge d'objet métier, voir les rubriques sous la rubrique utilitaire de chargement de donnéesdéfinitions de colonne CSV et d'élément XML. Si vous créez un fichier CSV pour un type d'objet métier personnalisé ou si vous chargez plusieurs types d'objet métier, les en-têtes de colonne doivent correspondre aux mappages de colonne dans votre fichier de configuration d'objet métier.
  5. Supprimez les exemples de données sur la troisième ligne ainsi que toutes les lignes de données suivantes dans votre exemple fichier CSV copié.
  6. A partir de la troisième ligne, spécifiez les valeurs pour vos objets métier dans les colonnes obligatoires et facultatives. Séparez la valeur de chaque colonne avec les caractères de séparation appropriés.
    Notes :
    • Chaque valeur de la colonne doit être séparée avec le caractère délimiteur de jeton attendu. Par défaut, ce caractère est une virgule (,).
    • Si vous spécifiez une chaîne qui inclut des espaces ou des caractères spéciaux comme valeur de colonne, entourez-la du caractère délimiteur de valeur de jeton configuré. Ce délimiteur est utilisé pour indiquer le début et la fin d'une chaîne. Le caractère tokenValueDelimiter par défaut est le signe guillemets ("). Par exemple, la chaîne suivante inclut des virgules et des blancs et est entourée du caractère tokenValueDelimeter : 
      "Men's fashions for business, casual, and formal occasions"
    • Pour indiquer la fin de l'enregistrement d'un objet et commencer un enregistrement d'objet, incluez le caractère délimiteur de ligne ou d'enregistrement. Par défaut, ce caractère délimiteur est le caractère de nouvelle ligne. Avec cette configuration par défaut, le lecteur de données CSV lit chaque ligne dans le fichier comme un enregistrement d'objet distinct. Si vous incluez des données d'une colonne ou d'un enregistrement sur plusieurs lignes dans le fichier, vous pouvez rencontrer des erreurs ou des problèmes avec le processus de chargement ou avec vos données. Si vous souhaitez que les données d'une colonne s'étendent sur plusieurs lignes, placez les données dans les caractères tokenValueDelimiter configurés. Si vous souhaitez que les données d'un enregistrement entier couvrent plusieurs lignes, vous devez configurer un nouveau délimiteur d'enregistrement pour identifier la fin de chaque enregistrement.
    Pour plus d'informations sur les caractères délimiteurs que vous pouvez utiliser avec le lecteur de données CSV et pour configurer des enregistrements sur plusieurs lignes, voir Configuration du lecteur de données CSV.
  7. Sauvegardez votre fichier CSV.

Résultats

Le fichier CSV est créé dans un format adapté à l'utilitaire de chargement de données. Lorsque vous chargez le fichier, le mot clé et les en-têtes de colonne sont interprétés mais ne sont pas chargés dans la base de données.