Mapping ERP → FNE
Guide complet pour mapper vos données ERP vers le format FNE
Mapping ERP → FNE
Ce guide vous montre comment utiliser le mapping personnalisé pour transformer vos structures de données ERP vers le format FNE.
Vue d'ensemble
Le mapping personnalisé permet de transformer automatiquement vos structures de données ERP vers le format attendu par l'API FNE. Cela évite d'avoir à restructurer manuellement vos données à chaque appel.
Configuration du mapping
Laravel
Dans config/fne.php :
Symfony
Dans config/packages/fne.yaml :
PHP Natif
Dans fne.php :
Notation pointée
Le mapping supporte la notation pointée pour accéder aux propriétés imbriquées :
Exemple d'utilisation
Sans mapping
Sans mapping personnalisé, vous devez restructurer vos données manuellement :
Avec mapping
Avec le mapping personnalisé, vous pouvez utiliser directement vos données ERP :
Mapping avec modèles
Le mapping fonctionne également avec les modèles via les traits :
Ordre de priorité
Le mapping personnalisé est appliqué avant le mapping standard. L'ordre de traitement est :
- Mapping personnalisé : Transforme les clés ERP vers les clés FNE
- Fusion : Les données mappées sont fusionnées avec les données originales
- Mapping standard : Le mapping standard est appliqué sur les données fusionnées
Champs non mappés
Les champs qui ne sont pas dans le mapping sont préservés tels quels. Vous pouvez donc :
- Mapper certains champs et laisser les autres en format FNE
- Combiner les deux approches dans la même structure de données
Désactiver le mapping
Pour désactiver le mapping pour un appel spécifique, vous pouvez passer directement les données en format FNE :
Exemples avancés
Mapping conditionnel
Mapping avec valeurs par défaut
Prochaines étapes
- Intégration modèles - Utilisez les traits pour intégration directe
- Gestion des erreurs - Gérez les erreurs de mapping
- Exemples - Consultez plus d'exemples de mapping