Categorias

Studio de consulta e transformacao JSONata

Visualize consultas e transformacoes no estilo JSONata, compare resultados e exporte em JSON, CSV, YAML ou Markdown.

Cole um objeto ou array JSON em "Entrada JSON" e depois informe uma expressao em "Expressao JSONata".

Como preencher os campos:

  • Entrada JSON: payload JSON principal para consulta ou transformacao
  • Expressao JSONata: uma expressao JSONata padrao ou uma forma helper como groupBy(orders, "status")
  • Entrada JSON de comparacao: segundo payload opcional avaliado com a mesma expressao para comparar os resultados lado a lado
  • Formato de saida: renderiza o resultado como JSON, CSV, YAML ou Markdown
  • Salvar expressao: salva a expressao atual no historico local
  • Nome do modelo: nome opcional exibido no historico salvo

Estilos de expressao suportados:

  • JSONata padrao, como $sum(orders.total) ou orders[status="paid"]
  • Helpers do studio sem o prefixo $:
  • groupBy(collection, "field.path")
  • mapField(collection, "field.path")
  • flatten(collection)
  • distinct(collection)
  • count(collection)
  • sum(collection)
  • avg(collection)
  • keys(object)

Exemplos:

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

Notas:

  • A ferramenta usa o runtime real do jsonata e preprocessa os helpers acima para transformalos em funcoes chamaveis.
  • A entrada JSON de comparacao e opcional, mas muito util para validar a mesma transformacao em duas respostas de API ou fixtures.

Exemplos de resultados

1 Exemplos

Agrupar pedidos por status e exportar o resultado

Compare a distribuicao de status entre dois snapshots com uma expressao.

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" }

Fatos principais

Categoria
Data Processing
Tipos de entrada
textarea, select, checkbox, text
Tipo de saída
html
Cobertura de amostras
4
API disponível
Yes

Visão geral

O Studio de Consulta e Transformação JSONata é uma ferramenta poderosa para desenvolvedores e analistas de dados que precisam extrair, filtrar e reestruturar dados JSON complexos. Com suporte para visualização em tempo real, você pode testar expressões JSONata, comparar resultados entre diferentes conjuntos de dados e exportar a saída final perfeitamente para formatos como JSON, CSV, YAML ou Markdown.

Quando usar

  • Quando precisar extrair ou filtrar campos específicos de grandes cargas de dados JSON (payloads) retornadas por APIs.
  • Para transformar e reestruturar dados aninhados antes de importá-los para bancos de dados ou planilhas.
  • Ao testar e validar expressões JSONata comparando os resultados entre dois arquivos JSON diferentes simultaneamente.

Como funciona

  • Cole o seu código JSON original no campo 'Entrada JSON'.
  • Escreva a sua regra de extração ou transformação no campo 'Expressão JSONata'.
  • Insira um segundo JSON no campo de comparação (opcional) para validar a mesma expressão em dados diferentes.
  • Escolha o formato de saída desejado (JSON, CSV, YAML ou Markdown) e visualize ou exporte o resultado.

Casos de uso

Conversão de respostas complexas de APIs REST em tabelas CSV simplificadas para análise de negócios.
Agrupamento e soma de valores de pedidos de e-commerce com base no status da transação.
Criação de relatórios em Markdown a partir de logs de sistema exportados em formato JSON.

Exemplos

1. Agrupar pedidos por status

Analista de Dados
Contexto
Um analista recebe um dump de dados de e-commerce em JSON e precisa ver o total de pedidos agrupados por status (pago, pendente).
Problema
O JSON bruto é difícil de ler e não está sumarizado para relatórios em planilhas.
Como usar
Insira o JSON de pedidos, use a expressão de agrupamento e selecione a saída como CSV.
Configuração de exemplo
{
  "expression": "groupBy(orders, \"status\")",
  "outputFormat": "csv"
}
Resultado
Os dados são reestruturados em grupos de status e formatados em CSV para fácil importação no Excel.

2. Filtrar e exportar logs para Markdown

Engenheiro de DevOps
Contexto
O engenheiro precisa extrair apenas os erros críticos de um arquivo de log JSON gigante para incluir na documentação do incidente.
Problema
Encontrar e formatar manualmente os erros críticos consome muito tempo e é propenso a erros.
Como usar
Cole o log no campo de entrada, escreva uma expressão JSONata para filtrar os erros e escolha 'Markdown' como formato de saída.
Configuração de exemplo
{
  "outputFormat": "markdown",
  "saveExpression": true,
  "templateName": "Filtro de Erros Críticos"
}
Resultado
Uma tabela Markdown limpa contendo apenas os logs críticos é gerada, pronta para ser colada no GitHub ou Jira, e a expressão fica salva para uso futuro.

Testar com amostras

json, csv, yaml

Hubs relacionados

FAQ

O que é JSONata?

JSONata é uma linguagem de consulta e transformação leve projetada especificamente para extrair e reestruturar dados de documentos JSON.

Quais formatos de exportação são suportados?

Você pode exportar os resultados da sua transformação diretamente para JSON, CSV, YAML ou tabelas em Markdown.

Posso comparar dois arquivos JSON ao mesmo tempo?

Sim, você pode usar o campo 'JSON de comparação' para aplicar a mesma expressão JSONata a um segundo conjunto de dados e analisar as diferenças.

É possível salvar as expressões que eu criar?

Sim, basta marcar a opção 'Salvar expressão' e definir um 'Nome do modelo' para reutilizar suas consultas no futuro.

Preciso instalar algum software para usar a ferramenta?

Não, o Studio de Consulta e Transformação JSONata funciona inteiramente no seu navegador, sem necessidade de instalações ou configurações complexas.

Documentação da API

Ponto final da solicitação

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

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
jsonInput textarea Sim -
expression textarea Sim -
compareJsonInput textarea Não -
outputFormat select Não -
saveExpression checkbox Não -
templateName text Não -

Formato de resposta

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

Documentação de MCP

Adicione este ferramenta à sua configuração de servidor MCP:

{
  "mcpServers": {
    "elysiatools-jsonata-query-transform-studio": {
      "name": "jsonata-query-transform-studio",
      "description": "Visualize consultas e transformacoes no estilo JSONata, compare resultados e exporte em JSON, CSV, YAML ou Markdown.",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=jsonata-query-transform-studio",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Você pode encadear várias ferramentas, ex: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máx 20 ferramentas.

Se você encontrar algum problema, por favor, entre em contato conosco em [email protected]