Conversor JSON ⇔ CSV

O que é o Conversor JSON ⇔ CSV?

O Conversor JSON ⇔ CSV é uma ferramenta para converter entre o formato JSON — comummente utilizado em APIs web e programação — e o formato CSV — amplamente utilizado em software de folhas de cálculo e sistemas empresariais.Enquanto o JSON pode representar dados estruturados utilizando objetos e matrizes, o CSV é um formato tabular simples composto por linhas e colunas, tornando-o adequado para importar para o Excel ou folhas de cálculo, analisar dados em lista e transferir dados para outros sistemas.Pode utilizar esta ferramenta quando pretender guardar JSON recuperado de uma API como um ficheiro CSV, ou quando pretender converter dados de listas CSV em JSON que possam ser processados por JavaScript ou por uma API.

Ao converter de JSON para CSV, normalmente fornece-se um conjunto de objetos que contêm todos os mesmos tipos de campos. Por exemplo, se tiver um JSON que contenha vários objetos de produto com campos como nome, preço e stock, cada chave torna-se um cabeçalho de coluna no CSV e cada objeto é apresentado como uma linha separada. Mesmo que um campo esteja presente apenas em algumas linhas, todas as chaves são reunidas para criar colunas, e as células sem valores são tratadas como em branco. Os objetos aninhados podem ser expandidos para nomes de coluna, como `address.city`, ativando a opção «Expandir JSON aninhado utilizando notação de ponto».

Ao converter de CSV para JSON, considere a primeira linha como nomes de colunas e converta as linhas a partir da segunda linha num objeto. Uma vez que todos os valores no CSV são representados como texto, ativar a opção «Inferir tipos» permite converter 123 num número, «true» e «false» em valores booleanos e «null» em «null».No caso de dados em que os zeros à esquerda são importantes — como códigos de produto ou códigos postais —, os valores devem ser mantidos como cadeias de caracteres; por isso, recomenda-se desativar a inferência de tipos nesses casos.

Os delimitadores CSV suportam não só vírgulas, mas também tabulações, ponto e vírgula e barras verticais. Se selecionar tabulações, o ficheiro pode ser utilizado como um ficheiro TSV.Se uma célula contiver vírgulas, quebras de linha ou aspas duplas, os dados são colocados entre aspas duplas de acordo com as regras padrão do CSV, e quaisquer aspas duplas dentro da célula são duplicadas durante a saída. Isto permite que o sistema processe dados que contenham texto ou descrições que, de outra forma, estariam sujeitos a corrupção devido à simples substituição de cadeias de caracteres.

O processo de conversão desta ferramenta é realizado no navegador através de JavaScript; não carrega os ficheiros JSON ou CSV introduzidos para um servidor para conversão. Mesmo ao lidar com dados de clientes ou dados internos, pode evitar o envio de dados para servidores externos. No entanto, tome precauções adicionais relativamente a dispositivos partilhados, extensões do navegador e à segurança do próprio dispositivo. Conjuntos de dados muito grandes consomem uma quantidade significativa de memória do navegador; por isso, divida os dados conforme necessário.

Principais funcionalidades

• É possível converter um conjunto de objetos JSON para CSV ou TSV.
• É possível converter ficheiros CSV e TSV numa matriz de objetos JSON.
• Suporta delimitadores como vírgula, tabulação, ponto e vírgula e barra vertical.
• Pode expandir objetos JSON aninhados em colunas com notação de pontos.
• Ao converter de CSV para JSON, o sistema consegue inferir os tipos de valores numéricos, booleanos e valores nulos.
• Pode ativar ou desativar a apresentação formatada do JSON.
• Pode copiar os resultados ou guardá-los como ficheiros CSV, TSV ou JSON.
• Os dados introduzidos são processados no navegador, em vez de serem enviados para o servidor. As conversões que exigem muitos recursos são executadas através de Web Workers, e o sistema foi concebido para minimizar as interrupções na interação do utilizador, mesmo enquanto o processamento está em curso.

Como utilizar o conversor JSON ⇔ CSV

