# Studio de requetes et transformations JSONata

Previsualise des requetes et transformations de style JSONata, compare les resultats et exporte en JSON, CSV, YAML ou Markdown.

> Page canonique: https://elysiatools.com/fr/tools/jsonata-query-transform-studio

- **Catégorie:** Data Processing

- **Mots-clés:** jsonata, json, requete, transformation

## Présentation

Collez un objet ou un tableau JSON dans "Entree JSON", puis saisissez une expression dans "Expression JSONata".

Comment remplir les champs :
- Entree JSON : le payload JSON principal a interroger ou transformer
- Expression JSONata : une expression JSONata standard ou une forme helper comme groupBy(orders, "status")
- JSON de comparaison : second payload optionnel evalue avec la meme expression pour comparer les sorties cote a cote
- Format de sortie : rend le resultat en JSON, CSV, YAML ou Markdown
- Enregistrer lexpression : stocke lexpression courante dans lhistorique local
- Nom du modele : nom optionnel affiche dans lhistorique

Styles dexpression pris en charge :
- JSONata standard, par exemple $sum(orders.total) ou orders[status="paid"]
- Helpers du studio sans prefixe $ :
  - groupBy(collection, "field.path")
  - mapField(collection, "field.path")
  - flatten(collection)
  - distinct(collection)
  - count(collection)
  - sum(collection)
  - avg(collection)
  - keys(object)

Exemples :
- Entree JSON : {"orders":[{"id":1,"status":"paid","total":120},{"id":2,"status":"pending","total":40}]}
- Expression : groupBy(orders, "status")
- Expression : sum(orders.total)
- Expression : orders[status="paid"]

Notes :
- Loutil utilise le vrai runtime jsonata et pretraite les helpers ci-dessus pour en faire des fonctions appelables.
- Le JSON de comparaison est facultatif, mais tres utile pour valider la meme transformation sur deux reponses API ou jeux de test.

## Entrées

- **Entree JSON** (textarea): {"orders":\[{"id":1,"status":"paid","total":120}\]}
- **Expression JSONata** (textarea): groupBy(orders, "status")
- **JSON de comparaison** (textarea): {"orders":\[{"id":2,"status":"pending","total":55}\]}
- **Format de sortie** (select)
- **Enregistrer lexpression** (checkbox)
- **Nom du modele** (text): Paid order totals

## Quand l'utiliser

- Pour extraire et filtrer rapidement des données spécifiques depuis une réponse d'API complexe ou volumineuse.
- Pour comparer la structure ou les valeurs de deux payloads JSON en appliquant la même requête simultanément.
- Pour convertir des tableaux d'objets JSON en fichiers CSV ou Markdown prêts à être partagés ou analysés.

## Fonctionnement

- Collez votre objet ou tableau de données principal dans le champ « Entrée JSON ».
- Saisissez une expression JSONata standard (ex: orders\[status="paid"\]) ou utilisez un helper simplifié (ex: groupBy(orders, "status")).
- Ajoutez éventuellement un second payload dans « JSON de comparaison » pour évaluer la même expression sur un autre jeu de données.
- Sélectionnez votre format de sortie (JSON, CSV, YAML, Markdown) pour visualiser et exporter le résultat transformé.

## Cas d'usage

- Agréger des données de vente en regroupant les commandes par statut ou par date pour générer des rapports rapides.
- Aplatir des structures JSON imbriquées pour les préparer à une analyse dans un tableur via un export CSV.
- Valider la cohérence des données entre deux environnements (ex: staging vs production) en comparant leurs réponses API avec une requête unique.

## Questions fréquentes

### Qu'est-ce que JSONata ?

JSONata est un langage de requête et de transformation léger conçu spécifiquement pour extraire, filtrer et manipuler des données au format JSON.

### Quels sont les helpers simplifiés disponibles dans l'outil ?

L'outil propose des fonctions prêtes à l'emploi sans préfixe $ comme groupBy, mapField, flatten, distinct, count, sum, avg et keys pour accélérer vos requêtes courantes.

### Puis-je exporter les résultats dans d'autres formats que JSON ?

Oui, vous pouvez choisir d'afficher et d'exporter le résultat de votre transformation en JSON, CSV, YAML ou Markdown via le menu déroulant de format de sortie.

