JSON Flatten

Relacionado

Casos de uso

• Consultas y agregaciones en MongoDB: convierte JSON anidado en estructuras planas con notación de puntos y utilízalas directamente en consultas find, sentencias update y pipelines de agregación, sin escribir rutas a mano
• Exportación a CSV/Excel: tras aplanar objetos anidados de varios niveles, usa las claves con notación de puntos como encabezados al importar en un DataFrame de Pandas o en Excel, con un registro por fila
• Indexación en Elasticsearch: los documentos planos se almacenan y consultan mejor en motores de búsqueda; expande los campos de matrices anidadas en pares clave-valor de un solo nivel
• Depuración de APIs: compara lado a lado las estructuras anidadas de solicitudes y respuestas; los nombres de campo aplanados son más intuitivos y facilitan detectar campos faltantes o errores de tipo
• Preprocesamiento de archivos de configuración: convierte configuraciones anidadas como package.json o settings.json en forma de variables de entorno, listas para inyectar en contenedores Docker o pipelines CI
• Registros y monitorización: aplana eventos de log profundamente anidados antes de cargarlos en un almacén de datos para poder agregarlos y visualizarlos por campo

Cómo Usar

1. Pega el JSON que necesitas procesar en el cuadro de entrada de la izquierda, o haz clic en el botón de subir para elegir un archivo .json local. También puedes pulsar el botón de Muestra para cargar un ejemplo anidado predefinido
2. Cambia entre los modos Aplanar y Desaplanar en la barra de herramientas y, en el panel de opciones inferior, define el separador, el manejo de matrices y la profundidad máxima de expansión
3. La herramienta procesa en tiempo real de forma automática; el panel de la derecha muestra al instante el resultado junto con el conteo de claves y la profundidad máxima
4. Pulsa Copiar para enviar el resultado al portapapeles o Descargar para guardarlo como archivo .json en tu dispositivo

Características

• Conversión bidireccional: soporta aplanar y desaplanar JSON, alternando entre estructura anidada y plana sin pérdida
• Separadores personalizados: el valor por defecto es el punto, pero puedes cambiar a guion bajo, barra, doble guion bajo o cualquier carácter para adaptarte a distintos sistemas
• Manejo configurable de matrices: expande las matrices en claves indexadas (p. ej. items.0, items.1) o las conserva como un único valor, cubriendo tanto flujos tabulares como de configuración
• Límite de profundidad máxima: limita la profundidad de expansión para evitar claves excesivamente largas en estructuras profundamente anidadas
• Estadísticas en tiempo real: tras el procesamiento, muestra al instante el número total de claves y la profundidad máxima para evaluar el tamaño de salida
• Procesamiento local con privacidad: todo el análisis y la conversión ocurren en el navegador; los datos JSON no se suben a ningún servidor, ideal para APIs sensibles y configuraciones de producción
• Carga de archivo y datos de muestra: sube un archivo .json o carga los datos de muestra integrados con un solo clic para verificar rápidamente la conversión
• Copiar y descargar: copia el resultado al portapapeles o descárgalo como archivo .json estándar con un solo clic para procesamientos posteriores

Ejemplos de Código

function flatten(obj, prefix = '', sep = '.') {
  return Object.entries(obj).reduce((acc, [key, value]) => {
    const newKey = prefix ? `${prefix}${sep}${key}` : key;
    if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
      Object.assign(acc, flatten(value, newKey, sep));
    } else {
      acc[newKey] = value;
    }
    return acc;
  }, {});
}

flatten({ user: { name: 'Alice', contact: { email: 'a@x.com' } } });
// => { 'user.name': 'Alice', 'user.contact.email': 'a@x.com' }

def flatten(obj, parent_key='', sep='.'):
    items = {}
    for key, value in obj.items():
        new_key = f"{parent_key}{sep}{key}" if parent_key else key
        if isinstance(value, dict):
            items.update(flatten(value, new_key, sep))
        else:
            items[new_key] = value
    return items

import json
print(json.dumps(flatten({'user': {'name': 'Alice'}}), indent=2))
# => {"user.name": "Alice"}

# Convertir JSON anidado en estructura plana con notación de puntos
jq '[paths(scalars) as $p | {"key": $p | join("."), "value": getpath($p)}] | from_entries' data.json

# Reconstruir JSON anidado a partir de uno plano
# Usa jq 1.7+ con un filtro de terceros, o directamente el modo Desaplanar de esta herramienta.

Preguntas Frecuentes

Solución de problemas