API Enum 移行マッパー
古い enum の値を新しい enum に対応付け、未対応、削除、新規の値を確認します。JSON Schema、OpenAPI、GraphQL、protobuf、通常のリストに対応します。
定義ごとに最大 200,000 文字、enum 値は最大 10,000 個を受け付けます。照合はブラウザー内で行われます。CSV ファイル二つと JSON レポートをダウンロードできます。 JSON Schema、OpenAPI、GraphQL enum、.proto enum、または一行に一つの値。 最大200,000文字。 実行前に設定を確認してください。
処理結果
API Enum 移行マッパー
- 古い enum 定義を貼り付けます。
- 新しい enum 定義を貼り付け、値の照合方法を選択します。
- 名前が変更された値に、確認済みの上書きを追加してください。
- マッピングを実行し、from,to CSV と確認用テーブルをダウンロードします。
できること・制限
定義ごとに最大 200,000 文字、enum 値は最大 10,000 個を受け付けます。照合はブラウザー内で行われます。CSV ファイル二つと JSON レポートをダウンロードできます。
照合
同じ JSON 型の同一値はそのまま対応付けられます。正規化照合では大文字小文字、空白、ハイフン、アンダースコアを無視しますが、その他の句読点と Unicode 文字は保持します。新しい値二つが一致し得る場合、推測せず古い値を曖昧として示します。1 と "1" のように同じ CSV 表記になる一つの enum 内の異なる値は、二列の移行ファイルでは区別できないため拒否されます。from,to CSV で指定した上書きが優先されます。to を空にすると値は削除済みとして扱われます。
enum の検索場所
JSON または YAML では、ドキュメント内の唯一の enum 配列、または JSON Pointer で指定した配列を使います。GraphQL SDL と .proto ファイルでは、唯一の enum または指定した enum を使います。通常のリストでは一行に一つの値を指定します。
結果の使用
from,to CSV にはマッピング済みの値だけが含まれ、Dataset value mapper ですぐに使えます。確認用 CSV には各古い値とその状態、および何も対応しない新しい値がすべて記載されます。このツールはマップを作成しますが、データは変更しません。