Modifier les champs

Catalogue des nœuds Transformations
Sur cette page

Modifier, ajouter ou supprimer des champs

Utilisation et spécificités

Utilisez ce nœud pour préparer les champs attendus par une action : renommer une donnée, ajouter un texte ou limiter les données transmises. Chaque ligne assigne un nom à une valeur ; pour retirer les champs non voulus de la sortie, activez Champs mappés uniquement (mappedOnly).

Avec l’entrée manuelle { "name": "Ada", "amount": 120 }, activez cette option et ajoutez :

  • Nom customer.name, valeur {{ input.name }}.
  • Nom amount, valeur {{ input.amount }}.
  • Nom message, valeur Bonjour {{ input.name }}.

La sortie attendue est :

json
{
  "customer": { "name": "Ada" },
  "amount": 120,
  "message": "Bonjour Ada"
}

Une expression seule conserve son type dans la sortie ; le mélange texte et expression produit du texte. Un nom avec un point construit un objet imbriqué.

Lorsque mappedOnly est désactivé, la sortie conserve les champs amont et ajoute les champs préparés ainsi que items, assigned et vars. Lorsqu’il est activé, ces métadonnées ne sont pas ajoutées : lisez directement nodes.set1.amount, et non nodes.set1.vars.amount.

Les noms simples créent aussi des variables globales textuelles, accessibles avec {{ vars.amount }} ou {{ amount }}. Pour conserver un nombre, objet ou tableau, utilisez la sortie du nœud. Les noms imbriqués tels que customer.name ne créent pas de variable globale.

Type technique : set. Runtime : nodulz.

Identifiants et prérequis

Aucun identifiant externe dédié n’est défini par ce nœud. Les sources distantes ou la cible d’exécution peuvent néanmoins nécessiter leurs propres accès.

Consultez le guide des identifiants si une source distante ou une cible d’exécution nécessite un accès.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre Type Par défaut Valeurs / limites
fields array [] -
fields[].name string - -; min 1
fields[].value string - -
mappedOnly boolean false -

Aide de configuration

mappedOnly
Champs mappés uniquement
Activé : la sortie ne contient que les champs définis ci-dessous. Désactivé : les données amont sont conservées et fusionnées avec les champs mappés.
fields
Variables
Chaque ligne assigne un nom de variable à une valeur résolue.

Exemples

  • Nom : userId
  • Valeur : {{ nodes.http1.body.id }}
  • Lecture ultérieure : {{ userId }} ou nodes.set1.vars.userId

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json
{
  "fields": []
}

Vérification

Vérifiez que amount est un nombre dans l’inspecteur et que customer est un objet. Basculez mappedOnly pour observer les champs conservés et les métadonnées ajoutées. Dans le nœud suivant, sélectionnez le champ dans le mapping plutôt que supposer qu’il se trouve sous vars. Le tutoriel complet utilise cette sortie dans un IF.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.