Résumer

Catalogue des nœuds Transformations

Sur cette page

Somme, comptage, max, etc. sur les éléments

Utilisation et spécificités

Utilisez Résumer pour calculer une valeur à partir des champs d’une liste. Pour conserver les valeurs dans un tableau sans les calculer, utilisez plutôt Agréger.

Avec l’entrée manuelle { "tasks": [{ "minutes": 12 }, { "minutes": 8 }, { "minutes": "" }] }, configurez source à input.tasks, field à minutes et operation à sum.

La sortie attendue est :

json

{
  "operation": "sum",
  "field": "minutes",
  "result": 20,
  "count": 3
}

result est le calcul ; count est le nombre d’éléments de la source. Une valeur absente, null ou vide est écartée du calcul. Avec operation: "count" sur ce même champ, result vaut donc 2 alors que count reste à 3.

Les opérations numériques convertissent les valeurs et ignorent celles qui ne donnent pas de nombre. Si aucune valeur numérique n’est trouvée, elles renvoient zéro. Si un champ incorrect ou manquant doit bloquer le traitement, validez-le avant ce nœud : un résultat numérique ne suffit pas à prouver la qualité des données.

Type technique : summarize. 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
`source`	`string`	`""`	-
`field`	`string`	`""`	-
`operation`	`enum`	`"count"`	`sum`, `count`, `min`, `max`, `avg`

Configuration initiale

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

json

{
  "source": "",
  "field": "",
  "operation": "count"
}

Vérification

Avec l’exemple, vérifiez une somme de 20, une moyenne de 10 et un comptage de 2 valeurs renseignées. Testez ensuite une liste vide. Dans les nœuds suivants, lisez nodes.summarize1.result, en adaptant le nom technique, plutôt que confondre ce résultat avec count.

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