Parse JSON

Catalogue des nœuds Transformations
Sur cette page

Analyser une chaîne JSON en objet

Utilisation et spécificités

Utilisez ce nœud lorsque la donnée reçue est du texte contenant du JSON. Si une réponse HTTP fournit déjà un objet, vous pouvez en lire les propriétés directement sans ajouter cette étape.

Avec ce payload manuel :

json
{
  "raw": "{\"email\":\"[email protected]\",\"amount\":120}"
}

Renseignez Champ avec le chemin input.raw, sans accolades. La sortie est :

json
{
  "parsed": { "email": "[email protected]", "amount": 120 },
  "field": "input.raw"
}

Dans l’étape suivante, utilisez {{ nodes.parse1.parsed.email }} en adaptant parse1 au nom technique du nœud. Le champ attend un chemin de donnée, pas le texte JSON lui-même ni une expression JavaScript arbitraire. Une valeur déjà décodée est conservée sous parsed.

Type technique : parse_json. 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
field string "body" -

Aide de configuration

field
Champ
Expression JavaScript ou chemin : input.body.title, Object.keys(input.body.meta), nodes.http1.body.data.length.

Exemples

  • Champ : nodes.http1.body
  • Sortie : nodes.parse1.parsed

Configuration initiale

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

json
{
  "field": "body"
}

Vérification

Testez l’exemple valide, puis remplacez raw par un texte non JSON : le nœud doit échouer avec Field "input.raw" is not valid JSON. Retirez ensuite raw : attendez Field "input.raw" is empty. Les propriétés métier sont sous parsed, pas directement à la racine de la sortie.

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