Elysia Tools
Navegación
Workflow Playbook
Obtén un borrador revisable de JSON Schema a partir de muestras JSON representativas o filas XLSX, y revisa tipos, obligatoriedad, nulos y valores atípicos antes de usarlo como contrato.
Temas
La inferencia resulta útil cuando el contrato formal está incompleto, pero la forma de los datos ya existe. Reúne varios registros JSON o filas de una hoja con variación real: campos ausentes, nulos, valores vacíos, límites y anomalías conocidas. Conserva los archivos y el rango exacto junto al borrador.
Usa json-schema-generator para ejemplos JSON y xlsx-sheet-to-json-schema para encabezados y filas de una hoja. Si ambas fuentes representan el mismo objeto, genera borradores comparables; ningún formato debe convertirse automáticamente en la fuente de verdad.
Que un campo aparezca siempre no lo vuelve obligatorio, y un valor que parece numérico puede ser un identificador. Revisa tipo, obligatoriedad, nulabilidad, candidatos de enum, formato de fecha, unidades y valores raros. Las celdas vacías y los tipos JSON mezclados merecen notas propias.
El resultado aceptable es un borrador revisable con evidencia y supuestos explícitos. Después de aprobarlo puede alimentar json-validate o json-to-typed-code-generators; antes de eso solo describe datos observados y no sustituye el contrato de negocio.
Guía de flujo de trabajo
Separa los registros representativos de las anomalías aisladas, anota los archivos JSON o la hoja y rango de muestra, y conserva las entradas originales antes de inferir.
Ejecuta la rama JSON con más de un ejemplo significativo y guarda el borrador junto con las muestras, los tipos observados y cualquier edición manual del schema.
Deriva nombres de propiedades, tipos primitivos, comportamiento nullable, candidatos de enum y restricciones básicas desde encabezados y filas XLSX; anota celdas vacías y problemas de formato.
Compara las salidas campo por campo, vuelve a ejecutar la inferencia después de cambios deliberados y registra tipos, obligatoriedad, nulos y atípicos antes de pasarlo a validación o generación de modelos.
Usa json-schema-generator para ejemplos JSON y xlsx-sheet-to-json-schema para encabezados y filas de una hoja. Si ambas fuentes describen el mismo objeto, conserva los dos borradores y explica las diferencias en vez de elegir uno en silencio.
No. La frecuencia observada no es una regla de negocio. Comprueba registros opcionales, columnas ausentes, celdas vacías y expectativas del productor antes de marcarlo como requerido.
Mantén el resultado como borrador hasta revisar tipos, nulabilidad, candidatos de enum, restricciones y valores atípicos frente a entradas representativas, con los supuestos documentados.