Aplanar JSON

Relacionats

Casos d'ús

• Consultes i actualitzacions de MongoDB: utilitza claus amb punts sense escriure manualment totes les rutes imbricades
• Exportació a CSV i Excel: converteix JSON multinivell en columnes planes per a tractament tabular
• Preparació de dades per a Elasticsearch: simplifica documents molt imbricats abans d'indexar-los
• Depuració d'API: compara camps de petició i resposta en una mateixa vista plana
• Pretractament de configuració i variables d'entorn: desplega ajustos imbricats de package.json o settings.json

Com usar-ho

1. Enganxa el JSON al panell esquerre o carrega un fitxer .json local
2. Tria el mode flatten o unflatten i configura el separador, els arrays i la profunditat màxima
3. Revisa el resultat al panell dret juntament amb el nombre de claus i la profunditat
4. Copia el resultat o descarrega'l com a fitxer .json

Característiques

• Conversió en dues direccions: permet tant flatten com unflatten per moure's entre estructures imbricades i planes
• Separador personalitzat: fes servir punts, guions baixos, barres o qualsevol altre caràcter segons el sistema de destinació
• Gestió flexible d'arrays: pots expandir els elements per índex o conservar tot l'array com un sol valor
• Límit de profunditat: atura l'expansió al nivell que vulguis per evitar claus massa llargues
• Processament local segur: el JSON no s'envia al servidor, tot passa dins del navegador
• Flux de treball pràctic: admet càrrega de .json, dades d'exemple, còpia del resultat i descàrrega del fitxer

Exemples de codi

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"}

# Converteix JSON imbricat en una estructura plana amb claus separades per punts
jq '[paths(scalars) as $p | {"key": $p | join("."), "value": getpath($p)}] | from_entries' data.json

# Recupera el JSON pla com a estructura imbricada
# Fes servir jq 1.7+ amb un filtre extern o el mode unflatten d'aquesta eina

Preguntes freqients

Solució de problemes