Convertir JSON anidado en CSV sin perder identificadores o arrays
Elige una definición de hilera, comprende columnas anidadas y células de matriz, y luego reconcilia la exportación antes de importarla en una hoja de cálculo.
Decide lo que representa una fila de salida
Antes de convertir JSON, nombre la entidad cada fila debe describir: un cliente, orden, evento u otro registro. Nuestro JSON-to-CSV flattener acepta un objeto o una gama de objetos de alto nivel. No expande automáticamente la matriz de un orden en filas separadas. Si sus nidos de exportación registran bajo una propiedad de envoltura, seleccione el array deseado deliberadamente antes de pegarlo. Guarda el JSON original y registra esa selección. Una tabla puede ser perfectamente válida mientras representa el nivel equivocado de detalle para el sistema de recepción, así que clarifique la definición de fila primero.
Trace objetos anidados en nombres de columna
Las propiedades de objetos anidados se convierten en columnas separadas por puntos. En la demostración incorporada, un objeto de contacto produce contact.city y contact.email. Ejecutar sus dos registros produce siete columnas: nombre, contact.city, contact.email, etiquetas, nota, balance y compañía. Orden de columna sigue la primera aparición en los registros. Un campo descubierto en el segundo registro todavía está incluido en la tabla compartida. Revise los encabezados contra el esquema previsto del sistema receptor; las rutas de origen descriptivo son útiles para la inspección, pero puede ser necesario realizar una asignación de destino separada. El aplanamiento no decide que la asignación para usted.
Mantener campos perdidos y explícitamente nulos distintos
En la demostración, Alex no tiene propiedad contact.email, por lo que la célula está en blanco. El equilibrio de Alex es explícitamente nulo, por lo que la tabla contiene el texto nulo. Esos valores son diferentes en la fuente y siguen siendo visiblemente diferentes en esta herramienta. Un objeto vacío está representado como {}. Comprueba cómo la aplicación receptora interpreta cada convención antes de importar. Algunos destinos esperan que una célula vacía signifique desconocida, mientras que otros lo usan para limpiar un campo. El convertidor no puede inferir esa regla de negocio. Documente su tratamiento deseado en lugar de reemplazar silenciosamente cada blanco o nulo con cero.
Elija una presentación de array deliberadamente
Mantener arrays como JSON coloca todo el array en una celda, incluyendo sus corchetes y cadenas citadas. Las etiquetas de la demostración siguen siendo un array JSON en lugar de convertirse en filas de clientes separadas. El modo Join está disponible para elementos primitivos, utilizando un separador vertical-bar. Esa pantalla es más fácil de escanear, pero puede ser ambigua si una cadena fuente ya contiene el separador o si los valores vacíos importan. Los arrays y objetos anidados no se soportan en modo de unión. Utilice las células JSON cuando necesite la estructura disponible para la interpretación posterior, e inspeccione el flujo de trabajo recibido en lugar de asumir que puede parizar esas células.
| Valor JSON | Representación del CSV | Elección para preservar |
|---|---|---|
| contact.city | Una columna contact.city | Evite colisiones dotted-key literal |
| Falta de bienes | Celda vacía | Distinguirlo de nulo |
| Explicit null | Texto nulo | Compruebe la interpretación de las importaciones |
| Array | Una célula serializada o unida | No hay ampliación automática de fila por punto |
| cuerda de aspecto numérico | Contenido de búsqueda | Importar IDs como texto |
Use este ejemplo Abre JSON a CSV con estas entradas.
Proteger los identificadores antes de que los números sean analizados
Un identificador como 00123 debe ser una cadena JSON citada cuando sus principales ceros importan. Los identificadores grandes y cantidades decimales exactas también necesitan un manejo deliberado. MDN documenta cómo los valores numéricos JSON pueden perder precisión cuando se analizan en números JavaScript. Esta herramienta rechaza valores enteros inseguros, pero no promete precisión decimal arbitraria. Cita identificadores exactos o cantidades en la exportación original cuando sea apropiado. Formatear un número dañado como texto después de la conversión no puede recuperar los dígitos fuente. Mantenga un identificador conocido y una cantidad representativa en la muestra que verifique antes de procesar el conjunto de datos completo.
Inspeccionar la protección de la hoja de cálculo por separado
El escritor de CSV cita campos y duplica las comillas literales. Por lo tanto, una nota que contenga una coma o una nueva línea debe permanecer una célula cuando un lector competente la analiza. RFC 4180 describe convenios comunes de cita de CSV. La protección de la fórmula de hoja de cálculo es una transformación de contenido separada: la herramienta añade un apostrofe a células sospechosas, incluyendo valores negativos y encabezados pertinentes. El OWASP documenta el riesgo de que el texto de fórmula sea interpretado por el software de hoja de cálculo. Revise la vista previa y la exportación protegida. La protección cambia la cadena de salida, por lo que puede ser inadecuado para un sistema que espera un valor original exacto.
Convertir delimitadores con un analizador y reconciliar IDs
Si el destino requiere semicolons o pestañas, elija el separador directamente o utilice el convertidor de delimitador CSV después de aplanarse. No reemplace globalmente las comas: algunos pertenecen a valores interiores. Para la reconciliación, extrae las columnas identificativas de origen y destino en dos listas de un punto por línea y utilice Compare dos listas. Seleccione la sensibilidad del caso y el manejo del espacio blanco conscientemente. Sus sets colapsan duplicados, mientras que la tabla de auditoría conserva los recuentos de ocurrencia. Un conteo de coincidencias solo no puede verificar los valores o el orden de cada fila. Compare algunos registros completos, así como los conjuntos de identificadores antes de tratar la importación conciliada.
Coliciones de mano y verificar la importación receptora
Una clave literal llamada contact.city puede collide con el camino creado por un objeto de contacto anidado. El flattener rechaza las colisiones ambiguas del dot-path en lugar de elegir un valor. Renombrar claves conflictivas o mapearlas explícitamente en el flujo de trabajo de origen. Comience con una pequeña muestra representativa que contiene valores perdidos, arrays, notas citadas y identificadores importantes. Importarlo utilizando los tipos delimitador y columna deseados, luego compararlo con el original JSON. Una vez que se comporta correctamente, registre la configuración para la conversión completa. Un parse exitoso prueba que la estructura de la exportación es legible; no establece que los datos subyacentes sean correctos.