Aller au contenu principal

Comment lire, interpréter et convertir un export XML ou JSON ?

Stephan
Mise à jour

Les formats XML et JSON sont couramment utilisés pour structurer et transmettre des données produits entre différents systèmes : site e-commerce, PIM, ERP, marketplace ou outil de gestion de flux.

Dans le cadre de Shoppingfeed, les imports de catalogues reposent principalement sur des flux XML. Il peut toutefois être utile de savoir lire un fichier JSON lorsqu’il est fourni par un outil tiers, une API ou un prestataire technique.

Cet article présente les bases pour comprendre ces formats, identifier les données importantes et les convertir dans un format plus lisible, comme un tableau Excel.

1. Comprendre le format XML

Un fichier XML est structuré avec des balises ouvrantes et fermantes.

Exemple :

<product>
  <id>12345</id>
  <title>T-shirt noir</title>
  <price>19.99</price>
  <stock>25</stock>
</product>

Dans cet exemple :

  • <id> correspond à l’identifiant produit ;
  • <title> correspond au nom du produit ;
  • <price> correspond au prix ;
  • <stock> correspond au stock disponible.

Un catalogue XML contient généralement plusieurs produits, regroupés dans une structure de ce type :

<products>
  <product>
    <id>12345</id>
    <title>T-shirt noir</title>
  </product>
  <product>
    <id>67890</id>
    <title>Pantalon bleu</title>
  </product>
</products>

Le point important est d’identifier la balise qui correspond à un produit. Elle peut s’appeler par exemple product, item, entry ou offer.

2. Comprendre le format JSON

Un fichier JSON utilise une structure avec des accolades {}, des crochets [] et des paires clé / valeur.

Exemple :

{
  "id": "12345",
  "title": "T-shirt noir",
  "price": 19.99,
  "stock": 25
}

Un fichier JSON peut aussi contenir une liste de produits :

[
  {
    "id": "12345",
    "title": "T-shirt noir",
    "price": 19.99,
    "stock": 25
  },
  {
    "id": "67890",
    "title": "Pantalon bleu",
    "price": 39.99,
    "stock": 12
  }
]

Dans ce format :

  • les noms de champs sont appelés des clés ;
  • les informations associées sont appelées des valeurs ;
  • les listes sont représentées par des crochets [].

Le JSON est fréquent dans les échanges API ou certains exports techniques, mais il n’est pas le format principal utilisé pour les imports catalogue dans Shoppingfeed.

3. Quels outils utiliser pour lire un fichier XML ou JSON ?

Pour consulter un fichier XML ou JSON, il est recommandé d’utiliser un éditeur de texte adapté plutôt qu’un simple bloc-notes.

Outils possibles :

  • Visual Studio Code ;
  • Notepad++ ;
  • Sublime Text ;
  • XML Notepad, pour les fichiers XML ;
  • un navigateur web, pour une consultation rapide d’un fichier XML accessible par URL.

Ces outils permettent de visualiser la structure du fichier, de rechercher un champ précis et de repérer plus facilement les données produit.

4. Formater ou vérifier un fichier

Un fichier XML ou JSON peut être difficile à lire s’il est affiché sur une seule ligne ou sans indentation.

Des outils de formatage permettent de :

  • réorganiser le contenu avec des retours à la ligne ;
  • vérifier si la structure est valide ;
  • repérer une balise, une accolade ou une virgule manquante ;
  • rendre le fichier plus lisible avant analyse.

Exemples d’outils utiles :

  • XML Formatter ;
  • XML Validator ;
  • JSON Formatter ;
  • JSON Validator ;
  • Visual Studio Code avec les extensions adaptées.

Il est déconseillé d’utiliser un outil en ligne avec des données sensibles ou confidentielles, notamment des données clients, des prix spécifiques ou des informations contractuelles.

5. Quelles données vérifier dans un export ?

Lors de l’analyse d’un export XML ou JSON, les champs suivants doivent être contrôlés en priorité.

Identifiant produit

L’identifiant produit permet de reconnaître chaque produit de manière unique.

Il peut être présent sous différents noms :

  • id
  • sku
  • reference
  • product_id
  • item_id

Un identifiant manquant, vide ou dupliqué peut provoquer des problèmes d’import ou de mise à jour.

Titre et description

Les champs de contenu permettent de vérifier la qualité des informations produit :

  • title
  • name
  • description
  • short_description

Il faut notamment contrôler la présence des textes, l’encodage des caractères spéciaux et la cohérence du contenu.

Prix

Les prix peuvent être transmis dans différents champs :

  • price
  • sale_price
  • regular_price
  • discount_price

Points à vérifier :

  • le prix est-il présent ?
  • le séparateur décimal est-il correct ?
  • la devise est-elle indiquée si nécessaire ?
  • le prix remisé est-il cohérent avec le prix de référence ?

Stock et disponibilité

Le stock peut être transmis sous forme numérique :

"stock": 25

ou sous forme de statut :

"availability": "in stock"

Dans un XML, cela peut apparaître ainsi :

<stock>25</stock>
<availability>in stock</availability>

