Agréger

Combiner un champ de plusieurs éléments en une liste

Utilisation et spécificités

Utilisez Agréger pour extraire un champ de chaque élément et obtenir une seule liste de valeurs. Pour calculer un total ou une moyenne, utilisez plutôt Résumer.

Avec l’entrée manuelle { "contacts": [{ "email": "[email protected]" }, { "email": "[email protected]" }] }, configurez source à input.contacts, field à email, outputField à emails et operation à append.

La sortie attendue est :

{
  "emails": ["[email protected]", "[email protected]"],
  "count": 2
}

Le nom de la propriété de résultat dépend de outputField. Avec cette configuration, utilisez {{ nodes.aggregate1.emails }}, en adaptant le nom technique ; il n’y a pas de propriété items ajoutée automatiquement.

append conserve les valeurs dans une liste. concat les convertit en texte et les colle sans séparateur : ici, le résultat serait [email protected]@example.test. Ce mode ne fusionne pas des tableaux et n’ajoute ni virgule ni retour à la ligne. Vérifiez d’abord le format accepté par votre destinataire.

Type technique : aggregate. 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é.

Configuration initiale

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

{
  "source": "",
  "field": "",
  "outputField": "aggregated",
  "operation": "append"
}

Vérification

Vérifiez le nom du champ de sortie, le nombre de valeurs et leur type. Avec une source vide et append, attendez une liste vide et count: 0. Testez aussi un contact sans e-mail : ce nœud ne valide pas les champs obligatoires, qui doivent être contrôlés en amont.

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