# Agréger - Nœud de workflow | Docs - nodulz

Source: https://nodulz.com/fr/docs/nodes/aggregate

Language: fr

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](/docs/nodes/summarize).

Avec l’entrée manuelle `{ "contacts": [{ "email": "ada@example.test" }, { "email": "sam@example.test" }] }`, configurez `source` à `input.contacts`, `field` à `email`, `outputField` à `emails` et `operation` à `append`.

La sortie attendue est :

```json
{
  "emails": ["ada@example.test", "sam@example.test"],
  "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 `ada@example.testsam@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](/docs/credentials) 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 |
| --- | --- | --- | --- |
| `source` | `string` | `""` | - |
| `field` | `string` | `""` | - |
| `outputField` | `string` | `"aggregated"` | - |
| `operation` | `enum` | `"append"` | `append`, `concat` |

## Configuration initiale

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

```json
{
  "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](/docs/expressions), [Exécutions](/docs/executions), [Catalogue des nœuds](/docs/nodes).

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)