Mapper avec une liste de référence sert quand un produit, une ligne ou un élément contient un ID, tandis que le nom lisible est stocké dans une liste de référence séparée du même fichier source.
Exemple courant : le produit contient category_id = 12, et la liste des catégories contient id = 12, parent_id = 3, name = Chaises. Eofferix peut produire Chaises ou le chemin complet Meubles > Chaises.
Où l’Activer
- Ouvrez les paramètres du champ, du noeud ou de la colonne de résultat où le nom ou le chemin doit être écrit.
- Dans Paramètres supplémentaires, activez Mapper avec une liste de référence.
- Dans les tableaux, la liste de référence peut se trouver sur une autre feuille. En JSON et XML, choisissez les chemins des champs de référence dans le document source.
Quoi Insérer
| Mode | Quand l’utiliser | Résultat |
|---|---|---|
| Valeur de référence | Remplacer un ID par un nom, un code ou un autre champ de référence. | 12 devient Chaises. |
| Chemin de sections | Obtenir un nom de section ou un chemin complet construit avec parent_id. | 12 devient Meubles > Chaises. |
Champs de Réglage
| Champ | Que choisir |
|---|---|
| Où se trouve l’ID de l’élément courant | Champ du produit ou de la ligne contenant l’ID. Si vide, Eofferix utilise la valeur du champ configuré. |
| Où prendre l’ID dans la référence | Champ de l’enregistrement de référence comparé à l’ID courant. |
| Où prendre la valeur / le nom | Champ de l’enregistrement de référence à écrire dans le résultat. |
| Construire le chemin complet | Utilisé en mode Chemin de sections si le chemin du parent vers la section actuelle est nécessaire. |
| Où prendre l’ID parent | Champ parent_id dans le même enregistrement de référence. Requis seulement pour le chemin complet. |
| Séparateur de chemin | Texte entre les niveaux, par exemple > ou /. |
| Valeur multiple | À activer si le champ courant contient plusieurs ID séparés par un caractère. |
Exemple
| Produit | Liste de référence | Réglage | Résultat |
|---|---|---|---|
category_id = 12 | id = 12, name = Chaises | Valeur de référence | Chaises |
category_id = 12 | id = 12, parent_id = 3, name = Chaises; id = 3, name = Meubles | Chemin de sections + chemin complet | Meubles > Chaises |
category_ids = 12;15 | Catégories avec ID 12 et 15 | Valeur multiple, séparateur ; | Chaises;Tables |
Si Aucune Correspondance n’est Trouvée
Si l’ID n’est pas trouvé ou si la liste n’est pas entièrement configurée, Eofferix conserve la valeur source. Cela évite de perdre des données quand le fournisseur envoie une référence incomplète.
Contrôles
- L’ID courant et l’ID de référence doivent avoir le même format : par exemple tous deux
12, pas12etcat-12. - Les champs ID, parent_id et nom doivent appartenir au même enregistrement de référence.
- Pour le chemin complet, indiquez le champ de l’ID parent.
- Pour plusieurs ID, activez Valeur multiple et vérifiez le séparateur.
- Ce réglage n’est pas un dictionnaire de valeurs du catalogue consolidé. Il lit une liste de référence depuis le fichier ou le tableau source.