happytails.ai
Português

Mapeador de migrações de enumerações de API

Associe os valores de uma enumeração antiga a uma nova e identifique valores sem correspondência, removidos ou novos. Compatível com JSON Schema, OpenAPI, GraphQL, protobuf e listas simples.

Aceita até 200 000 caracteres por definição e 10 000 valores por enumeração. As associações são calculadas no seu navegador. Transferências: dois ficheiros CSV e um relatório JSON. JSON Schema, OpenAPI, enumeração GraphQL, enumeração .proto ou um valor por linha. Até 200 000 caracteres. Reveja as definições antes de executar.

Seu resultado

Comunica um problema ou partilha uma ideia.

Mapeador de migrações de enumerações de API
  1. Cole a definição da enumeração antiga.
  2. Cole a nova definição e escolha como associar os valores.
  3. Adicione associações manuais confirmadas para valores cujo nome mudou.
  4. Execute o mapeamento e transfira o CSV from,to e a tabela de revisão.

O que esperar

Aceita até 200 000 caracteres por definição e 10 000 valores por enumeração. As associações são calculadas no seu navegador. Transferências: dois ficheiros CSV e um relatório JSON.

Associações

Valores idênticos do mesmo tipo JSON são associados de forma exata. A associação normalizada também ignora maiúsculas, espaços, hífenes e sublinhados, preservando a restante pontuação e os caracteres Unicode. Se dois valores novos puderem corresponder, o valor antigo é marcado como ambíguo em vez de se adivinhar uma associação. Valores distintos da mesma enumeração com texto CSV idêntico, como 1 e "1", são rejeitados porque um ficheiro de migração com duas colunas não os distingue. As associações manuais introduzidas como CSV from,to têm prioridade; um to vazio assinala um valor removido.

Onde se encontram as enumerações

Em JSON ou YAML, a ferramenta utiliza o único array enum do documento ou o indicado pelo seu JSON Pointer. Em GraphQL SDL e ficheiros .proto, utiliza a única enumeração ou a que indicar pelo nome. Uma lista simples contém um valor por linha.

Utilizar o resultado

O CSV from,to contém apenas valores associados, prontos para Mapeador de valores de dados. O CSV de revisão lista cada valor antigo com o seu estado e cada valor novo a que nenhum valor antigo foi associado. A ferramenta cria o mapa; não altera os seus dados.