Categorías

XLSX Sheet a JSON Schema

Infiere JSON Schema desde encabezados y muestras

Detecta tipos, enums y restricciones basicas.

Resultados de ejemplo

1 Ejemplos

Inferir JSON Schema desde Sheet

Infere tipos, enum y restricciones desde filas

xlsx-sheet-to-json-schema-example1.json Ver archivo
Ver parámetros de entrada
{ "excelFile": "/public/samples/xlsx/workbook-sales.xlsx", "sheetName": "Sheet1", "headerRow": 1, "sampleSize": 100, "enumMaxDistinct": 10 }

Click to upload file or drag and drop file here

Maximum file size: 100MB Supported formats: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel

0 0.98 1

Datos clave

Categoría
Format Conversion
Tipos de entrada
file, text, number, range
Tipo de salida
file
Cobertura de muestras
4
API disponible
Yes

Resumen

Esta herramienta automatiza la creación de esquemas JSON a partir de archivos Excel, analizando automáticamente los encabezados y las muestras de datos para definir tipos, enumeraciones y restricciones de validación con precisión.

Cuándo usarlo

  • Cuando necesitas integrar datos de Excel en una API o base de datos que requiere un esquema JSON estricto.
  • Al migrar hojas de cálculo complejas a sistemas de desarrollo que utilizan validación de datos basada en esquemas.
  • Para estandarizar rápidamente la estructura de datos de múltiples archivos Excel sin realizar el mapeo de forma manual.

Cómo funciona

  • Carga tu archivo Excel (.xlsx o .xls) y selecciona la hoja específica que deseas procesar.
  • Define la fila de encabezado y el tamaño de la muestra para que el motor analice los tipos de datos y valores únicos.
  • Ajusta los umbrales de campos requeridos y el límite de valores para enumeraciones según tus necesidades de validación.
  • Descarga el archivo JSON Schema generado, listo para ser utilizado en tus proyectos de desarrollo.

Casos de uso

Generación automática de contratos de API basados en reportes de ventas existentes.
Validación de carga de datos masivos para aplicaciones web mediante esquemas JSON.
Documentación técnica de estructuras de datos heredadas en formato Excel.

Ejemplos

1. Estandarización de catálogo de productos

Desarrollador Backend
Contexto
El equipo de inventario entrega un Excel con miles de productos, pero el sistema requiere un JSON Schema para validar la entrada de datos.
Problema
Crear manualmente el esquema es propenso a errores y toma demasiado tiempo debido a la cantidad de columnas.
Cómo usarlo
Subir el archivo `inventario.xlsx`, configurar el umbral de requeridos al 0.99 y establecer el límite de enums para las categorías.
Configuración de ejemplo
headerRow: 1, sampleSize: 500, enumMaxDistinct: 15, requiredThreshold: 0.99
Resultado
Se obtiene un archivo JSON Schema que valida correctamente los tipos de datos, los valores permitidos en categorías y los campos obligatorios del inventario.

2. Migración de registros de clientes

Analista de Datos
Contexto
Se necesita importar una base de datos de clientes desde Excel a una base de datos NoSQL que exige un esquema definido.
Problema
Los tipos de datos en Excel son ambiguos y se requiere una estructura JSON limpia para la importación.
Cómo usarlo
Cargar el archivo, definir el título del esquema como 'Cliente' y ajustar la muestra para cubrir la diversidad de los registros.
Configuración de ejemplo
schemaTitle: 'Cliente', sampleSize: 200, enumMaxDistinct: 5
Resultado
Un esquema JSON preciso que define correctamente los campos de texto, números y las restricciones de enumeración para los estados de los clientes.

Probar con muestras

json, xml, xlsx

Hubs relacionados

Preguntas frecuentes

¿Qué formatos de archivo soporta?

La herramienta es compatible con archivos de Microsoft Excel en formatos .xlsx y .xls.

¿Cómo determina si un campo es obligatorio?

Utiliza un umbral de porcentaje (Requerido Umbral) para evaluar la presencia de datos en las filas analizadas.

¿Qué hace la opción 'Enum Máximo Distintos'?

Define el límite de valores únicos encontrados para decidir si un campo debe tratarse como un tipo 'enum' en lugar de un tipo de dato genérico.

¿Puedo elegir qué fila contiene los nombres de los campos?

Sí, puedes especificar la fila exacta mediante el parámetro 'Encabezado Fila' para asegurar que los nombres de las propiedades sean correctos.

¿Es seguro subir mis archivos?

La herramienta procesa los datos localmente para la inferencia del esquema y no almacena tus archivos de forma permanente.

Documentación de la API

Punto final de la solicitud

POST /es/api/tools/xlsx-sheet-to-json-schema

Parámetros de la solicitud

Nombre del parámetro Tipo Requerido Descripción
excelFile file (Subida requerida) -
sheetName text No -
headerRow number No -
sampleSize number No -
enumMaxDistinct number No -
requiredThreshold range No -
schemaTitle text No -

Los parámetros de tipo archivo necesitan ser subidos primero vía POST /upload/xlsx-sheet-to-json-schema para obtener filePath, luego pasar filePath al campo de archivo correspondiente.

Formato de respuesta

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
Archivo: Archivo

Documentación de MCP

Agregue este herramienta a su configuración de servidor MCP:

{
  "mcpServers": {
    "elysiatools-xlsx-sheet-to-json-schema": {
      "name": "xlsx-sheet-to-json-schema",
      "description": "Infiere JSON Schema desde encabezados y muestras",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=xlsx-sheet-to-json-schema",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Puede encadenar múltiples herramientas, por ejemplo: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máximo 20 herramientas.

Soporte para enlaces de archivos URL o codificación Base64 para parámetros de archivo.

Si encuentra algún problema, por favor, póngase en contacto con nosotros en [email protected]