Il faut vérifier si la donnée permet bien de distinguer les produits disponibles, indisponibles ou en précommande.

Images

Les images sont généralement transmises sous forme d’URL.

Exemple XML :

<image>https://www.exemple.com/image-produit.jpg</image>

Exemple JSON :

"image": "https://www.exemple.com/image-produit.jpg"

Points à contrôler :

  • les URL sont-elles complètes ?
  • les liens sont-ils accessibles ?
  • les images correspondent-elles au bon produit ?
  • les images principales et secondaires sont-elles correctement distinguées ?

Variantes produit

Pour les produits déclinés, il est important de vérifier les champs liés aux tailles, couleurs ou autres variations :

  • size
  • color
  • parent_id
  • item_group_id
  • variation_id
  • sku

Ces données permettent de comprendre comment les déclinaisons sont regroupées dans le fichier source.

6. Convertir un fichier XML ou JSON dans Excel

Excel permet d’importer certains fichiers XML ou JSON grâce à Power Query.

Importer un fichier XML dans Excel

  1. Ouvrir un nouveau classeur Excel.
  2. Aller dans Données.
  3. Cliquer sur Obtenir des données.
  4. Sélectionner À partir d’un fichier.
  5. Choisir À partir de XML.
  6. Sélectionner le fichier XML.
  7. Dans Power Query, choisir le niveau correspondant aux produits.
  8. Développer les colonnes si nécessaire.
  9. Cliquer sur Fermer et charger.

Le contenu du fichier est alors converti en tableau exploitable dans Excel.

Le niveau à sélectionner correspond souvent à une balise comme product, item, entry ou offer.

Importer un fichier JSON dans Excel

  1. Ouvrir un nouveau classeur Excel.
  2. Aller dans Données.
  3. Cliquer sur Obtenir des données.
  4. Sélectionner À partir d’un fichier.
  5. Choisir À partir de JSON.
  6. Sélectionner le fichier JSON.
  7. Dans Power Query, développer les objets ou listes imbriqués.
  8. Cliquer sur Fermer et charger.

Cette méthode est utile pour analyser un fichier JSON fourni par un outil tiers ou une API.

7. Problèmes fréquents lors de la conversion

Le fichier contient plusieurs niveaux imbriqués

Certains fichiers contiennent des données dans des sous-niveaux.

Exemple XML :

<product>
  <price>
    <amount>19.99</amount>
    <currency>EUR</currency>
  </price>
</product>

Dans ce cas, il faut développer les colonnes dans Power Query pour accéder aux valeurs finales, comme amount ou currency.

Le fichier est trop volumineux

Un fichier contenant un grand nombre de produits peut être difficile à ouvrir dans Excel.

Dans ce cas, il est préférable d’utiliser :

  • un éditeur capable de gérer les gros fichiers ;
  • un outil de conversion spécialisé ;
  • un traitement technique avec script ;
  • une extraction partielle du fichier.

La structure du fichier est invalide

Un fichier peut ne pas être exploitable si :

  • une balise XML n’est pas fermée ;
  • une accolade JSON est manquante ;
  • une virgule est mal placée ;
  • l’encodage du fichier est incorrect ;
  • certains caractères spéciaux sont mal interprétés.

Un validateur XML ou JSON permet de confirmer si la structure du fichier est correcte.

8. Points d’attention pour un flux XML dans Shoppingfeed

Lorsqu’un flux XML est utilisé comme source d’import dans Shoppingfeed, il est important de vérifier :

  • que l’URL du flux est accessible ;
  • que le fichier est bien mis à jour régulièrement ;
  • que chaque produit dispose d’un identifiant unique ;
  • que les champs essentiels sont présents : titre, prix, stock, images ;
  • que les variations produit sont correctement structurées ;
  • que les données nécessaires aux canaux peuvent être exploitées ou retravaillées via les règles.

Si certaines informations sont absentes ou mal structurées dans le flux source, elles devront être corrigées à la source ou retravaillées dans Shoppingfeed lorsque cela est possible.

9. Bonnes pratiques d’analyse

Avant de modifier ou convertir un fichier, il est recommandé de :

  • conserver une copie du fichier original ;
  • vérifier l’encodage du fichier, idéalement en UTF-8 ;
  • identifier le niveau correspondant à un produit ;
  • contrôler les champs essentiels ;
  • comparer plusieurs produits pour repérer les différences de structure ;
  • vérifier les caractères spéciaux, notamment les accents, apostrophes et symboles HTML ;
  • éviter les outils en ligne pour les données sensibles.

Conclusion

Les formats XML et JSON permettent de structurer des données produits pour les rendre exploitables par différents systèmes. Le XML est aujourd’hui le format principalement utilisé pour les imports catalogue dans Shoppingfeed, tandis que le JSON est plus fréquent dans les échanges API ou certains exports techniques.

Pour analyser un fichier, il est recommandé d’utiliser un éditeur adapté, puis de convertir les données dans Excel si un affichage sous forme de tableau est nécessaire.

Une bonne lecture du fichier source permet d’identifier plus rapidement les problèmes liés à la structure, aux champs manquants ou aux données mal formatées.

Associé à