Référence du format de fichier

Les fichiers d'import sont définis par des colonnes spécifiques, en fonction de leur type de fichier (sauf si un Mapping est appliqué).

Lors de l'import, les fichiers sont interprétés comme :

  • lignes - les objets à importer (documents, médias, etc.) et
  • colonnes - les caractéristiques des objets (code_document, nom_document, etc.).

👍

Vous pouvez télécharger un modèle de fichier d'import généré automatiquement à partir d'un profil d'import.

Délimiteurs et Séparateurs

  • Délimiteurs - Les attributs de texte doivent être placés entre guillemets. Si un attribut contient lui-même des guillemets, ils doivent être doublés afin qu'ils ne soient pas considérés comme le début ou la fin de l'attribut.

    Exemple : "Type de chaussures : ""Sneakers"""

  • Séparateurs - Un seul caractère qui indique une séparation entre les valeurs (vos colonnes). Si un une valeur colonne contient un délimiteur, il doit être placé entre guillemets. Les délimiteurs typiques sont :

    • lignes- Utilisées pour indiquer des lignes individuelles. Valeurs possibles : le caractère de saut de ligne (/n) effectué par la touche Entrée.
    • colonnes - Utilisées pour indiquer des colonnes individuelles. Valeurs possibles : virgule, point-virgule, tabulation. Note : si un attribut a plusieurs valeurs, vous devez utiliser le caractère barre verticale ( | ) entre les valeurs (au lieu d'une virgule).
    .

Fichiers d'import

Les sections suivantes décrivent les colonnes standard des fichiers d'import de Quable PIM.

Classifications

🚧

  • Les classifications doivent être importées par ordre hiérarchique, de haut en bas.
  • Une ligne doit toujours avoir un code_parent qui a déjà été créé dans le fichier ou qui existait déjà avant l'import.

Les modèles générés à partir d'un profil d'import avec le type de données = Classifications auront toujours les colonnes suivantes :

Nom de la colonne

Description

Obligatoire

classification_code

Le code unique de la classification.

Si un fichier d'import contient des doublons (2 lignes avec le même classification_code), une seule sera prise en compte.

Afin d'éviter des erreurs et des résultats inattendus, assurez-vous que votre fichier d'import ne contient pas de doublons.

Oui

classification_parent_code

Le code de la classification parente.

Pour créer une classification du niveau supérieur, le code parent doit être "root".

Oui

active

Le statut de la classification.

Valeurs possibles :

  • 0 - la classification est inactive et n'est pas disponible/visible dans les recherches, mais est présente dans le PIM.
  • 1 - la classification est active.
.

Non

Si la colonne est :

  • absente, il n'y aura aucun changement.
  • présente et que la cellule est vide, la valeur sera **ignorée** ou **remplacée** par *0* (selon les paramètres du [profil d'import](doc:profils-dimports).

<attributs>

Les attributs individuels et leurs valeurs.

Non

Si la colonne est absente, il n'y aura pas de changement.

Exemple

Voici un exemple d'import avec trois classifications :

  • folder_6 - Une classification active de premier niveau
  • folder_7 - Une classification de premier niveau, inactive
  • folder_8 - Une classification active de second niveau dans la classification folder_products.

Documents

🚧

Les en-têtes de colonne pour les attributs de texte doivent spécifier la locale entre parenthèses à côté du code. Si la locale n'est pas présente pour une colonne qui l'exige, le fichier d'import sera rejeté.

Exemples

  • Locale unique - "toto (fr_FR)"
  • Locaux multiples - "toto (fr_FR)" ; "toto (en_GB)"

Les modèles générés à partir d'un profil d'import avec le type de données = Documents auront toujours les colonnes suivantes :

Nom de la colonne

Description

Obligatoire

document_code

Le code unique du document.

Si un fichier d'import contient des doublons (2 lignes avec le même document_code), une seule sera prise en compte.

Afin d'éviter des erreurs et des résultats inattendus, assurez-vous que votre fichier d'import ne contient pas de doublons.

Oui

classification_code

Le code du niveau dans la classification cible où le document sera situé.

Non

Nouveaux documents
Si la colonne est :

  • absente - le document est créé orphelin.
  • présente et la cellule est vide - le document est créé orphelin.
Mise à jour des documents existants. Si la colonne est :
  • absent - il n'y aura pas de changement.
  • présent et la cellule est vide - la valeur sera **ignorée** ou **remplacée** par *0* (selon les paramètres du [profil d'import](doc:profils-dimports)).
  • présent avec une valeur différente - la valeur est mise à jour.

active

Le statut du document.

Valeurs possibles :

  • 0 - le document est archivé et non disponible/visible à partir des recherches et des classifications, mais présent dans le PIM.
  • 1 - le document est actif.

Non

Si la colonne est :

  • absente - il n'y aura aucun changement.
  • présente et la cellule est vide - la valeur sera **ignorée** ou **remplacée** par *0* (selon les paramètres du [profil d'import](doc:profils-dimports)).
  • présent avec une valeur différente - la valeur est mise à jour.

attribut_set_code

Le code du jeu d'attributs à appliquer au document.

Non

Si la colonne est :

  • absente - il n'y aura aucun changement.
  • présente et la cellule est vide - la valeur sera **ignorée** ou **remplacée** par *0* (selon les paramètres du [profil d'import](doc:profils-dimports)).
  • présent avec une valeur différente - la valeur est mise à jour.

<attributs>

Les attributs individuels et leurs valeurs.

Non

Si la colonne est absente, il n'y aura pas de changement.

Exemple

Voici un exemple d'import de deux documents avec une option de cellule vide = Remplacer.

  • ref_12345 - Un document actif, orphelin, sans jeu d'attributs.
  • ref_12346 - Un document actif avec le jeu d'attributs product_food dans la classification folder_products.

Variants

Les modèles générés à partir d'un profil d'import avec le type de données = Variant auront toujours les colonnes suivantes :

Nom de la colonne

Description

Obligatoire

sku_code

Le code unique du document.

Si un fichier d'import contient des doublons (2 lignes avec le même sku_code), une seule sera prise en compte.

Afin d'éviter des erreurs et des résultats inattendus, assurez-vous que votre fichier d'import ne contient pas de doublons.

Oui

document_code

Code du document auquel le variant est associée (un variant ne peut pas être rendu orphelin par un import).

Oui

active

Le statut du variant.

Valeurs possibles :

  • 0 - le variant est archivé et non disponible/visible depuis les recherches et les classifications, mais présent dans le PIM.
  • 1 - le variant est actif.

Non

Si la colonne est :

  • absente - il n'y aura aucun changement.
  • présente et la cellule est vide - la valeur sera **ignorée** ou **remplacée** par *0* (selon les paramètres du [profil d'import](doc:profils-dimports).
  • présent avec une valeur différente - la valeur est mise à jour.

<attributs>

Les attributs individuels et leurs valeurs.

Non

Si la colonne est absente, il n'y aura pas de changement.

Exemple

Voici un exemple d'import avec deux variants liés au document ref_12345.

  • sku_123 - Un variant actif.
  • sku_124 - Un variant inactif.

Médias

🚧

Quable PIM n'a pas de limite pour les formats de médias, mais nous vous recommandons de ne pas utiliser de grands formats. Si vous le faites, leur poids ne doit pas dépasser 200 Mo.

Les modèles générés à partir d'un profil d'import avec le type de données = Médias auront toujours les colonnes suivantes :

Nom de la colonne

Description

Obligatoire

media_classification_code

Le code de la classification du support dans lequel votre média sera situé.

Si aucune valeur n'est présente, le média sera classé dans la classification DAM, niveau 0. Note : les médias classés au niveau 0 ne sont pas visibles.

Non

Si la colonne est :

  • absente - le média est créé comme actif (nouveau média) et il n'y a pas de changement (variant existant).
  • présente et la cellule est vide - la valeur sera **ignorée** ou **remplacée** par DAM (selon les paramètres du [profil d'import](doc:profils-dimports).
  • présent avec une valeur différente - la valeur est mise à jour.

media_code

Le code du média.

Si un fichier d'import contient des doublons (2 lignes avec le même media_code), une seule sera prise en compte.

Afin d'éviter des erreurs et des résultats inattendus, assurez-vous que votre fichier d'import ne contient pas de doublons.

Oui

url

L'URL du média.

Une fois qu'un média a été téléchargé, il n'est plus obligatoire de spécifier l'URL dans le fichier d'import.

  • Oui (nouveaux médias)
  • Non (médias existants)

external

Indique si Quable PIM est ou non l'hôte du média.

Valeurs possibles :

  • 0 (non)
  • 1 (oui)

Non

<attributs>

Les attributs individuels et leurs valeurs.

Non

Si la colonne est absente, il n'y aura pas de changement.

Exemple

Voici un exemple d'import avec trois médias.

  • media_12345 - Un média à télécharger vers le PIM dans la classification folder_assets.
  • media_12346 - Un média dans la classification folder_assets (pas de téléchargement).
  • media_12347 - Un média existant avec l'option cellule vide = Ignorer. L'URL et la classification ne seront pas modifiées.

Liaisons

🚧

Nous recommandons de créer des profils d'imports individuels pour chaque type de liaison et d'utiliser un fichier d'import pour chaque type.

Les modèles générés à partir d'un profil d'import avec le type de données = Liaisons auront toujours les colonnes suivantes :

Nom de la colonne

Description

Obligatoire

source_code

Le code de l'objet parent.

Oui

target_code

Le code de l'objet enfant.

Oui

<attributs>

Les attributs individuels et leurs valeurs.

Non

Si la colonne est absente, il n'y aura pas de changement.

Exemple

Voici un exemple d'import avec deux liaisons utilisant un profil d'import de liaison media-document.

  • media_12345 - Un média à lier au document ref_12345.
  • media_12346 - Un média à lier au document ref_12346.

Liste des valeurs

🚧

Pour importer des valeurs pour les attributs Liste de sélection à choix unique ou Liste de sélection à choix multiple, vous devez faire référence au code de l'attribut, au code de la valeur et aux traductions des valeurs à importer.

Les modèles générés à partir d'un profil d'import avec le type de données = Liste de valeurs n'auront toujours que les colonnes suivantes :

Nom de la colonne

Description

Obligatoire

attribute_code

Le code de l'attribut (type liste uniquement) auquel sera associé le value_code.

Oui

value_code

Le code unique de la valeur.

Oui

value_label (xx_XX)

Le label d'interface du value_code importé. Cette valeur peut être importée dans toutes vos langues de données.

Non (mais fortement recommandé)

Exemple

Voici un exemple d'import d'une liste avec deux valeurs prédéfinies (et traductions), et une valeur supplémentaire pour une liste existante.

  • season_summer - Une entrée dans la liste season avec des traductions en français et en anglais pour été.
  • season_winter - Une entrée dans la liste season avec des traductions en français et en anglais pour hiver.
  • size_m - Une entrée supplémentaire dans la liste existante size.

Colonnes d'attributs

Vous pouvez importer des valeurs pour les attributs de vos classifications, documents, variants, médias et liaisons,

Les modèles générés à partir d'un profil d'import comprennent également une colonne par attribut, désignée par leur code. Ces colonnes ne sont pas obligatoires pour l'import d'objets.

Chaque type d'attribut doit respecter les règles suivantes :

Type d'attributDescriptionExemple
Texte
  • Texte simple
  • Texte multiligne
  • Texte HTML
Les attributs de texte peuvent être importés avec des traductions par colonnes individuelles par langue de données et en spécifiant le code ISO pour la langue.

Note
Les types d'attributs suivants ne doivent pas inclure un code ISO car ils ne sont pas traduisibles:

  • Texte simple non traduisible
  • Raw
Nombres
  • Integer
  • Decimal
Les attributs des nombres doivent utiliser le format utilisé pour les nombres dans le fichier d'import.

Formats possibles :
  • 00.00 (par défaut)
  • 00,00
DateLes attributs de date doivent être dans le format utilisé pour les dates dans le fichier d'import.

Formats possibles :
  • aaaa/mm/jj
  • jj/mm/aaaa (par défaut)
HeureLes attributs de l'heure doivent être dans le format utilisé pour l'heure dans le fichier d'import.

Formats possibles :
  • hh:mm:ss
Oui / NonLes attributs qui nécessitent une seule valeur parmi deux options doivent être au format booléen.

Formats possibles :
  • vrai / faux
  • oui / non
Liste de valeurs
  • Liste de valeurs prédéfinie unique
  • Liste de valeurs prédéfinie multiple
Les attributs des listes de valeurs doivent avoir le format suivant :

  • En-tête de colonne - le code de l'attribut
  • colonne - les codes des valeurs prédéfinies à appliquer

Vous pouvez avoir plusieurs codes de valeur, séparés par un caractère pipe ( | ).

Did this page help you?