Aller au contenu principal

Mapping de données

Le mapping consiste à transformer les données reçues (déclencheur, réponse d'API) dans le format attendu par le système de destination (base de données, ERP, autre API). Bien réalisé, il reste lisible, maintenable et évite de recopier des blocs entiers de données. La syntaxe des variables (données d'entrée, contexte, dictionnaires) est détaillée dans Gestion des variables.

Approche chirurgicale​

Ne transformez que ce qui est nécessaire : ne stockez dans le contexte que les valeurs utiles aux nœuds suivants, plutôt que de recopier l'intégralité des données.

Nomenclature des variables​

Nommez les variables de contexte de manière explicite : context.customer_id plutôt que context.var1, context.mapped_users plutôt que context.data2. Les traces d'erreurs et le travail en équipe n'en sont que plus lisibles.

Extracteurs vs nœud Code​

  • Extracteurs (JSONPath) : pour les assignations simples depuis une réponse HTTP ($.data.id → context.orderId).
  • Nœud Code : pour les transformations complexes (concaténation, calculs, mapping vers un autre format).

Extraire une valeur : l'extracteur JSONPath​

Sur un nœud Requête HTTP(S), un extracteur copie une valeur de la réponse vers une variable du contexte. Si la valeur est absente (chemin JSONPath introuvable), le nœud échoue — c'est le comportement recommandé pour ne pas propager de données incomplètes vers les nœuds suivants.

Extracteur (JSONPath)Variable de contexteContenu
$.data.idorderId"12345"
$.data.itemsorderItems[...]
$.headers['ratelimit-remaining']rateLimitRemaining"49"

Transformer : le nœud Code​

Exemple de mapping d'une réponse API vers un format base de données, dans un nœud Code :

// Mapping d'une réponse API vers un format base de données
const apiItems = (context.lastResponse.data.items) || [];

context.mapped_users = apiItems.map(item => {
    return {
        external_id: item.id,
        full_name: `${item.firstName} ${item.lastName}`,
        synced_at: new Date().toISOString()
    };
});

Le résultat est ensuite exploitable par les nœuds suivants via {{mapped_users}} — voir Variables de contexte.

Ne jamais écrire de secret en dur​

Ne stockez jamais une clé API ou un mot de passe dans un nœud Code ou Requête HTTP(S) : utilisez les dictionnaires ({{dictionaries.nomDuDico.cleDuDico}}) ou les méthodes d'authentification.

Et ensuite​