Outil de migration des énumérations API
Faites correspondre les valeurs d’une ancienne énumération avec une nouvelle et repérez celles qui restent sans correspondance, qui ont été supprimées ou qui sont nouvelles. Compatible avec JSON Schema, OpenAPI, les énumérations GraphQL, Protobuf et les listes simples.
Accepte jusqu’à 200 000 caractères par définition et jusqu’à 10 000 valeurs par énumération. La mise en correspondance s’effectue dans votre navigateur. Les téléchargements comprennent deux fichiers CSV et un rapport JSON. Schéma JSON, OpenAPI, énumération GraphQL, énumération .proto ou une valeur par ligne. Jusqu’à 200 000 caractères. Vérifiez les réglages avant de lancer le traitement.
Votre résultat
Outil de migration des énumérations API
- Collez l’ancienne définition de l’énumération.
- Collez la nouvelle définition de l’énumération et choisissez comment faire correspondre les valeurs.
- Ajoutez les remplacements confirmés pour les valeurs renommées.
- Lancez la mise en correspondance et téléchargez le CSV from,to ainsi que le tableau de révision.
À savoir
Accepte jusqu’à 200 000 caractères par définition et jusqu’à 10 000 valeurs par énumération. La mise en correspondance s’effectue dans votre navigateur. Les téléchargements comprennent deux fichiers CSV et un rapport JSON.
Mise en correspondance
Les valeurs identiques du même type JSON sont mises en correspondance exactement. La correspondance normalisée ignore aussi la casse, les espaces, les tirets et les traits de soulignement, tout en préservant les autres signes de ponctuation et les caractères Unicode. Si deux nouvelles valeurs peuvent correspondre à une ancienne, celle-ci est marquée comme ambiguë plutôt que de faire un choix arbitraire. Les valeurs distinctes d’une même énumération qui ont le même texte CSV, par exemple 1 et "1", sont rejetées, car un fichier de migration à deux colonnes ne peut pas les distinguer. Les remplacements saisis au format CSV from,to sont prioritaires; un champ to vide marque une valeur comme supprimée.
Emplacement des énumérations
En JSON ou YAML, l’outil utilise le seul tableau d’énumération du document, ou celui désigné par votre JSON Pointer. Pour GraphQL SDL et les fichiers .proto, il utilise l’unique énumération, ou celle que vous nommez. Dans une liste simple, indiquez une valeur par ligne.
Utilisation du résultat
Le CSV from,to contient uniquement les valeurs mises en correspondance; il est prêt à être utilisé dans le Mappeur de valeurs de jeu de données. Le CSV de révision répertorie chaque ancienne valeur et son état, ainsi que chaque nouvelle valeur vers laquelle aucune ancienne valeur n’est associée. L’outil crée la table; il ne modifie pas vos données.