Filtrer

Catalogue des nœuds Transformations

Sur cette page

Conserver uniquement les éléments correspondant à une condition

Utilisation et spécificités

Utilisez Filtrer pour retirer des éléments d’une liste avant de la parcourir ou de l’envoyer à une autre étape. À la différence d’un IF, ce nœud ne choisit pas une branche : il produit une liste dans items.

Par exemple, avec l’entrée manuelle { "contacts": [{ "name": "Ada", "active": true }, { "name": "Lin", "active": false }] }, renseignez :

Source : input.contacts.
Champ : active, lu à l’intérieur de chaque contact.
Opérateur : equals ; valeur : true.

La sortie attendue est :

json

{
  "items": [{ "name": "Ada", "active": true }],
  "count": 1,
  "removed": 1,
  "combinator": "and"
}

Avec AND, un élément doit satisfaire toutes les conditions ; avec OR, une seule suffit. Le champ est un chemin relatif à l’élément, comme profile.active, et non une expression input.contacts.... Pour exécuter une action par contact conservé, utilisez une boucle dont la source pointe sur nodes.filter1.items. Le parcours sur les listes montre la chaîne complète.

Type technique : filter. 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`	`""`	-
`combinator`	`enum`	`"and"`	`and`, `or`
`conditions`	`array`	`[{"field":"","operator":"equals","value":""}]`	-
`conditions[].field`	`string`	`""`	-
`conditions[].operator`	`enum`	`"equals"`	`equals`, `not_equals`, `contains`, `not_contains`, `gt`, `gte`, `lt`, `lte`, `empty`, `not_empty`
`conditions[].value`	`string`	`""`	-
`field`	`string`	-	-
`operator`	`enum`	-	`equals`, `not_equals`, `contains`, `not_contains`, `gt`, `gte`, `lt`, `lte`, `empty`, `not_empty`
`value`	`string`	-	-

Configuration initiale

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

json

{
  "source": "",
  "combinator": "and",
  "conditions": [
    {
      "field": "",
      "operator": "equals",
      "value": ""
    }
  ]
}

Vérification

Testez un contact actif, un inactif et une liste vide. Vérifiez count et removed, puis le contenu de items. Si tous les éléments disparaissent, vérifiez d’abord le champ relatif et la valeur comparée. Une liste vide est un résultat possible, pas un échec du nœud.

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