Aplanar objeto JSON

Qué cambia la conversión

Convierte propiedades JSON anidadas en claves de rutas JSON Pointer. Recorre objetos anidados y conserva arreglos y escalares como hojas.

Ejemplo práctico

Empieza con la entrada mostrada en esta página: {"usuario":{"nombre":"Hola","mensaje":"Bienvenidos"},"activo":true}. La herramienta produce: { "/usuario/nombre": "Hola", "/usuario/mensaje": "Bienvenidos", "/activo": true }. Prueba primero el ejemplo para comparar ambas representaciones. Después sustitúyelo por tus propios datos. El resultado es texto que puedes copiar a un editor, una prueba o una solicitud solo tras comprobar que el destino espera esa misma forma.

Reglas y límites del formato

El aplanamiento usa segmentos JSON Pointer de RFC 6901 para los nombres de propiedades: una barra separa niveles, una virgulilla del nombre pasa a ~0 y una barra del nombre a ~1. Es una representación de rutas, no una compresión general de JSON. Los arreglos permanecen como hojas completas para no confundir claves numéricas con índices; también permanecen escalares y objetos vacíos. La operación inversa recibe un objeto plano cuyas claves son esas rutas, crea objetos anidados y rechaza rutas incompatibles. Un objeto raíz vacío se representa mediante una ruta vacía que contiene un objeto vacío. Esta correspondencia restringida permite prever el recorrido de ida y vuelta. Compara el resultado antes de usarlo para actualizar una base de datos: una barra de una clave debe escaparse y una ruta no puede atravesar un escalar existente.

Comprobar el resultado

Conserva el original junto al texto transformado mientras lo revisas. Compara primero un caso pequeño conocido, especialmente uno con puntuación, un carácter no ASCII, un valor repetido o un campo vacío relevante. Que el resultado sea legible no demuestra que el programa receptor acepte el mismo esquema o las mismas convenciones. Si intercambias datos entre aplicaciones, ejecuta el analizador receptor y revisa algunos registros tras importarlos. Mantén los archivos importantes bajo control de versiones para poder revertir cambios. El procesamiento ocurre en tu navegador; esta página no envía la entrada a un servidor de conversión. La memoria del navegador y el portapapeles requieren cuidado normal en dispositivos compartidos.

Origen y resultado cumplen funciones diferentes aunque se parezcan. El método anterior define el subconjunto admitido, no todas las extensiones del formato. Ante un sistema receptor estricto, prueba primero un caso pequeño conocido antes de cambiar muchos registros. Si falla la validación, vuelve al origen y al primer error comunicado; editar solo la salida generada puede ocultar la causa.

Para comprobar el recorrido completo, aplana un objeto y reconstruye las rutas generadas antes de usarlas en un parche o importación. Compara la estructura JSON recuperada, incluidos objetos vacíos, arreglos y nombres con barras o virgulillas. No edites manualmente una ruta para convertir un prefijo en valor final: la herramienta inversa rechaza rutas superpuestas o hijos bajo una hoja.