Confira se as linhas podem formar uma tabela
JSONL, também chamado de JSON Lines, guarda um valor JSON válido em cada linha. Para abrir os dados em uma planilha, cada valor deve preferencialmente ser um objeto que represente um registro, com chaves adequadas para nomes de coluna. Nosso exemplo contém dois registros com id, name e amount. O primeiro nome inclui uma vírgula, o segundo usa um caractere acentuado e o segundo valor de amount é null. Esses detalhes expõem problemas que uma amostra formada só por palavras simples esconderia. Examine algumas linhas antes de converter uma exportação grande. Se houver arrays, números isolados ou objetos aninhados em parte do arquivo, defina primeiro como tratá-los. Uma tabela CSV simples não preserva qualquer estrutura JSON. Guarde uma cópia do JSONL original para conferir o resultado depois.
Reúna os registros e depois crie o CSV
Cole o exemplo na ferramenta incorporada de JSON Lines para array. A saída deve ser um único array JSON com exatamente dois objetos na ordem original. Copie o array inteiro para a ferramenta de JSON para CSV indicada abaixo. Essa segunda etapa cria o cabeçalho id,name,amount e duas linhas de dados. O campo Ana, Ltd recebe aspas porque a vírgula faz parte do nome; separar a linha em todas as vírgulas deslocaria as colunas. O MultiVerto reúne as chaves encontradas nos registros para definir as colunas. Se um registro posterior trouxer outra chave, surgirá uma nova coluna e as células ausentes nas linhas anteriores ficarão vazias. Verifique o cabeçalho em vez de presumir que todos os registros tinham o mesmo esquema. Uma linha em branco no meio do JSONL ou uma aspa ausente indica erro de entrada.
- JSONL: um objeto por linha
- Array JSON: dois objetos reunidos
- CSV: cabeçalho e campos entre aspas
- Excel: conferir tipos e número de linhas
Defina o significado de células vazias e tipos
CSV contém campos de texto, não os tipos de dados do JSON. A string "001" vira a célula 001, o número 12.5 vira 12.5 e null vira uma célula vazia. Uma propriedade amount inexistente também criaria uma célula vazia; uma string realmente vazia pode parecer igual. Só com o CSV, não é possível recuperar a diferença. Se ela for importante, acrescente antes da exportação uma coluna de estado ou adote um marcador documentado. O conversor rejeita objetos e arrays aninhados, pois uma célula CSV comum não possui representação universal para essas estruturas. Distribua esses valores em colunas com nomes definidos ou mantenha JSONL quando a estrutura aninhada precisar sobreviver. Transformar um objeto em texto sem explicar a regra daria ao destinatário uma tabela potencialmente enganosa.
Importe no Excel com tipos de coluna escolhidos
Salve o CSV como arquivo de texto em UTF-8 e use Dados → De Texto/CSV no Excel. Confira o delimitador e a prévia dos caracteres para garantir que Zoë continue legível. Defina a coluna id como Texto antes de carregar: a conversão automática pode transformar 001 em 1. Identificadores longos e códigos parecidos com datas também precisam de tratamento explícito. A prévia deve mostrar três colunas e duas linhas de dados. Compare o primeiro e o último registro com o JSONL de origem. As configurações regionais podem afetar a leitura do ponto decimal e do separador, mesmo quando a sintaxe CSV está correta. Se o sistema receptor exige ponto e vírgula, faça essa adaptação como uma etapa separada e documentada. Preserve o original para distinguir uma mudança de apresentação de uma alteração nos dados de origem.
Valide as linhas e trate dados não confiáveis
Conte as linhas de entrada, os elementos do array e as linhas de dados do CSV; neste exemplo, os três totais devem ser dois. Confira se id 001 continua como texto, Ana, Ltd ocupa apenas uma célula, Zoë mantém o acento e o valor vazio de amount tem o significado esperado. A ferramenta de CSV para JSON ajuda a examinar as colunas finais, mas devolve strings e não restaura números ou null automaticamente. Se os registros vierem de usuários ou de outra fonte não confiável, examine antes da abertura as células que uma planilha pode interpretar como fórmulas. As aspas do CSV organizam os campos, mas não são uma política completa de proteção contra fórmulas. Siga as regras de importação e segurança de quem vai receber o arquivo. Para trabalhos repetidos, documente colunas, tipos, codificação e quantidade esperada de linhas.