### À quoi sert le champ « JSON de comparaison » ?

Il permet de coller un second jeu de données (comme une ancienne réponse d'API ou un environnement de test) pour voir comment la même expression JSONata se comporte sur les deux payloads simultanément.

### Mes données JSON sont-elles stockées sur vos serveurs ?

Non, toutes les requêtes et transformations JSONata sont exécutées localement dans votre navigateur, garantissant la confidentialité de vos données.

## Outils associés

- [Generateur de Tableaux Markdown](https://elysiatools.com/fr/tools/markdown-table-generator): Genere des tableaux Markdown formates a partir de donnees CSV, JSON ou tableaux avec alignement, style dentete, largeur de colonne et indications de fusion
- [Suppresseur de Caractères BOM](https://elysiatools.com/fr/tools/data-bom-remover): Supprimer les caractères BOM (Byte Order Mark) du contenu textuel et des fichiers. Parfait pour nettoyer les fichiers texte avec des problèmes d'encodage.
- [Table Markdown vers CSV, JSON et schéma à types inférés](https://elysiatools.com/fr/tools/markdown-table-to-csv-json-schema): Convertit un tableau Markdown à barres en CSV, lignes JSON ou JSON Schema inféré avec diagnostics d’alignement et de nullité
- [Atelier texte désordonné vers données structurées](https://elysiatools.com/fr/tools/messy-text-to-structured-data-workbench): Déduit des tableaux depuis du texte, des délimiteurs mixtes, des lignes clé-valeur ou du HTML et exporte CSV, JSON et Markdown.
- [Convertisseur JSON vers CSV](https://elysiatools.com/fr/tools/json-to-csv): Convertit les données JSON au format CSV avec des options de formatage personnalisables
- [Analyseur de logs structures](https://elysiatools.com/fr/tools/structured-log-analyzer): Detecte les formats de logs courants, extrait les champs principaux et exporte en JSON, CSV ou SQL.
- [Text to Excel Converter](https://elysiatools.com/fr/tools/text-to-excel): Convert various text formats to Excel with customizable parsing and formatting options
- [Extracteur de tableaux PDF vers CSV/JSON](https://elysiatools.com/fr/tools/pdf-table-extractor-to-csv-json): Extrait des tableaux PDF avec OpenDataLoader et les exporte en JSON, CSV ou HTML

## Exemples

- [Exemples CSV](https://elysiatools.com/fr/samples/csv-samples): Fichiers CSV d'exemple avec divers types de données, tailles et niveaux de complexité
- [Exemples Python](https://elysiatools.com/fr/samples/python): Exemples de code Python et démonstrations Hello World
- [Exemples OpenAPI/Swagger](https://elysiatools.com/fr/samples/openapi-swagger): Exemples complets de documentation API utilisant OpenAPI 3.0 et les spécifications Swagger pour les services RESTful
- [Exemples de Traçage Distribué](https://elysiatools.com/fr/samples/distributed-tracing-samples): Exemples complets de traçage distribué utilisant Jaeger, OpenTelemetry et outils d'observabilité modernes

## Contenu associé

- [Outils d inspection, de diff et de transformation JSON](https://elysiatools.com/fr/hubs/json-utility): Regroupe dans un meme hub les outils de formatage JSON, comparaison, inspection de chemins, validation de schema, fusion et transformation pour les workflows API et donnees.
- [Generateurs de schemas JSON, donnees mock et fixtures API](https://elysiatools.com/fr/hubs/json-generate): Des outils reunis pour generation de schemas JSON, construction de payloads mock et preparation de fixtures API dans un seul hub.
- [Outils d observabilite, d analyse de logs et de debogage de traces](https://elysiatools.com/fr/hubs/observability-debugging): Analysez des logs, inspectez des traces, comparez la derive des payloads API et transformez des donnees d observabilite brutes en chronologies, diagrammes et preuves structurees pour deboguer plus vite.
- [Outils d interchange JSON et de traduction de formats](https://elysiatools.com/fr/hubs/json-convert): Comparez les outils de conversion JSON pour CSV, YAML, TOML, GraphQL, XML, Markdown, Excel, BSON, EDN et d autres formats structures dans un meme hub.