Elysia Tools
Navegação
Workflow Playbook
Gere um rascunho de JSON Schema revisável a partir de amostras JSON representativas ou linhas XLSX e confira tipos, obrigatoriedade, nulos e valores atípicos antes de tratá-lo como contrato.
Temas
A inferência ajuda quando o contrato formal está incompleto, mas o formato dos dados já pode ser observado. Reúna vários registros JSON ou linhas de planilha com variação real, incluindo campos ausentes, null, valores vazios, limites e anomalias conhecidas. Mantenha os arquivos de origem e o intervalo exato junto do rascunho.
Use json-schema-generator para exemplos JSON e xlsx-sheet-to-json-schema para cabeçalhos e linhas de uma planilha. Quando as duas fontes representam o mesmo objeto, produza rascunhos comparáveis; nenhum formato deve ser tratado automaticamente como fonte da verdade.
Um campo sempre presente não é necessariamente obrigatório, e um valor numérico pode ser um identificador. Confira tipo, obrigatoriedade, nulidade, candidatos de enum, formato de data, unidades e valores incomuns. Células vazias e tipos JSON mistos merecem notas próprias.
O resultado adequado é um rascunho revisável com evidências e hipóteses explícitas. Depois da aprovação, ele pode alimentar json-validate ou json-to-typed-code-generators; antes disso, descreve apenas os dados observados e não substitui o contrato de negócio.
Guia de fluxo de trabalho
Separe registros representativos de anomalias isoladas, anote arquivos JSON ou planilha e intervalo de amostra e preserve as entradas originais antes da inferência.
Execute o caminho JSON com vários exemplos significativos e guarde o rascunho junto com as amostras, os tipos observados e eventuais edições manuais do schema.
Derive nomes de propriedades, tipos primitivos, comportamento nullable, candidatos de enum e restrições básicas usando cabeçalho e linhas XLSX; registre células vazias e armadilhas de formatação.
Compare as saídas campo a campo, execute a inferência novamente após mudanças deliberadas e registre decisões de tipo, obrigatoriedade, nulos e atípicos antes de entregar o resultado à validação ou à geração de modelos.
Use json-schema-generator para exemplos JSON e xlsx-sheet-to-json-schema para cabeçalhos e linhas da planilha. Se as duas fontes descrevem o mesmo objeto, preserve os dois rascunhos e explique as diferenças em vez de escolher uma fonte silenciosamente.
Não. A frequência observada não é uma regra de negócio. Verifique registros opcionais, colunas ausentes, células vazias e as expectativas do produtor antes de marcar o campo como obrigatório.
Mantenha a saída como rascunho até revisar tipos, nulidade, candidatos de enum, restrições e valores atípicos com entradas representativas e hipóteses documentadas.