Éclater

Transformer une liste en éléments séparés

Utilisation et spécificités

Utilisez Éclater lorsqu’un élément contient lui-même une liste à transformer en lignes. Ce nœud construit une liste dans items ; il ne lance pas automatiquement une action pour chaque ligne. Ajoutez une boucle pour cela.

Avec l’entrée manuelle suivante :

{
  "records": [
    { "id": "record-1", "tags": ["urgent", "review"] }
  ]
}

Renseignez source avec input.records, field avec tags, puis activez includeNoOtherFields. La sortie contient :

{
  "items": [{ "tags": "urgent" }, { "tags": "review" }],
  "count": 2
}

Avec includeNoOtherFields désactivé, les autres champs du parent sont conservés. Une valeur simple est placée dans value ; un objet enfant est fusionné au niveau du parent et peut remplacer ses champs de même nom. Vérifiez cette forme avant de mapper les étapes suivantes.

source désigne les éléments parents ; field désigne la liste dans chacun d’eux. Si ce champ n’est pas une liste, l’élément ne produit aucune ligne. Une source erronée peut donc donner une sortie vide sans erreur.

Type technique : split_out. 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": "",
  "includeNoOtherFields": false
}

Vérification

Vérifiez les deux lignes de l’exemple, puis testez tags: [] et un élément sans tags : ils ne doivent produire aucune ligne. Basculez includeNoOtherFields et inspectez où se trouvent la valeur enfant et l’identifiant parent. N’utilisez pas le même chemin de mapping sans vérifier cette option.

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