Da planilha CSV a API JSON: por que todo valor chega como uma string

A importação que rejeitou todas as linhas — um API esperando números e booleanos e um corpo JSON cheio de "42" e "TRUE"

O esboço descreve uma importação API produzida por CSV-to-JSON, mas os conversores de sintaxe não podem executar essa ação. CSV é marcado como ilegível, nenhum par de conversão começa com CSV e a interface nunca o oferece como fonte. Uma tentativa de solicitação retorna um erro de conversão não suportada em vez de JSON adivinhado.

Esta correção é o fato central do artigo e não uma omissão a esconder. Um gerente de produto ainda pode preparar uma exportação de planilha, mas a análise e a digitação precisam de um fluxo de trabalho CSV que exponha as decisões. Escrever etapas fictícias para este painel enviaria os leitores a controles que não existem.

A importação CSV-to-JSON solicitada não pode ser executada neste painel

Os campos CSV são sequências de texto separadas e citadas em um dialeto. O arquivo não contém formatos numéricos de planilhas, tipos booleanos ou objetos aninhados. Pode nem indicar seu delimitador ou se o primeiro registro é um cabeçalho. Essas incertezas surgem antes de qualquer decisão do tipo JSON.

Um código postal com zero inicial, um identificador longo e um valor semelhante a uma data demonstram por que a coerção automática é arriscada. No entanto, “tudo é uma string” também requer uma escolha de cabeçalho e dialeto. ToolAcre recusa a operação de leitura completa em vez de implementar apenas a metade fácil e apresentá-la como confiável.

CSV carrega campos de texto, mas o leitor ainda deve escolher um dialeto e uma política de cabeçalho

A inferência de tipo troca conveniência por corrupção silenciosa. `0042` pode ser um código, `9007199254740993` excede a precisão inteira exata de JavaScript e `N/A` pode ser uma categoria literal em vez de dados ausentes. Datas e decimais específicos de localidade introduzem mais interpretações.

Os tipos corretos vêm do esquema de recebimento API e da política de importação, não da aparência superficial das células. Um fluxo de trabalho cuidadoso primeiro analisa as linhas sob regras CSV explícitas e, em seguida, converte os campos selecionados de acordo com esse contrato e relata falhas linha por linha.

Preparando a planilha — colunas consistentes, true/false, explícito, sem separadores de milhar e células vazias para valores realmente ausentes

Prepare um arquivo consistente: uma política de cabeçalho, um delimitador, cotações válidas e uma codificação documentada. Decida como as células vazias diferem das strings vazias e nulas. Use ortografia explícita de verdadeiro e falso somente se o importador os mapear dessa forma; evite separadores de milhares, a menos que o dialeto escolhido e o analisador de tipo os esperem.

Estas são recomendações para um fluxo de trabalho de importação, não recursos de conversores de sintaxe. O repositório direciona os usuários para uma ferramenta CSV porque ela pode fazer as perguntas que esta evita intencionalmente.

A preparação de CSV pertence a uma ferramenta que pergunta sobre delimitador, cotação, cabeçalhos e tipos

O resultado trabalhado com precisão de código é uma recusa. Chamar `convert` com CSV como origem e JSON como destino produz `UNSUPPORTED_CONVERSION`; a dica explica que a leitura de CSV precisa de delimitador, citações e decisões de tipo. Não há corpo parcialmente convertido para editar posteriormente.

Use o CSV Cleaner para inspecionar e reparar o arquivo e, em seguida, um importador cujas configurações correspondam ao esquema API. Se os dados já estiverem representados como registros JSON, a direção reversa suportada pode escrever CSV e expor nivelamento, ambiguidade nula e escape de fórmula.

Limite trabalhado: a solicitação não suportada e o fluxo de trabalho alternativo suportado

Vírgulas decimais geralmente acompanham registros separados por ponto e vírgula, enquanto a notação de data varia de acordo com a localidade do exportador. Um analisador que escolhe cegamente a vírgula pode dividir valores numéricos; uma estimativa de tipo pode reinterpretar o dia e o mês. A codificação de caracteres e o tratamento de BOM adicionam outro limite antes da semântica do campo.

Como esta rota não lê CSV, ela não faz nenhuma reclamação sobre como lidar com esses casos. O gravador JSON-to-CSV pode escolher vírgula, ponto e vírgula ou tabulação e, opcionalmente, adicionar um UTF-8 BOM, mas as opções de saída não são evidência de um analisador de entrada.

O que isso não cobre — estruturas aninhadas que API pode exigir, que CSV não pode expressar e devem ser montadas após a conversão

CSV não pode representar diretamente o objeto aninhado que um API pode exigir. Cabeçalhos separados por pontos podem ser uma convenção, mas não criam objetos automaticamente, a menos que o importador defina essa regra. Matrizes e registros aninhados repetidos precisam de um estágio de montagem explícito.

Um conversor de sintaxe genérico não pode inferir a estrutura do negócio a partir de uma tabela simples. Defina o esquema JSON de destino, mapeie as colunas deliberadamente e valide antes de enviar. Isso é integração de aplicativos em vez de conversão de sintaxe.

Conclusão: os tipos são sua decisão, não do conversor - e como o painel de conversores de sintaxe mostra o JSON antes de enviá-lo

Os tipos são decisões respaldadas pelo contrato receptor. A recusa de ToolAcre mantém essas decisões visíveis em vez de fabricar JSON plausível, mas arriscado. É melhor parar do que destruir zeros à esquerda ou arredondar um identificador silenciosamente.

Use conversores de sintaxe para suas nove direções listadas, incluindo JSON-to-CSV. Para CSV-to-JSON, escolha uma ferramenta que pergunte sobre dialeto, cabeçalho e tipos. A rota que falta é um limite de segurança deliberado, não um botão inacabado.

Antes de importar uma planilha real, anote as decisões que o botão ausente ocultaria: codificação, delimitador, regra de cotação, linha de cabeçalho, política de cabeçalho duplicado, significado de célula vazia e uma regra de tipo para cada campo de destino. Um leitor CSV configurado nessa lista pode produzir JSON responsável. Um conversor genérico que nunca faz essas perguntas pode parecer mais rápido, mas qualquer tempo economizado é emprestado da depuração de identificadores, datas e valores ausentes após API rejeitá-los ou interpretá-los incorretamente.