Categorías

Estudio de consultas y transformaciones JSONata

Previsualiza consultas y transformaciones estilo JSONata, compara resultados y exporta en JSON, CSV, YAML o Markdown.

Pegue un objeto o array JSON en "Entrada JSON" y luego escriba una expresion JSONata en "Expresion JSONata".

Como llenar los campos:

  • Entrada JSON: payload JSON principal para consultar o transformar
  • Expresion JSONata: una expresion JSONata estandar o una forma helper como groupBy(orders, "status")
  • Entrada JSON de comparacion: segundo payload opcional evaluado con la misma expresion para comparar resultados lado a lado
  • Formato de salida: renderiza el resultado como JSON, CSV, YAML o Markdown
  • Guardar expresion: guarda la expresion actual en el historial local
  • Nombre de plantilla: nombre opcional mostrado en el historial

Estilos de expresion admitidos:

  • JSONata estandar, como $sum(orders.total) u orders[status="paid"]
  • Helpers del estudio sin prefijo $:
  • groupBy(collection, "field.path")
  • mapField(collection, "field.path")
  • flatten(collection)
  • distinct(collection)
  • count(collection)
  • sum(collection)
  • avg(collection)
  • keys(object)

Ejemplos:

  • Entrada JSON: {"orders":[{"id":1,"status":"paid","total":120},{"id":2,"status":"pending","total":40}]}
  • Expresion: groupBy(orders, "status")
  • Expresion: sum(orders.total)
  • Expresion: orders[status="paid"]

Notas:

  • La herramienta usa el runtime real de jsonata y preprocesa los helpers anteriores para volverlos invocables.
  • La entrada JSON de comparacion es opcional, pero sirve mucho para validar la misma transformacion sobre dos respuestas de API o fixtures.

Resultados de ejemplo

1 Ejemplos

Agrupar pedidos por estado y exportar el resultado

Usa una expresion para comparar la distribucion de estados entre dos snapshots.

groupBy result preview
Ver parámetros de entrada
{ "jsonInput": "{\"orders\":[{\"id\":1,\"status\":\"paid\",\"total\":120},{\"id\":2,\"status\":\"pending\",\"total\":40}]}", "expression": "groupBy(orders, \"status\")", "outputFormat": "json" }

Datos clave

Categoría
Data Processing
Tipos de entrada
textarea, select, checkbox, text
Tipo de salida
html
Cobertura de muestras
4
API disponible
Yes

Resumen

El Estudio de consultas y transformaciones JSONata es una herramienta avanzada que te permite evaluar expresiones JSONata en tiempo real. Diseñada para desarrolladores y analistas de datos, facilita la extracción, filtrado y transformación de estructuras JSON complejas. Además, puedes comparar los resultados entre diferentes conjuntos de datos y exportar la salida final en formatos como JSON, CSV, YAML o Markdown, optimizando tu flujo de trabajo con APIs y bases de datos.

Cuándo usarlo

  • Para extraer, filtrar o agregar datos específicos a partir de respuestas JSON complejas de APIs.
  • Cuando necesitas comparar el comportamiento de una misma expresión JSONata en dos conjuntos de datos diferentes.
  • Para transformar estructuras JSON anidadas en formatos planos como CSV o tablas Markdown para la elaboración de informes.

Cómo funciona

  • Pega tu código en el campo 'Entrada JSON' para definir el conjunto de datos principal que deseas analizar.
  • Escribe tu regla de transformación en el campo 'Expresión JSONata' (por ejemplo, groupBy(orders, "status")).
  • Opcionalmente, añade una 'Entrada JSON de comparación' para evaluar la misma expresión en un segundo conjunto de datos.
  • Selecciona el 'Formato de salida' (JSON, CSV, YAML o Markdown) y previsualiza o exporta los resultados transformados.

Casos de uso

Transformación de respuestas de API complejas en estructuras simplificadas para su consumo en el frontend.
Mapeo y validación de datos durante migraciones entre diferentes sistemas o bases de datos NoSQL.
Generación rápida de reportes legibles (en CSV o Markdown) a partir de registros JSON sin procesar.

Ejemplos

1. Agrupar pedidos de comercio electrónico por estado

Analista de Datos
Contexto
Un analista necesita revisar un volcado de datos JSON con cientos de pedidos para ver cuántos están pagados y cuántos pendientes.
Problema
El JSON original es una lista plana de pedidos, lo que dificulta el análisis del estado general de las ventas.
Cómo usarlo
Pega el JSON de los pedidos en la entrada principal, usa la expresión `groupBy(orders, "status")` y selecciona CSV como formato de salida.
Configuración de ejemplo
{"outputFormat": "csv"}
Resultado
Los pedidos se agrupan automáticamente por su estado (pagado, pendiente) y se estructuran en un formato CSV listo para importar a Excel.

2. Comparar respuestas de API v1 y v2

Desarrollador Backend
Contexto
El equipo está migrando una API a una nueva versión y necesita asegurarse de que los campos críticos se extraigan correctamente en ambas versiones.
Problema
Verificar manualmente que la lógica de extracción funciona tanto para el formato antiguo como para el nuevo es propenso a errores.
Cómo usarlo
Introduce el JSON de la v1 en la entrada principal y el de la v2 en la entrada de comparación. Aplica la expresión JSONata para extraer los campos deseados.
Configuración de ejemplo
{"saveExpression": true, "templateName": "Validación de Migración API"}
Resultado
La herramienta muestra los resultados de la extracción para ambos JSON simultáneamente, confirmando que la expresión es compatible con ambas versiones.

Probar con muestras

json, csv, yaml

Hubs relacionados

Preguntas frecuentes

¿Qué es JSONata?

JSONata es un lenguaje de consulta y transformación ligero diseñado específicamente para extraer y manipular datos dentro de estructuras JSON.

¿Puedo exportar los resultados a Excel?

Puedes seleccionar CSV como formato de salida, el cual es totalmente compatible y se puede abrir directamente en Excel u otras hojas de cálculo.

¿Para qué sirve la entrada de comparación?

Te permite probar tu expresión JSONata simultáneamente en dos cargas útiles diferentes, ideal para verificar la compatibilidad entre distintas versiones de una API.

¿Puedo guardar mis consultas frecuentes?

Sí, puedes marcar la opción 'Guardar expresión' y asignarle un 'Nombre de plantilla' para reutilizar tus transformaciones en el futuro.

¿Qué formatos de salida están soportados?

La herramienta soporta la exportación de los datos transformados en formato JSON, CSV, YAML y Markdown.

Documentación de la API

Punto final de la solicitud

POST /es/api/tools/jsonata-query-transform-studio

Parámetros de la solicitud

Nombre del parámetro Tipo Requerido Descripción
jsonInput textarea -
expression textarea -
compareJsonInput textarea No -
outputFormat select No -
saveExpression checkbox No -
templateName text No -

Formato de respuesta

{
  "result": "
Processed HTML content
", "error": "Error message (optional)", "message": "Notification message (optional)", "metadata": { "key": "value" } }
HTML: HTML

Documentación de MCP

Agregue este herramienta a su configuración de servidor MCP:

{
  "mcpServers": {
    "elysiatools-jsonata-query-transform-studio": {
      "name": "jsonata-query-transform-studio",
      "description": "Previsualiza consultas y transformaciones estilo JSONata, compara resultados y exporta en JSON, CSV, YAML o Markdown.",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=jsonata-query-transform-studio",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Puede encadenar múltiples herramientas, por ejemplo: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máximo 20 herramientas.

Si encuentra algún problema, por favor, póngase en contacto con nosotros en [email protected]