Категории

XLSX Sheet в JSON Schema

Выводит JSON Schema по заголовкам и примерам

Определяет типы, enum и базовые ограничения.

Примеры результатов

1 Примеры

Вывести JSON Schema из Sheet

Определяет типы, enum и ограничения по примерам

xlsx-sheet-to-json-schema-example1.json Показать файл
Показать параметры ввода
{ "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

Ключевые факты

Категория
Format Conversion
Типы входных данных
file, text, number, range
Тип результата
file
Покрытие примерами
4
API доступен
Yes

Обзор

Инструмент для автоматической генерации JSON Schema на основе структуры вашего Excel-файла, позволяющий быстро определять типы данных, перечисления (enum) и правила валидации для интеграции с API или базами данных.

Когда использовать

  • При необходимости описать структуру данных из Excel для разработки API.
  • Когда нужно быстро создать валидатор для импортируемых табличных данных.
  • Для стандартизации форматов обмена данными между отделами компании.

Как это работает

  • Загрузите ваш файл Excel (.xlsx или .xls) в инструмент.
  • Укажите номер строки с заголовками и выберите нужный лист.
  • Настройте параметры анализа, такие как порог обязательных полей и лимит уникальных значений для enum.
  • Получите готовый JSON Schema файл, готовый к использованию в вашем проекте.

Сценарии использования

Подготовка спецификаций для разработчиков на основе бизнес-отчетов.
Автоматическая генерация схем валидации для загрузки данных в CRM или ERP.
Создание документации API для систем, работающих с табличными данными.

Примеры

1. Генерация схемы для базы клиентов

Системный аналитик
Контекст
Необходимо перенести данные клиентов из Excel в новую базу данных, для чего требуется строгая JSON-схема.
Проблема
Ручное написание схемы для 20+ столбцов занимает много времени и чревато ошибками в типах данных.
Как использовать
Загрузить файл `clients.xlsx`, установить `headerRow` на 1 и настроить `requiredThreshold` на 0.95 для учета пропусков.
Пример конфигурации
{"sheetName": "Clients", "headerRow": 1, "sampleSize": 500, "requiredThreshold": 0.95}
Результат
Получена готовая JSON Schema с определенными типами (string, integer) и списком допустимых значений для поля 'Статус'.

Проверить на примерах

json, xml, xlsx

Связанные хабы

FAQ

Какие форматы файлов поддерживаются?

Инструмент поддерживает стандартные форматы Excel: .xlsx и .xls.

Как инструмент определяет обязательные поля?

Обязательность полей определяется на основе порога заполненности (requiredThreshold) — если процент заполненных ячеек в столбце выше указанного, поле помечается как обязательное.

Что делает параметр 'Enum Макс Уникальные'?

Если количество уникальных значений в столбце меньше или равно этому числу, инструмент автоматически создаст список 'enum' в схеме.

Можно ли выбрать конкретный лист для анализа?

Да, вы можете указать имя листа в соответствующем поле настроек.

Влияет ли количество строк на точность схемы?

Да, параметр 'Пример Строки' определяет, сколько строк будет проанализировано для вывода типов данных и ограничений.

Документация API

Конечная точка запроса

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

Параметры запроса

Имя параметра Тип Обязательно Описание
excelFile file (Требуется загрузка) Да -
sheetName text Нет -
headerRow number Нет -
sampleSize number Нет -
enumMaxDistinct number Нет -
requiredThreshold range Нет -
schemaTitle text Нет -

Параметры типа файл должны быть загружены сначала через POST /upload/xlsx-sheet-to-json-schema для получения filePath, затем filePath должен быть передан в соответствующее поле файла.

Формат ответа

{
  "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)"
}
Файл: Файл

Документация MCP

Добавьте этот инструмент к конфигурации сервера MCP:

{
  "mcpServers": {
    "elysiatools-xlsx-sheet-to-json-schema": {
      "name": "xlsx-sheet-to-json-schema",
      "description": "Выводит JSON Schema по заголовкам и примерам",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=xlsx-sheet-to-json-schema",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Вы можете объединять несколько инструментов, например: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, максимум 20 инструментов.

Поддерживает ссылки на файлы URL или кодирование Base64 для параметров файла.

Если вы столкнулись с проблемами, пожалуйста, свяжитесь с нами по адресу [email protected]