Como converter CSV para JSON

Para que serve a conversão de CSV para JSON

Esta ferramenta converte texto em formato CSV para dados formatados como JSON. Pode ser útil quando tem uma tabela em texto e precisa de a transformar numa estrutura de registos, por exemplo, para uma integração, uma verificação rápida ou preparação de dados. A primeira linha pode ser usada como nomes dos campos, o que torna cada linha seguinte num registo com uma estrutura mais legível.

Como converter o texto CSV

1. Prepare o conteúdo em CSV como texto. Inclua as linhas e os separadores de coluna no formato CSV; não carregue um livro do Excel ou outro ficheiro, porque a entrada prevista é texto fornecido diretamente.

2. Cole o conteúdo no campo de entrada da ferramenta. Se deixar o campo vazio, ou inserir apenas espaços, a conversão devolve um conjunto JSON vazio e uma contagem de zero registos.

3. Decida como a primeira linha deve ser tratada. Com o mapeamento de cabeçalhos ativo, quando existem várias linhas, a primeira é usada como nome dos campos e as linhas seguintes são convertidas em registos. Desative essa opção se a primeira linha também for informação e não cabeçalho; nesse caso, cada linha analisada é tratada como dados.

4. Se precisar de controlar a apresentação, indique o nível numérico de indentação do JSON. O valor predefinido é 2, mas pode escolher outro valor suportado pelo controlo.

5. Inicie a conversão e leia o JSON produzido juntamente com a contagem de registos. Se ocorrer uma exceção durante o processamento, o resultado apresentado é um conjunto JSON vazio, a contagem é zero e é incluída uma descrição do erro.

Como interpretar o resultado

Leia a contagem de registos em conjunto com o JSON, em vez de olhar apenas para a formatação. Com o mapeamento de cabeçalhos ativo, a primeira linha de um conjunto com várias linhas não entra como registo: fornece os nomes dos campos. Ao desativar o mapeamento, essa linha passa a ser tratada como dados, pelo que a contagem e a forma dos objetos podem mudar.

Um resultado vazio com contagem zero pode ser esperado quando a entrada está em branco ou contém apenas espaços. Também pode surgir depois de uma exceção de processamento; nesse caso, consulte a descrição do erro antes de concluir que não havia dados. A indentação altera a apresentação do JSON, não a escolha das linhas como cabeçalhos ou registos.

A ferramenta é adequada para uma conversão simples de linhas e colunas em registos JSON. Verifique manualmente o resultado quando o conteúdo depender de regras de interpretação mais específicas ou quando a primeira linha não tiver um papel óbvio.

Exemplo prático

Uma pessoa recebe duas linhas de texto CSV e pretende obter um registo JSON com os campos definidos pela primeira linha.

Cole o CSV com a primeira linha «nome,idade» e uma linha de dados, mantenha o mapeamento de cabeçalhos ativo e execute a conversão.

O resultado tem a forma de uma lista JSON de registos, acompanhada pela contagem de registos produzidos.

Limitações

• A entrada prevista é texto CSV fornecido diretamente. Esta conversão não corresponde ao envio direto de um livro do Excel ou de outro ficheiro.
• A transformação descrita converte linhas CSV em registos JSON; não pressupõe uma estrutura de objetos aninhados ou uma transformação de esquema mais ampla.

Erros comuns

• Erro: colar uma tabela ou indicar um ficheiro em vez de fornecer o conteúdo CSV como texto. Correção: copie o texto CSV completo para a entrada, mantendo as linhas e os separadores.

Perguntas frequentes

Posso enviar um ficheiro Excel diretamente?

Não. A ferramenta aceita apenas texto em formato CSV colado ou inserido diretamente no campo de entrada, não permitindo o carregamento direto de ficheiros Excel (.xlsx/.xls).

Como faço para manter a primeira linha como dados?

Se existirem várias linhas e o mapeamento de cabeçalhos estiver ativo, a primeira linha fornece os nomes dos campos e as seguintes formam os registos. Desative essa opção para tratar também a primeira linha como dados.

O que significa obter zero registos?

Uma entrada vazia ou composta apenas por espaços produz um conjunto JSON vazio e uma contagem de zero registos. Uma exceção durante o processamento também devolve esses valores, mas acrescenta uma descrição do erro.