Count List Items

Le node Count List Items compte le nombre d'éléments d'une liste et renvoie le total sous forme de valeur unique, utile pour valider des données, brancher un workflow ou sécuriser une boucle.

À quoi sert le node Count List Items ?

Le node Count List Items est un utilitaire simple mais puissant qui compte le nombre d’éléments contenus dans une liste et renvoie le total sous forme de valeur unique. Il accepte aussi bien les tableaux JSON que des chaînes de caractères ou du texte interprétable comme une liste, ce qui en fait un compagnon flexible pour tous les nodes produisant des collections d’éléments (lecteurs de base de données, API connectors, scrapers, sorties de LLM, etc.).

Cas d’usage typiques :

• Vérifier la taille d’une liste avant de l’itérer avec un node Loop, afin d’éviter des itérations inutiles ou vides.
• Valider qu’un node en amont (API connector, lecteur de base de données, scraper) a bien renvoyé suffisamment de résultats avant de poursuivre le workflow.
• Brancher conditionnellement le workflow en fonction du nombre d’éléments récupérés (zéro, un, ou plusieurs).

Configuration rapide

Suivez ces étapes pour ajouter et configurer le node Count List Items dans votre workflow :

Paramètres de configuration

Le node n’a aucun paramètre métier : son seul rôle est de compter les éléments de la liste qu’il reçoit. Vous ne configurez donc que les champs d’identification standard.

Champs requis

Champs optionnels

Ce node n’expose aucun paramètre optionnel.

Que renvoie le node ?

Le node renvoie une seule valeur count représentant le nombre d’éléments de la liste d’entrée. La valeur est renvoyée sous forme de chaîne de caractères (afin d’être réutilisable directement dans des templates de texte ou d’autres nodes qui consomment des strings).

Exemple de sortie brute :

{
  "count": "12"
}

Exemples d’utilisation

Cas 1 : Adapter un résumé LLM au nombre d’éléments récupérés

Vous récupérez une liste d’articles depuis une base de données et vous souhaitez que le LLM qui les résume sache combien de résultats il a à traiter.

Workflow :

1. Notion Database Reader récupère une liste d’articles.
2. Count List Items compte les articles.
3. LLM reçoit à la fois la liste et le count, et adapte son résumé (ex : “5 articles” vs “1 article”).

Output généré par Count List Items :

{
  "count": "5"
}

Cas 2 : Brancher le workflow lorsqu’aucun résultat n’est renvoyé

Vous appelez une API externe et vous voulez arrêter proprement le workflow si elle ne renvoie rien, plutôt que d’envoyer une liste vide aux nodes en aval.

Workflow :

1. API Connector renvoie une liste de résultats.
2. Count List Items compte les résultats.
3. Conditional oriente le workflow :
   • Si count > 0 → poursuivre le traitement de la liste.
   • Si count = 0 → stopper le workflow ou envoyer une alerte.

Problèmes courants

L'entrée n'est pas reconnue comme une liste

Cause : L’entrée list n’est pas un tableau JSON valide. Si une chaîne est passée, le runner tente de la parser via json.loads ; si le parsing échoue, le node lève l’erreur “Count List Items node: Input is not a valid JSON list”.

Solution : Assurez-vous que le node en amont produit bien un tableau JSON correct (ex : ["a", "b", "c"]). Si vous construisez la liste manuellement à partir de texte, vérifiez le formatage des crochets et des guillemets.

Le count est 0 alors que j'attends des éléments

Cause : Le node en amont a produit un tableau vide [], ou il a échoué silencieusement et n’a transmis aucune donnée.

Solution : Inspectez la sortie brute du node en amont en y branchant temporairement un node Merge ou LLM. Vérifiez les filtres, requêtes ou paramètres de pagination en amont pour confirmer que des données sont bien renvoyées avant d’être comptées.

Bonnes pratiques et pièges à éviter

Comment s’intègre-t-il dans un workflow ?

Count List Items agit typiquement comme une petite étape de “validation” ou de “routage” entre un node qui produit une liste et un node qui la consomme (Loop, Conditional, LLM, etc.). Voici un schéma typique d’intégration qui sécurise une boucle avec une vérification du count :

graph LR
    Source[API Connector / DB Reader] --> Count[Count List Items]
    Count --> Cond{Conditional}
    Cond -->|count > 0| Loop[Loop sur les éléments]
    Cond -->|count = 0| Stop[Stop / Alerte]

Nodes complémentaires