Elysia Tools
Navegación
Workflow Playbook
Opere sobre la estructura JSON con registro de cada corte — inventarie las rutas de claves antes de tocar nada, direccione nodos con precisión mediante punteros RFC 6901 o con flexibilidad mediante JSONPath, renombre claves por regla y no a mano, aplique parches RFC 6902 como secuencia de operaciones auditable, y aplane para viajar con camino de regreso sin pérdidas.
Temas
La cirugía empieza por la imagen. Un documento JSON de cualquier profundidad esconde su estructura a la lectura casual — la misma clave en dos niveles significa dos cosas distintas, un array donde se esperaba un objeto rompe la regla que iba a escribir — y el inventario de claves convierte ese terreno oculto en una lista en papel. Cada ruta aparece una vez, las sorpresas afloran antes de escribir reglas contra ellas, y el inventario se vuelve la línea base de todo lo demás — regenérelo tras cada operación y la diferencia entre inventarios es el recibo honesto de esa operación.
El direccionamiento JSON viene en dos registros, y confundirlos es el impuesto clásico del principiante. El puntero — RFC 6901 — es una dirección exacta: /data/items/0/price nombra un nodo, resuelve o falla, y es el dialecto que el propio JSON Patch habla. La consulta de ruta — estilo JSONPath o JMESPath — es una búsqueda: comodines, filtros y proyecciones que devuelven conjuntos de nodos y no cuestan nada de probar. La disciplina que los mantiene ordenados es simple — explore con rutas, opere con punteros — porque una operación que nombra su objetivo con precisión es una operación cuyo resultado se puede predecir.
Editar un archivo JSON directamente produce un resultado; aplicar un parche RFC 6902 produce un resultado y un registro. El parche es una secuencia ordenada de operaciones con nombre — añadir, quitar, reemplazar, mover — cada una dirigida por un puntero, lo que lo hace legible antes de correr, revisable como diff, reejecutable en entradas frescas y archivable como pista de auditoría de qué se hizo a los datos y en qué orden. El renombrado sigue la misma lógica al nivel de claves — una regla que casa con un patrón se aplica en todas partes donde el patrón vive, y en ninguna otra — sin la edición manual número cuarenta y uno que se descubre faltante cuando las cuarenta anteriores ya parecían bien.
Las filas planas de pares clave-valor son la lengua franca de las hojas de cálculo, las herramientas de diff y la mitad del mundo de pipelines; el JSON anidado es la lengua materna de las APIs. El aplanador tiende el puente de ida — el anidamiento contraído en claves unidas por delimitador — y el deshacedor tiende el de vuelta. La garantía que importa es el viaje completo — aplanar, deshacer, comparar en profundidad contra el original, y la estructura queda probada intacta. La única precondición es la revisión de colisiones — una clave que contenga el delimitador no sobrevive al viaje, así que el separador se elige contra los nombres de clave realmente presentes, no por costumbre.
Esta página reestructura y prueba la reestructuración — no consulta valores, no convierte entre formatos, no certifica una forma. Sacar datos de JSON por consulta es cosa del flujo de extracción y transformación; formatear, validar y fusionar documentos son los chequeos de salud del flujo de utilidades; convertir JSON a YAML, CSV o BSON es el flujo de conversión; y volver una estructura en tipos TypeScript o en un schema es negocio de los flujos de código tipado e inferencia de schema. Corte aquí, verifique el viaje de ida y vuelta, y entregue el documento al vecino que posee la siguiente pregunta.
Guía de flujo de trabajo
Extraiga todas las rutas de claves del documento para que la estructura quede visible en papel antes de cualquier operación, y guarde el inventario como la línea base contra la que las verificaciones posteriores regeneran y comparan.
Fije nodos exactos con punteros RFC 6901 para objetivos quirúrgicos únicos, y explore selecciones de conjuntos con expresiones estilo JSONPath o JMESPath cuando la operación concierne a un patrón de nodos y no a una sola dirección.
Renombre claves por patrón y regla en todo el documento en vez de editar una por una, y exprese altas, bajas, reemplazos y movimientos como una secuencia de parche RFC 6902 que nombra cada objetivo con un puntero.
Contraiga el anidamiento en pares clave-valor unidos por delimitador para las herramientas que comen filas planas, y restaure la estructura anidada sin pérdidas al volver — verificando el viaje con una comparación profunda.
La edición directa sirve para arreglos de una vez que nadie revisará, mientras que un parche RFC 6902 es una secuencia ordenada de operaciones con nombre, revisable antes de correr, reejecutable en entradas parecidas y contrastable después — elija el parche siempre que el cambio deba rendir cuentas.
Un JSON Pointer nombra exactamente un nodo — /data/items/0 — y es el dialecto de direccionamiento que el propio JSON Patch usa, mientras que las expresiones estilo JSONPath y JMESPath seleccionan conjuntos con comodines y filtros — use el puntero para operar, la ruta para explorar.
El separador decide si el viaje de ida y vuelta sobrevive — el punto lee natural hasta que una clave contiene un punto, la barra espeja la sintaxis del puntero hasta que una clave contiene una barra, y un separador personalizado raro evita ambos al precio de una salida poco familiar — elija uno que sus nombres de clave no puedan contener.