CSV ou JSON? Escolha o formato certo para o próximo passo.

As mesmas informações, duas formas diferentes

CSV e JSON são formatos de texto simples. Você pode abri-los em um editor de texto, enviá-los entre aplicativos e armazenar dados úteis neles. A diferença está em como descrevem esses dados.

CSV representa uma tabela: cada registro é uma linha e vírgulas separam as células. Uma linha de cabeçalho geralmente dá nome às colunas. JSON pode representar objetos, listas, strings, números, booleanos e null, com estruturas aninhadas quando necessário.

name,company
Alex,Studio North
Sam,Orbit

[
  {"name": "Alex", "company": "Studio North"},
  {"name": "Sam", "company": "Orbit"}
]

Estes exemplos contêm os mesmos dois registros. Nenhum formato é mais preciso por natureza; a escolha certa depende do próximo sistema que vai ler os dados.

Escolha CSV para uma tabela simples

CSV é uma opção prática para listas de contatos, exportações de pesquisa e relatórios simples com as mesmas colunas em cada linha. Tem amplo suporte em planilhas e ferramentas de importação e é fácil de conferir visualmente.

A simplicidade tem uma contrapartida: CSV não define tipos de dados. O aplicativo que recebe decide se um valor é texto, número ou data. Isso pode transformar um código como 00123 em 123, a menos que você importe a coluna como texto.

Vírgulas dentro dos valores também precisam de tratamento especial. Uma empresa chamada North, Inc. deve ficar em uma célula entre aspas. Aspas dentro de um valor entre aspas são duplicadas. Um conversor adequado faz isso por você.

Escolha JSON para dados estruturados

JSON é útil quando um registro tem campos opcionais, uma lista de tags ou um endereço aninhado. Um objeto pode preservar essas relações sem forçar tudo em uma tabela retangular.

Também é um formato comum para dados de webhooks e APIs de aplicativos. Sempre confira o esquema esperado pelo sistema de destino: um JSON válido não tem necessariamente a estrutura aceita por uma integração.

Ao mapear CSV para JSON, decida quais colunas devem continuar como strings e quais devem virar números ou booleanos. Mantenha identificadores como strings para preservar sua representação original.

Converta pensando no destino

Para converter um array JSON em CSV, escolha primeiro um conjunto fixo de colunas. Decida como tratar campos ausentes, valores null e objetos aninhados. Um endereço aninhado pode precisar de colunas separadas, enquanto uma lista pode exigir uma tabela própria.

Isso é útil para examinar registros de API, mas a conversão de ida e volta não é sem perdas. Voltar para JSON não recria os tipos originais nem distingue um campo ausente de null. Guarde o arquivo original se puder precisar da estrutura completa depois.

Se a fonte for uma página web, o WebAct pode ajudar a extrair as informações visíveis para um arquivo. Integrações pagas também podem enviar o resultado de uma tarefa concluída ao seu fluxo por webhook. Confira o resultado e o esquema de destino antes de conectá-lo a uma ação seguinte.