1. Selecione o sentido de conversão entre «JSON → CSV» ou «CSV → JSON».
2. Cole os dados no campo de entrada ou selecione um ficheiro JSON, CSV ou TSV.
3. Selecione as definições necessárias, tais como o delimitador CSV, a expansão de aninhamento JSON e a inferência de tipos para valores CSV.
4. Clique em «Converter» para apresentar os resultados. Se a área de resultados estiver fora do ecrã, será automaticamente deslocada para ficar visível.
5. Revise o conteúdo e utilize «Copiar resultados» ou «Descarregar».
6. Para reduzir a carga no seu dispositivo ao trabalhar com grandes conjuntos de dados, ative o «Modo de Baixa Carga». Enquanto o processamento estiver em curso, pode utilizar a barra de progresso e o botão «Pausar Processamento».
7. Se pretender converter na direção oposta, utilize a opção «Inverter a direção da conversão» para mover o resultado para o lado da entrada e continuar a conversão.

Precauções de utilização

• A conversão de JSON para CSV destina-se a dados que podem ser convertidos para um formato tabular; não consegue representar na íntegra matrizes hierárquicas complexas.
• Quando a inferência de tipo CSV está ativada, valores como 00123 são tratados como cadeias de caracteres em vez de números, pelo que os valores que começam por zero são automaticamente tratados como cadeias de caracteres.
• Ao converter de CSV para JSON, utilize a primeira linha como nomes das colunas. Uma vez que os nomes de colunas duplicados serão substituídos pelos valores subsequentes, certifique-se de que os nomes das colunas são únicos.
• Uma vez que grandes quantidades de dados podem afetar a memória do dispositivo e o tempo de processamento, procure manter o tamanho do ficheiro abaixo dos 20 MB.

Perguntas frequentes sobre o conversor JSON ⇔ CSV

Que tipo de JSON devo introduzir para o converter para CSV?

Normalmente, introduz-se um conjunto de objetos. Mesmo um único objeto pode ser convertido numa única linha de dados CSV.

O JSON aninhado também pode ser convertido para CSV?

Sim. Se ativar a opção «Expandir JSON aninhado utilizando notação de ponto», poderá expandi-lo em nomes de colunas, tais como address.city.

O que acontece ao JSON que contém matrizes?

Os vetores dentro dos objetos são apresentados como cadeias de caracteres JSON, para que caibam numa única célula CSV. Recomendamos organizar antecipadamente a estrutura de dados multidimensionais complexos.

Os dados serão convertidos em valores numéricos durante a conversão de CSV para JSON?

Quando a inferência de tipos está ativada, os valores numéricos comuns, `true`, `false` e `null`, são convertidos para os respetivos tipos JSON. Quando desativada, todos eles são tratados como cadeias de caracteres.

Os valores com zeros à esquerda, como 00123, podem ser mantidos?

Sim. Mesmo quando a inferência de tipos está ativada, garantimos que os valores no formato inteiro com zeros à esquerda sejam armazenados como cadeias de caracteres.

Também suporta o formato TSV?

Sim. Se selecionar «Tabulação (TSV)» como delimitador, pode converter entre JSON e TSV.

É possível converter ficheiros CSV que contenham vírgulas ou quebras de linha dentro das células?

Desde que os dados estejam entre aspas duplas, de acordo com as regras do CSV, o sistema consegue analisar vírgulas, quebras de linha e aspas duplas dentro das células.

Os ficheiros JSON e CSV são enviados para o servidor?

Não. O carregamento e a conversão de ficheiros são geridos pelo JavaScript no navegador.

Posso guardar os resultados da tradução num ficheiro?

Sim. Dependendo da direção da conversão, pode descarregar ficheiros nos formatos .csv, .tsv ou .json.

Como é determinada a ordem das colunas num ficheiro CSV?

Recolher as chaves que aparecem no JSON por ordem, começando pelo primeiro objeto, e, se surgir uma nova chave, adicioná-la ao final.

A primeira linha do ficheiro CSV é obrigatória?

Ao converter de CSV para JSON, a primeira linha é utilizada como chaves JSON, pelo que é necessária uma linha de cabeçalho com os nomes das colunas.

Posso converter ficheiros Excel diretamente?

Esta ferramenta suporta ficheiros JSON, CSV e TSV. Por favor, guarde os ficheiros .xlsx como ficheiros CSV antes de os utilizar.

O que devo fazer se o navegador ficar lento ao lidar com ficheiros de grande dimensão?

Quando o Modo de Baixa Carga está ativado, o processamento é dividido em partes mais pequenas, com pausas entre elas. Além disso, uma vez que o processamento da conversão é executado num Web Worker, é menos provável que o ecrã congele, e pode interromper o processo utilizando o botão «Interromper» enquanto este estiver a decorrer.