Qué hace el aplanado a un documento JSON
El aplanado convierte un objeto JSON jerárquico en un mapa de un solo nivel donde cada ruta de clave original se convierte en una cadena de notación de punto. Por ejemplo, el objeto anidado {"user": {"name": "Alice", "address": {"city": "Paris"}}} se convierte en {"user.name": "Alice", "user.address.city": "Paris"}. Todos los valores hoja se preservan.
Los elementos de array se incluyen en la clave plana por su índice: {"items": ["a", "b"]} se convierte en {"items.0": "a", "items.1": "b"}. Esto permite representar el documento completo como un almacén clave-valor simple.
El aplanado es reversible: dado un mapa plano, la estructura anidada original puede reconstruirse dividiendo cada clave en el separador. La operación de des-aplanado también está disponible en esta herramienta.
Opciones de separador y casos límite
El separador predeterminado es un punto (.). Puede cambiarlo por una barra (/), guión bajo (_), doble guión bajo (__) o cualquier cadena personalizada. El punto puede causar ambigüedad cuando los nombres de clave contienen puntos.
Cuando las claves contienen el carácter separador, la herramienta ofrece dos estrategias de desambiguación: escapar el separador en los nombres de clave, o usar un separador que no aparezca en ninguna clave.
Los valores nulos y los objetos/arrays vacíos se manejan explícitamente. Un valor null se preserva tal como está. Un objeto vacío {} no produce claves. Un array vacío [] tampoco produce claves.
Casos de uso comunes
Exportar a hoja de cálculo: Los pares clave-valor planos se asignan naturalmente a una hoja de cálculo de dos columnas (clave | valor). Combinado con la herramienta JSON a CSV, el aplanado permite exportar respuestas de API profundamente anidadas a Excel.
Inyección de variables de entorno: Los sistemas de orquestación de contenedores almacenan la configuración como pares clave=valor planos. Aplanar una configuración JSON produce exactamente el formato necesario.
Diff y auditoría: Comparar dos mapas JSON planos es más sencillo que comparar árboles anidados porque los nombres de clave codifican la ruta completa.