🔵 fromJSON. - Depuis JSON

Le bloc fromJSON permet de récupérer un objet JSON et d'en extraire les données.

Le JSON (JavaScript Object Notation) est un format de donnée textuel utilisé pour la transmission de données. Un objet JSON est la chaîne de charactères (le texte) qui contient les données à transmettre. Ces objets sont contenus entre accolades, et associent une clef (aussi appelée attribut) à une valeur (texte, liste, nombre, une valeur booléenne, ou un autre objet JSON), séparé par deux points (par exemple : {"fruits": ["pomme", banane"], "nombre": 2, "aime": True} )



Le bloc contient deux parties : le schema et le jsonString :
Le jsonString correspond à l'objet JSON passé au bloc fromJSON. C'est à partir de lui que sera décodé les informations pour pouvoir les utiliser dans le reste du projet.
Le schema permet au bloc fromJSON de décoder l'objet JSON passé via le jsonString. Il correspond à un autre objet JSON qui contient les noms des attributs du*jsonString*.

Pour générer le schema à partir d'un objet JSON de base, il peut être utile d'utiliser ce site : https://transform.tools/json-to-json-schema

Exemple :
Voici un objet JSON type qui pourrait être passé (via le body du bloc Webhook, par exemple) au bloc fromJSON :
{
"fruitPrefere": "pomme",
"fruitsAimes": ["banane", "clementine", "raisin"],
"nombreFruits": 4,
"allergies": false
}

Et voici la conversion donnée par le site JSON to JSON Schema :
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Generated schema for Root",
"type": "object",
"properties": {
"fruitPrefere": {
"type": "string"
},
"fruitsAimes": {
"type": "array",
"items": {
"type": "string"
}
},
"nombreFruits": {
"type": "number"
},
"allergies": {
"type": "boolean"
}
},
"required": [
"fruitPrefere",
"fruitsAimes",
"nombreFruits",
"allergies"
]
}

Il faut donc copier l'objet JSON donné par le site dans la partie schema du bloc fromJSON. L'objet JSON de base sera transmis par un autre bloc (dans cet exemple).

Mis à jour le : 28/04/2025