Como converter CSV para JSON com cabeçalhos e delimitador

Quando usar esta conversão

Converta texto CSV numa representação JSON quando precisar de reutilizar dados tabulares numa aplicação ou de preparar essa informação para outro fluxo de trabalho. A ferramenta recebe o conteúdo CSV como texto e permite definir o delimitador, o tratamento da primeira linha e a apresentação do JSON. Por predefinição, o delimitador é a vírgula, a primeira linha é usada como cabeçalho e a indentação tem o valor 2. Esta combinação é adequada para um CSV convencional, mas deve ser ajustada quando o conteúdo usa ponto e vírgula ou não apresenta cabeçalhos. Antes de começar, observe a organização das linhas para escolher opções coerentes com os dados que vai fornecer.

Passos para converter o texto

1. Cole o conteúdo CSV no campo de entrada. Inclua a primeira linha com os nomes dos campos se quiser que ela seja usada para criar as propriedades dos registos. Texto vazio ou composto apenas por espaços é rejeitado, por isso confirme que existe conteúdo antes de avançar.

2. Selecione o delimitador que aparece entre os campos. Use a vírgula para texto separado por vírgulas e escolha o ponto e vírgula quando cada campo estiver separado por ;. A opção deve corresponder ao texto fornecido, não apenas ao formato que esperava receber.

3. Mantenha o tratamento de cabeçalhos ativado quando a primeira linha contém nomes como nome ou idade. Desative-o se todas as linhas devem ser processadas sem transformar a primeira numa lista de nomes de propriedades.

4. Ajuste a indentação JSON quando precisar de outra apresentação. O valor predefinido é 2, e a configuração escolhida altera a forma como o resultado é apresentado, não a necessidade de fornecer CSV válido.

5. Execute a conversão e leia o resultado. Se a análise do CSV gerar uma falha, a operação termina sem devolver uma saída JSON. Quando os dados vierem de outra pessoa, verifique previamente se as linhas usam o mesmo delimitador e se a sua estrutura corresponde à opção de cabeçalhos escolhida.

Leitura do resultado JSON

Com os cabeçalhos ativos, uma linha que tenha o mesmo número de campos que a primeira linha é representada como um registo de pares entre nomes de cabeçalho e valores. Nesse caso, os espaços exteriores dos cabeçalhos e das células são removidos. O resultado fica, portanto, organizado por propriedades nomeadas quando a estrutura da linha coincide com a do cabeçalho.

Uma linha com mais ou menos campos do que a primeira não segue esse formato de registo; é mantida como valores de linha. O JSON pode assim combinar registos associados a propriedades com linhas representadas pelos seus valores quando o conteúdo não é uniforme. Esta diferença merece atenção ao validar dados importados, porque uma linha irregular não recebe automaticamente as propriedades dos cabeçalhos. Com o tratamento de cabeçalhos desativado, a primeira linha deixa de definir nomes e as linhas são processadas sem essa interpretação.

Exemplo prático

Uma pessoa recebeu contactos separados por ponto e vírgula e quer obter uma estrutura JSON com propriedades baseadas na primeira linha.

Cole as linhas nome;idade, Ana;31 e Bruno;29 no campo de entrada, selecione o ponto e vírgula, mantenha os cabeçalhos ativos e execute a conversão.

O resultado apresenta registos com propriedades associadas a nome e idade. Se uma linha tiver uma quantidade diferente de campos, surge como valores de linha, sem associação completa aos cabeçalhos.

Limitações

• A entrada vazia ou só com espaços é rejeitada, e uma falha na análise não produz JSON.

Erros comuns

• Se escolher a vírgula para um texto separado por ponto e vírgula, os campos podem ser contados de forma inesperada e algumas linhas podem deixar de coincidir com o cabeçalho. Selecione o separador que aparece entre os valores e reveja a estrutura das linhas.

Perguntas frequentes

Como converter um CSV separado por ponto e vírgula?

Quando os campos estiverem separados por ponto e vírgula, selecione esse delimitador antes de executar a conversão. A vírgula é a configuração predefinida, pelo que deve ser alterada para este formato.

Como decidir se a primeira linha é um cabeçalho?

Se a primeira linha trouxer nomes de campos, deixe o tratamento de cabeçalhos ativo para que as linhas compatíveis possam ser associadas a esses nomes. Desative essa opção quando a primeira linha também for apenas uma linha de valores.

O que acontece a uma linha com campos a mais ou a menos?

Quando a quantidade de campos não coincidir com a da primeira linha, essa linha é conservada como valores de linha, em vez de ser apresentada como um registo ligado aos cabeçalhos. Verifique essa parte do resultado antes de o reutilizar.