Conditions d’export : comment ne pas envoyer les données inutiles

Les conditions d’export décident si la partie sélectionnée des données entre dans l’export final.

Par exemple, vous pouvez ignorer une description vide, supprimer une balise XML vide ou ne pas exporter une ligne de tableau sans SKU.

Où ouvrir les conditions d’export

Que choisir : « Pour le nœud » ou « Pour l’élément entier »

Dans JSON et XML, le bloc des conditions d’export contient un choix de portée. Il définit quelle partie des données est supprimée de l’export si la condition échoue.

• Sur une valeur JSON, Pour le nœud omet cette clé et conserve l’objet. Pour l’élément entier supprime l’objet conteneur du tableau JSON.
• Sur une valeur feuille XML, Pour le nœud omet le texte mais laisse une balise vide. Pour l’élément entier supprime uniquement cette feuille ; l’enregistrement parent reste présent.
• Pour exclure un enregistrement JSON/XML complet, configurez la condition sur son nœud d’enregistrement répété, choisissez un champ enfant comme source vérifiée, puis sélectionnez Avant transformations et Pour l’élément entier.
• Les tableaux n’affichent pas de sélecteur de portée : l’échec d’une condition d’export exclut toute la ligne.

Ce que contient une condition

Exemples de résultat

JSON : supprimer une clé description vide

La condition est définie dans les paramètres de la valeur description : Valeur actuelle, Avant transformations, Non vide, Pour le nœud. La valeur est vide : la clé description est omise et l’objet produit reste présent.

{
  "sku": "SKU-1001",
  "name": "Veste",
  "description": ""
}

{
  "sku": "SKU-1001",
  "name": "Veste"
}

XML : conserver l’enregistrement et laisser une balise description vide

La condition est définie sur la valeur feuille de description : Valeur actuelle, Avant transformations, Non vide, Pour le nœud. La valeur est omise, mais le sérialiseur XML conserve une balise <description> vide et garde l’offre parente.

<?xml version="1.0" encoding="UTF-8"?>
<offer>
  <sku>SKU-1001</sku>
  <name>Veste</name>
  <description></description>
</offer>

<?xml version="1.0" encoding="UTF-8"?>
<offer>
  <sku>SKU-1001</sku>
  <name>Veste</name>
  <description></description>
</offer>

Tableau : ignorer une ligne avec un champ obligatoire vide

Dans les paramètres de la colonne sku, sélectionnez Non vide. Si sku est vide, toute la ligne n’est pas exportée.

Différence avec une action dans les transformations

Les règles de transformation incluent un groupe Contrôle d’export. C’est une action dans la chaîne de transformation de la valeur sélectionnée, pas un filtre structurel de ligne, de noeud JSON ou d’élément XML.

• Ne pas exporter le champ est une action de transformation. Elle vide uniquement la valeur finale courante, arrête la chaîne de règles pour cette valeur et ne supprime ni la ligne ni l’élément JSON/XML parent.
• Ignorer ignore la règle de transformation actuelle et continue avec les règles suivantes.
• Pour filtrer un enregistrement entier de la même façon dans tous les formats, utilisez Conditions d’export. Les tableaux n’ont pas de sélecteur de portée : l’échec de la condition exclut la ligne. Dans JSON/XML, ouvrez le nœud d’enregistrement répété (par exemple item), choisissez un champ enfant comme source vérifiée, puis sélectionnez Avant transformations et Pour l’élément entier.

Quel mécanisme utiliser