JSON a CSV: nivelando dados aninhados sem perder o significado

O problema da coluna

Duas regras tornam previsível uma conversão de JSON para CSV. Primeiro, as colunas são a união de todas as chaves em todos os registros — uma chave que aparece em apenas um objeto ainda recebe uma coluna vazia em outro lugar. Segundo, cada linha deve emitir valores na mesma ordem. Errar produz um arquivo que abre bem e fica silenciosamente desalinhado da primeira linha onde uma chave estava ausente.

Achatando objetos aninhados

A técnica convencional é a notação de ponto: `address` contendo `city` e `postcode` torna-se `address.city` e `address.postcode`. Isso mantém todos os valores visíveis e consultáveis ​​na planilha, ao custo de cabeçalhos mais longos. Estruturas profundamente aninhadas podem produzir nomes complicados, portanto, nivele um nível onde você controla os dados e deixe a ferramenta nivelar totalmente quando estiver explorando.

                {"id": 7, "customer": {"name": "Ada", "plan": "pro"}}
→ id,customer.name,customer.plan
   7,Ada,pro
              

Matrizes: a parte que achata mal

Uma matriz de escalares pode ser unida em uma célula com um separador, o que é adequado para tags e aceitável para listas curtas. Uma matriz de objetos – itens de linha de pedido, por exemplo – não pertence a uma única célula: junte-a e você não poderá somar as quantidades; indexe-o em `items.0.sku`, `items.1.sku`, e as colunas dependem de quantos itens cada pedido tinha. Quando você atinge esse caso, os dados precisam de dois arquivos CSV, um por tabela, vinculados por uma chave.

Se uma célula contiver uma vírgula, aspas ou nova linha, ela deverá ser colocada entre aspas e as aspas internas duplicadas. A saída gerada lida com isso — CSV editado manualmente geralmente não, e é por isso que as importações falham intermitentemente em linhas contendo endereços.

Fazendo o arquivo se comportar no Excel

O Excel assume a codificação do sistema, a menos que seja informado o contrário, portanto, caracteres acentuados podem corromper. Emitir UTF-8 com uma marca de ordem de bytes evita isso; sem ele, o mesmo arquivo que parece perfeito no Numbers ou no Planilhas mostra o mojibake no Excel. Também vale a pena citar identificadores numéricos longos – números de cartão, SKUs grandes – para que o Excel não os converta em notação científica.

Quando CSV é a saída errada

Se o consumidor for um programa, CSV joga fora informações de tipo e aninhamento sem nenhum benefício — JSON Linhas ou uma carga de banco de dados é melhor. CSV é para humanos com planilhas: relatórios, exportações, reconciliação. Escolhê-lo deliberadamente, e não por hábito, é metade do trabalho. O conversor YamlBox JSON para CSV é executado inteiramente no navegador, portanto, uma exportação contendo linhas de clientes nunca sai da sua máquina.