Elysia Tools
Навигация
Workflow Playbook
Получите проверяемый черновик JSON Schema из репрезентативных JSON-примеров или строк XLSX, а затем проверьте типы, обязательность, null и выбросы до использования схемы как контракта.
Темы
Вывод схемы полезен, когда формальный контракт неполон, но форма данных уже видна. Соберите несколько JSON-объектов или разнообразные строки таблицы, включая пропущенные поля, null, пустые значения, граничные случаи и известные аномалии. Храните исходные файлы и точный диапазон рядом с черновиком.
Для JSON-примеров используйте json-schema-generator, а для заголовков и строк листа — xlsx-sheet-to-json-schema. Если оба источника описывают один объект, подготовьте сравнимые черновики; ни один формат не становится источником истины автоматически.
Постоянное присутствие поля не означает обязательность, а число может быть идентификатором. Проверьте тип, обязательность, nullable, кандидатов enum, формат даты, единицы и необычные значения. Пустые ячейки и смешанные типы JSON требуют отдельных заметок.
Корректный результат — проверяемый черновик с источниками и явными допущениями. После утверждения он может стать входом для json-validate или json-to-typed-code-generators; до этого он описывает наблюдаемые данные, а не заменяет бизнес-контракт.
Руководство по рабочему процессу
Отделите репрезентативные записи от единичных аномалий, укажите JSON-файлы или лист и диапазон примеров и сохраните исходные данные до вывода схемы.
Запустите JSON-ветку на нескольких содержательных примерах и сохраните черновик вместе с набором примеров, наблюдаемыми типами и ручными изменениями schema.
По заголовку и репрезентативным строкам XLSX определите имена свойств, примитивные типы, nullable-поведение, кандидатов enum и базовые ограничения; отдельно отметьте пустые ячейки и ошибки форматирования.
Сравните результаты по каждому полю, повторите вывод после осознанных правок и зафиксируйте решения по типам, обязательности, null и выбросам до передачи в валидацию или генерацию моделей.
Для JSON-примеров используйте json-schema-generator, а для заголовков и строк листа — xlsx-sheet-to-json-schema. Если источники описывают один объект, сохраните оба черновика и явно разберите различия, не выбирая один молча.
Нет. Частота в примерах показывает наблюдение, а не бизнес-правило. Проверьте необязательные записи, отсутствующие колонки, пустые ячейки и ожидания производителя, прежде чем объявлять поле обязательным.
Оставляйте результат черновиком, пока типы, nullable, кандидаты enum, ограничения и выбросы не проверены на репрезентативных входах и не сопровождаются записанными допущениями.