Mapeador de Colunas XLSX

Renomeia/reordena/remove colunas por regras

Suporta aliases, caixa e espacos nos cabecalhos.

Exemplos de resultados

1 Exemplos

Mapear colunas por alias

Renomeia e reordena colunas

xlsx-column-mapper-example1.xlsx Ver arquivo
Ver parâmetros de entrada
{ "excelFile": "/public/samples/xlsx/workbook-sales.xlsx", "renameMapJson": "{\"name\":\"customer_name\",\"region\":\"market\"}", "reorderColumns": "customer_name,market,amount" }

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
Conversão e codificação
Tipos de entrada
file, text, number, textarea, checkbox
Tipo de saída
file
Cobertura de amostras
4
API disponível
Yes

Visão geral

O Mapeador de Colunas XLSX é uma ferramenta eficiente para padronizar e organizar planilhas, permitindo renomear, reordenar ou remover colunas automaticamente com base em regras personalizadas.

Quando usar

  • Padronizar cabeçalhos de arquivos vindos de diferentes fontes para um formato único.
  • Limpar planilhas removendo colunas desnecessárias ou temporárias antes de uma importação.
  • Reorganizar a ordem das colunas para atender aos requisitos de sistemas de destino ou bancos de dados.

Como funciona

  • Carregue o seu arquivo Excel e especifique o nome da aba e a linha do cabeçalho.
  • Defina as regras de renomeação ou mapeamento de aliases para normalizar os nomes das colunas.
  • Configure a ordem desejada das colunas ou liste aquelas que devem ser removidas.
  • Aplique as configurações e baixe o arquivo processado com a estrutura ajustada.

Casos de uso

Preparação de dados para importação em CRMs ou ERPs que exigem nomes de colunas específicos.
Consolidação de relatórios de vendas de diferentes departamentos em um formato padronizado.
Remoção de colunas sensíveis ou irrelevantes de planilhas antes de compartilhá-las com terceiros.

Exemplos

1. Padronização de Relatório de Vendas

Analista de Dados
Contexto
Recebo relatórios de vendas com cabeçalhos inconsistentes como 'Nome do Cliente' e 'Região'.
Problema
Preciso renomear essas colunas para 'customer_name' e 'market' e garantir que a ordem seja consistente para o sistema interno.
Como usar
Faça o upload do arquivo, insira o mapeamento JSON e defina a ordem das colunas desejada.
Configuração de exemplo
{"renameMapJson": "{\"Nome do Cliente\":\"customer_name\",\"Região\":\"market\"}", "reorderColumns": "customer_name,market,amount"}
Resultado
O arquivo é gerado com os cabeçalhos renomeados e na ordem exata solicitada, pronto para importação.

Testar com amostras

json, xml, xlsx

Hubs relacionados

FAQ

Posso renomear várias colunas de uma vez?

Sim, você pode fornecer um objeto JSON no campo 'Renomear Mapa JSON' para mapear múltiplos nomes de colunas simultaneamente.

A ferramenta diferencia maiúsculas de minúsculas?

Por padrão, a ferramenta ignora a caixa e espaços nos cabeçalhos, mas você pode ajustar essas opções nas configurações.

O que acontece com as colunas que não mapeei?

Se a opção 'Manter não mapeadas' estiver ativada, as colunas não especificadas serão preservadas no arquivo final.

Quais formatos de arquivo são aceitos?

A ferramenta suporta arquivos no formato .xlsx e .xls (Excel).

É possível alterar a ordem das colunas?

Sim, utilize o campo 'Reordenar Colunas' inserindo os nomes das colunas na sequência exata que deseja no arquivo de saída.

Documentação da API

Ponto final da solicitação

POST /pt/api/tools/xlsx-column-mapper

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
excelFile file (Upload necessário) Sim -
sheetName text Não -
headerRow number Não -
renameMapJson textarea Não -
aliasMapJson textarea Não -
reorderColumns text Não -
removeColumns text Não -
ignoreCase checkbox Não -
ignoreSpaces checkbox Não -
keepUnmapped checkbox Não -

Os parâmetros de tipo arquivo precisam ser carregados primeiro via POST /upload/xlsx-column-mapper 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-column-mapper": {
      "name": "xlsx-column-mapper",
      "description": "Renomeia/reordena/remove colunas por regras",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=xlsx-column-mapper",
      "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]