Categorias

Transformador XLSX JSON

Conversao bidirecional entre JSON e Excel com flatten/restauracao

Converte JSON<->XLSX e trata caminhos aninhados.

Exemplos de resultados

2 Exemplos

JSON aninhado para XLSX

Converte JSON aninhado para colunas de caminho

xlsx-json-transformer-example1.xlsx Ver arquivo
Ver parâmetros de entrada
{ "mode": "json_to_xlsx", "jsonInput": "[{\"id\":1,\"user\":{\"name\":\"Alice\",\"address\":{\"city\":\"Paris\"}},\"tags\":[\"a\",\"b\"]}]", "pathSeparator": ".", "arrayMode": "index" }

Restaurar JSON do XLSX

Reconstrói objetos aninhados a partir das colunas

xlsx-json-transformer-example2.json Ver arquivo
Ver parâmetros de entrada
{ "mode": "xlsx_to_json", "excelFile": "/public/samples/xlsx/xlsx-json-transformer-example1.xlsx", "pathSeparator": ".", "restoreTypes": true }

Click to upload file or drag and drop file here

Maximum file size: 100MB Supported formats: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel

Fatos principais

Categoria
Format Conversion
Tipos de entrada
select, textarea, file, text, checkbox, number
Tipo de saída
file
Cobertura de amostras
4
API disponível
Yes

Visão geral

O Transformador XLSX JSON é uma ferramenta eficiente para realizar a conversão bidirecional entre arquivos Excel e estruturas de dados JSON, permitindo o processamento de objetos aninhados através de recursos de achatamento (flatten) e restauração automática.

Quando usar

  • Quando você precisa converter dados de APIs em formato JSON para planilhas Excel organizadas.
  • Ao extrair dados de arquivos XLSX complexos para utilizá-los em aplicações web ou bancos de dados JSON.
  • Para normalizar estruturas de dados aninhadas em colunas de planilha legíveis e vice-versa.

Como funciona

  • Selecione o modo de transformação desejado: JSON para XLSX ou XLSX para JSON.
  • Insira seu código JSON ou carregue o arquivo Excel correspondente.
  • Configure o separador de caminhos e o modo de tratamento de arrays para definir como os dados aninhados serão mapeados.
  • Execute a conversão e baixe o arquivo resultante com a estrutura de dados processada.

Casos de uso

Migração de dados de sistemas legados em Excel para bancos de dados NoSQL baseados em JSON.
Preparação de relatórios de dados estruturados para análise em ferramentas de BI.
Sincronização de configurações de aplicações armazenadas em JSON com planilhas de controle administrativo.

Exemplos

1. Conversão de JSON Aninhado para XLSX

Desenvolvedor Web
Contexto
Preciso transformar uma resposta de API contendo usuários e endereços aninhados em uma planilha para a equipe de marketing.
Problema
O JSON possui objetos dentro de objetos que não são lidos diretamente pelo Excel.
Como usar
Cole o JSON no campo de entrada, defina o separador como '.' e selecione o modo 'JSON para XLSX'.
Configuração de exemplo
pathSeparator: '.', arrayMode: 'index'
Resultado
O arquivo XLSX gerado contém colunas como 'user.name' e 'user.address.city', mantendo a hierarquia dos dados.

2. Restauração de JSON a partir de Planilha

Analista de Dados
Contexto
Recebi uma planilha com dados de vendas que precisam ser importados para um sistema que aceita apenas JSON.
Problema
A planilha possui cabeçalhos hierárquicos que precisam ser convertidos de volta para objetos JSON.
Como usar
Carregue o arquivo Excel, selecione o modo 'XLSX para JSON' e ative a opção 'Restaurar Valor Tipos'.
Configuração de exemplo
restoreTypes: true, pathSeparator: '.'
Resultado
O sistema gera um arquivo JSON limpo, com os tipos de dados originais restaurados e a estrutura aninhada reconstruída.

Testar com amostras

json, xml, xlsx

Hubs relacionados

FAQ

A ferramenta suporta objetos JSON aninhados?

Sim, a ferramenta utiliza um separador de caminhos configurável para achatar objetos complexos em colunas de planilha.

Posso restaurar a estrutura original do JSON a partir de um Excel?

Sim, ao utilizar o modo XLSX para JSON, a ferramenta reconstrói automaticamente os objetos aninhados com base nos cabeçalhos das colunas.

Como os arrays são tratados na conversão?

Você pode optar por indexar os caminhos dos arrays ou armazená-los como uma string JSON dentro da célula.

É possível manter valores nulos durante a conversão?

Sim, a opção 'Manter Nulo Valores' permite preservar campos vazios ou nulos conforme a estrutura original.

Quais formatos de arquivo são aceitos?

A ferramenta suporta os formatos padrão do Microsoft Excel (.xlsx e .xls).

Documentação da API

Ponto final da solicitação

POST /pt/api/tools/xlsx-json-transformer

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
mode select Sim -
jsonInput textarea Não -
excelFile file (Upload necessário) Não -
sheetName text Não -
pathSeparator text Não -
arrayMode select Não -
keepNullValues checkbox Não -
restoreTypes checkbox Não -
rootArrayKey text Não -
outputIndent number Não -

Os parâmetros de tipo arquivo precisam ser carregados primeiro via POST /upload/xlsx-json-transformer para obter filePath, depois filePath deve ser passado ao campo de arquivo correspondente.

Formato de resposta

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
Arquivo: Arquivo

Documentação de MCP

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

{
  "mcpServers": {
    "elysiatools-xlsx-json-transformer": {
      "name": "xlsx-json-transformer",
      "description": "Conversao bidirecional entre JSON e Excel com flatten/restauracao",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=xlsx-json-transformer",
      "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.

Suporta links de arquivos URL ou codificação Base64 para parâmetros de arquivo.

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