Cómo convertir JSON anidado a CSV correctamente

Convierte JSON anidado a CSV transformando los campos de objetos anidados en columnas y decidiendo qué debe ocurrir con cada lista. Mantén una lista unida en una sola celda cuando pertenezca a un registro, o crea filas adicionales cuando cada elemento de la lista deba aparecer por separado.

Comprueba la vista previa y el número de filas antes de descargar. Un JSON muy irregular, en el que casi cada registro introduce campos nuevos, puede rechazarse antes de alcanzar el límite de tamaño porque el conversor también limita cuántas columnas de salida distintas puede crear de forma segura.

Cuándo ayuda esta guía

Esta guía es útil cuando una exportación normal de JSON produce una vista previa de CSV confusa, sobre todo si el archivo contiene datos de clientes, direcciones, líneas de pedido, etiquetas u otras listas.

La decisión principal es sencilla: algunos datos anidados pueden convertirse en columnas, mientras que las listas pueden quedarse juntas en una celda o crear filas adicionales.

Qué hace el conversor con los datos anidados

Los datos dentro de otra sección pueden convertirse en sus propias columnas. Por ejemplo, una ciudad guardada dentro de los datos del cliente puede aparecer como una columna customer.city.

Las listas requieren una elección. Si solo quieres conservar una lista como referencia, dejarla junta en una celda suele ser lo más fácil. Si cada elemento necesita su propia fila para filtrar, contar o importar, elige la opción que crea filas adicionales.

Ninguna opción es siempre mejor. La adecuada depende de lo que quieras hacer con el CSV.

Cómo convertir JSON anidado a CSV

1. 01

   Añade el archivo JSON

   Elige tu archivo .json o pega el texto JSON en la herramienta.

2. 02

   Mira la primera vista previa

   Localiza los datos anidados y las listas que importan para tu trabajo.

3. 03

   Conserva las columnas útiles

   Mantén los campos de cliente, pedido, producto u otros datos que realmente necesitas.

4. 04

   Decide qué hacer con las listas

   Mantén los valores juntos para un CSV compacto o crea filas adicionales cuando cada elemento necesite aparecer por separado.

5. 05

   Comprueba el número de filas

   Si has creado filas adicionales a partir de listas, asegúrate de que el número mayor de filas tenga sentido para los datos de origen.

6. 06

   Descarga y revisa el CSV

   Abre el resultado y comprueba algunos registros antes de importarlo o compartirlo.

• ¿Cómo protejo los identificadores con ceros iniciales? Usa la opción que conserva el texto que parece numérico antes de descargar el CSV. Así valores como 00123 siguen siendo reconocibles como texto.

Un ejemplo sencillo

Este JSON tiene una ciudad del cliente y una lista corta de artículos:

{
  "order": "10417",
  "customer": { "city": "Porto" },
  "items": ["Mug", "T-shirt"]
}

La ciudad puede convertirse en una columna propia, como customer.city. Los dos artículos pueden quedarse juntos en una celda o convertirse en filas adicionales si necesitas trabajar con cada uno por separado.

Esa es la decisión principal al trabajar con JSON anidado.

Privacidad

La conversión se realiza en tu dispositivo dentro del navegador. Tu archivo JSON no se sube a un servidor para procesarlo.

Esto resulta útil cuando la exportación contiene datos de clientes, pedidos, finanzas u otra información privada.

Límites prácticos

La página de la herramienta muestra el límite de tamaño actual definido por la configuración publicada.

Los archivos anidados grandes pueden tardar más y necesitar más memoria. Crear filas adicionales a partir de listas grandes también puede hacer que el CSV sea mucho mayor de lo que esperabas al principio.

Comprueba siempre la vista previa y el número de filas antes de descargar. Si un archivo grande da problemas en tu dispositivo, usa una exportación más pequeña o divide los datos de origen en varios archivos.

Resultado

El CSV terminado debe ser fácil de leer y encajar con la forma en que piensas usar los datos. Los datos anidados se convierten en columnas útiles y las listas se mantienen juntas o crean filas adicionales según tu elección.

{
  "id": 1042,
  "name": "Alex",
  "address": { "city": "Berlin" }
}