Pular para o conteúdo
Coverton Blogue
Neste artigo
Tabelas e dados

Mapeamento de coluna CSV: conferir estrutura e formato

Um modelo de upload pode usar cabeçalhos e encomendas diferentes da sua folha de produto. Defina qual coluna de fonte fornece cada campo de destino antes de preparar o arquivo para a apresentação.

Abra a ferramentaComo usar esta ferramenta ↓
Mapeamento de coluna CSV
A ilustração mostra o fluxo de uso da ferramenta. Ela não representa o resultado de um arquivo enviado.

Como usar esta ferramenta

  1. Adicione a folha de fonte e inspire os cabeçalhos do modelo de upload.
  2. Grave nomes de destino de mapeamento JSON em nomes de origem.
  3. Execute a tarefa e compare a ordem das colunas e os valores originais.
  4. Descarregue a folha pronta para upload.

Escolha as configurações certas

Escreva os cabeçalhos de destino como chaves JSON e os nomes das colunas de origem como seus valores de string. Liste os campos de destino na ordem necessária, sem esperar que os valores ausentes na origem sejam gerados automaticamente.

Entrada suportada
  • CSV,TSV,XLSX
Configurações disponíveis
  • Coluna de destino: coluna de origem (JSON)

Antes de começar

Entenda os dados antes de transformá-los

Identifique o que cada linha ou valor representa e guarde uma cópia da fonte. Em tabelas, confira cabeçalhos, separadores e codificação; em arquivos estruturados, veja os objetos ou arrays exigidos. A exibição de uma planilha não basta para interpretar identificadores, datas e valores monetários.

Escolha colunas de correspondência, regras de tipo e campos de saída conforme o destino, quando essas opções existirem. Teste uma amostra com campo vazio, repetição e pontuação. Em etiquetas, gráficos ou documentos personalizados, confira de qual coluna vem cada valor, além das unidades e dos textos.

Defina verificações antes de processar: um identificador que deve manter a grafia, um valor com interpretação conhecida e uma relação esperada entre registros. Quando houver regras de tipo ou correspondência, diferencie o valor fonte de sua exibição. Teste datas ambíguas e chaves com grafias diferentes antes de adotar uma regra ampla. Guarde regras e exigências do destino com o resultado para identificar se a diferença vem da entrada, da interpretação ou da transformação.

Confira valores e exceções

Reabra ou importe a saída com os ajustes do programa de destino. Compare cabeçalhos, número de registros e algumas amostras com a fonte. Resumir, dividir ou remover duplicatas pode mudar a quantidade de propósito; verifique a razão, em vez de exigir o mesmo total de linhas em toda transformação.

Leia os relatórios de exceção ou validação antes de seguir. Para colunas deslocadas, caracteres ilegíveis ou chaves ausentes, confira delimitador, codificação e grafia exata dos cabeçalhos. Codificar não é criptografar; formatar não confirma o significado. Teste os códigos ou etiquetas impressos antes de produzir o conjunto completo.

Exemplo de entrada e saída

Títulos de origem + JSON mapeamento → folha de passagem de ordem de destino

Exemplos descrevem o fluxo de trabalho. Os resultados dependem do arquivo de origem e das configurações.

Verifique o resultado antes de salvar

Compare os cabeçalhos de saída e a ordem das colunas com o modelo de upload real antes de enviar o arquivo. Combine cada campo de destino com seus valores de origem e confirme se as colunas obrigatórias não foram omitidas.

Se o resultado for diferente do que você esperava

Para erros de coluna ausente, verifique se os valores de mapeamento contêm nomes de origem em vez de títulos de destino. Corrija a sintaxe JSON ou os mapeamentos sem string e, em seguida, revise as regras separadas de tipo e valor necessário do sistema receptor.

Limites de uso

  • As chaves JSON são cabeçalhos de destino; os valores são cabeçalhos de origem. A saída segue a ordem de mapeamento.

Continue com ferramentas relacionadas

Converter CSV para JSON

A primeira linha CSV fornece as chaves para o objeto JSON de cada linha de dados. Os valores das células são armazenados como strings, portanto, inspecione seus tipos antes de passar o resultado para um sistema que espera números ou valores booleanos.

Escolha o codificação de fonte e use detecção de delimitador automática ou selecione o delimitador real. Resolva cabeças vazias ou duplicadas e certifique-se de que cada linha tem o mesmo número de colunas que o cabeças.

Abra a ferramenta

Converter JSON para CSV

A conversão exige um array cujos elementos sejam objetos. Decida se os objetos aninhados devem virar colunas separadas ou permanecer como strings JSON nas células; a leitura da planilha muda conforme essa escolha.

Ative o achatamento para transformar as propriedades de objetos aninhados em cabeçalhos unidos por pontos. Os arrays não são expandidos em várias linhas; confira essas células separadamente se quiser analisar cada elemento.

Abra a ferramenta
CovertonMapeamento de coluna CSV
Abra a ferramenta

Este guia explica a ferramenta de acesso público que funciona no navegador. Guarde uma cópia do original e confira o resultado antes de compartilhar.

Esta tradução foi preparada com auxílio de software. Você também pode ler a versão em inglês. Leia em inglês