Inspecionar a tabela de origem
Comece com uma tabela CSV cujo cabeçalho é id,name,active e cujas duas linhas são 001,Ada,true e 002,Bo,false. O conversor incorporado de CSV para JSON transforma cada linha de dados em um objeto cujas chaves vêm do cabeçalho. Isso é útil para ver a estrutura, mas não presuma que ele decidiu o que os campos significam. Um identificador como 001 deve permanecer em texto; convertê-lo para o número 1 perde os zeros à frente. A palavra true pode ser um booleano em um esquema de destino ou o texto literal inserido por um usuário. Anote esses tipos de campo antes de importar.
Verifique a sintaxe CSV antes de definir os tipos
Os campos CSV podem conter vírgulas, aspas e quebras de linha quando estão entre aspas conforme o dialeto usado. Uma divisão ingênua em cada vírgula pode deslocar colunas e fazer com que um endereço ou título válido pareça dois campos. O RFC 4180 descreve um formato comum, mas as exportações reais variam em delimitador, regras de aspas, presença de cabeçalho e codificação de caracteres. Se uma planilha usa ponto e vírgula ou tabulações, selecione ou transforme esse formato deliberadamente em vez de enviá-lo a um parser que espera somente vírgulas. Verifique se cada linha tem o número esperado de campos e se os nomes dos cabeçalhos são exclusivos.
- Cabeçalho CSV + duas linhas
- JSON array: dois objetos nomeados
- Esquema da API: confirme id, active e valores ausentes
Escolha a forma de recepção
Um array JSON mantém os dois objetos de linha juntos e é conveniente para uma solicitação de lote pequeno. JSON Lines coloca um valor JSON completo em cada linha e pode ser adequado a um fluxo ou a um sistema que processa registros de forma independente. Uma string de consulta de URL é geralmente um conjunto de parâmetros curtos, não um transporte para tabelas de planilha arbitrárias. A API de destino decide qual forma é válida. O conversor de array JSON para JSON Lines muda a organização dos registros sem inventar um esquema, e a conversão de volta deve preservar os dois objetos se cada linha for JSON válido.
Resolver valores ausentes e especiais
Uma célula CSV vazia pode significar uma string vazia, um valor desconhecido ou nenhum valor; esses não são equivalentes em todas as APIs. Uma célula ativa em branco não deve se tornar automaticamente falsa. Números com vírgula decimal, datas escritas sem fuso horário e identificadores com zeros à frente precisam de manipulação explícita antes da importação. Use uma linha de teste que contenha uma vírgula em um nome entre aspas, uma célula em branco e um caractere não ASCII para ver o que o conversor preserva. Verifique os campos obrigatórios documentados da API e rejeite linhas que não podem ser representadas fielmente, em vez de adivinhar silenciosamente.
Valide a viagem de ida e volta e o destino
Após a conversão, inspecione o JSON para dois objetos, três chaves esperadas e valores com os tipos pretendidos. Converta uma cópia de volta para CSV para observar alterações nas aspas ou na ordem dos campos; uma tabela visualmente semelhante não garante bytes de origem idênticos. Envie apenas um pequeno lote de teste para uma API real quando seu esquema e autorização estiverem prontos. As ferramentas MultiVerto são executadas no navegador e ajudam a examinar a representação, mas não podem verificar um contrato de API remota ou autorizar uma importação. Mantenha a exportação original e um mapeamento escrito de cada coluna para cada campo de destino para auditoria posterior.