Converta JSON em CSV sem perder identificadores ou matrizes.
Escolha uma definição de linha, entenda colunas aninhadas e células de matriz, então concilie a exportação antes de importá-la em uma planilha.
Decida o que uma linha de saída representa.
Antes de converter JSON, nomeie a entidade que cada linha deve descrever: um cliente, ordem, evento ou outro registro. Nosso flanisher JSON-to-CSV aceita um objeto ou um conjunto de objetos de nível superior. Ele não expande automaticamente o array de linha de uma ordem em linhas separadas. Se seus ninhos de exportação registram sob uma propriedade de embalagem, selecione o array pretendido deliberadamente antes de colá-lo. Salve o JSON original e grave essa seleção. Uma tabela pode ser perfeitamente válida enquanto representa o nível errado de detalhes para o sistema de recepção, então esclareça primeiro a definição da linha.
Trace objetos aninhados em nomes de colunas.
Propriedades de objetos aninhados se tornam colunas separadas por pontos. Na demonstração integrada, um objeto de contato produz contact.city e contact.email. Rodando seus dois registros produz sete colunas: nome, contact.city, contact.email, etiquetas, notas, equilíbrio e companhia. A ordem da coluna segue a primeira aparição nos registros. Um campo descoberto no segundo registro ainda está incluído na tabela compartilhada. Reveja os cabeçalhos contra o esquema esperado do sistema receptor, caminhos de origem descritivos são úteis para inspeção, mas um mapeamento de destino separado pode ser necessário. Aplaudir não decide esse mapeamento para você.
Mantenha campos perdidos e nulos explícitos distintos.
Na demonstração, Alex não tem propriedade contact.email, então a cela está em branco. O equilíbrio de Alex é explicitamente nulo, então a tabela contém o texto nulo. Esses valores são diferentes na fonte e permanecem visivelmente diferentes nesta ferramenta. Um objeto vazio é representado como {}. Veja como o aplicativo de recepção interpreta cada convenção antes de importar. Alguns destinos esperam que uma célula vazia signifique desconhecida, enquanto outros a usam para limpar um campo. O conversor não pode inferir essa regra de negócios. Documente seu tratamento em vez de substituir silenciosamente cada branco ou nulo por zero.
Escolha uma apresentação de forma deliberada.
Mantendo matrizes como JSON coloca toda a matriz em uma célula, incluindo seus suportes e cordas citadas. As etiquetas da demonstração continuam sendo da JSON ao invés de se tornarem filas de clientes separadas. O modo de junção está disponível para itens primitivos, usando um separador vertical-bar. Essa tela é mais fácil de digitalizar mas pode ser ambígua se uma string de origem já contém o separador ou se valores vazios importam. Arranjos e objetos não são suportados no modo de junção. Use células JSON quando precisar da estrutura disponível para interpretação posterior, e inspecione o fluxo de trabalho de recepção ao invés de assumir que pode analisar essas células.
| Valor JSON | Representação CSV | Escolha para preservar |
|---|---|---|
| contact.city | Uma coluna contact.city | Evitar colisões literais com chave pontilhada. |
| Propriedade desaparecida. | Célula vazia. | Distingui-lo de nulo |
| Explícito nulo | Texto nulo | Verifique a interpretação da importação. |
| Array | Uma cela serializada ou juntada. | Sem expansão automática por item. |
| Fio de aparência numérica | Conteúdo das cordas | Importar IDs como texto |
Use este exemplo. Abre JSON para CSV com essas entradas.
Proteja os identificadores antes que os números sejam analisados.
Um identificador como 00123 deve ser uma corda JSON citada quando seus zeros principais importam. Identificadores grandes e quantias decimais exatas também precisam de manipulação deliberada. MDN documenta como os valores numéricos JSON podem perder precisão quando analisados em números JavaScript. Esta ferramenta rejeita valores inteiros inseguros, mas não promete precisão decimal arbitrária. Citar identificadores exatos ou valores na exportação original quando apropriado. Formatar um número danificado como texto após conversão não pode recuperar os dígitos de origem. Mantenha um identificador conhecido e uma quantidade representativa na amostra que você verifica antes de processar o conjunto de dados completo.
Inspecione a citação e a proteção da planilha separadamente.
O escritor CSV cita campos e duplica aspas literais. Uma nota contendo uma vírgula ou uma nova linha deve, portanto, permanecer uma célula quando um leitor compatível a analisa. RFC 4180 descreve CSV comum citando convenções. A proteção da fórmula da planilha é uma transformação de conteúdo separada: a ferramenta adiciona um apóstrofo a células suspeitas, incluindo valores negativos e títulos relevantes. A OWASP documenta o risco de texto tipo fórmula ser interpretado por um software de planilha. Reveja a pré-visualização e exportação protegida. A proteção muda a cadeia de saída, então pode ser inadequada para um sistema que espera um valor original exato.
Converta delimitadores com um analisador e reconcilie identidades.
Se o destino requer pontos e vírgulas ou guias, escolha esse separador diretamente ou use o conversor de delimitador CSV após achatar. Não substituam globalmente vírgulas: algumas pertencem a valores internos. Para reconciliação, extraia as colunas identificadoras de origem e destino em duas listas de um item por linha e use Compare duas listas. Selecione a sensibilidade do caso e o espaço em branco lidando conscientemente. Suas duplicatas de colapso, enquanto a tabela de auditoria mantém a contagem de ocorrências. Uma contagem de fósforos sozinho não pode verificar os valores de cada linha ou ordem. Compare alguns registros completos, bem como os conjuntos identificadores antes de tratar a importação como reconciliada.
Lidar com colisões e verificar a importação de recepção
Uma chave literal chamada contact.city pode colidir com o caminho criado por um objeto de contato aninhado. O flasher rejeita colisões ambíguas de ponto-caminho em vez de escolher um valor. Renomeie chaves conflitantes ou mapeie-as explicitamente no fluxo de trabalho de origem. Comece com uma pequena amostra representativa contendo valores em falta, arrays, notas citadas e identificadores importantes. Importá- la usando o delimitador e tipos de colunas pretendidos, então compare- a com o JSON original. Uma vez que ele se comporte corretamente, registre as configurações para a conversão completa. Uma análise bem- sucedida prova que a estrutura da exportação é legível; não estabelece que os dados subjacentes estão corretos.