API 列舉遷移對應工具
將舊列舉值對應至新列舉,並查看哪些值未對應、已刪除或新增。支援 JSON Schema、OpenAPI、GraphQL、protobuf 和一般清單。
尚未選擇檔案
每個定義最多 200,000 個字元,每個列舉最多 10,000 個值。比對在瀏覽器中完成。可下載兩個 CSV 檔案和一份 JSON 報告。 JSON Schema、OpenAPI、GraphQL 列舉、.proto 列舉,或每行一個值。 最多 200,000 個字元。 執行前請檢查設定。
處理結果
API 列舉遷移對應工具
- 貼上舊列舉定義。
- 貼上新的列舉定義,並選擇值比對方式。
- 為已重新命名的值新增已確認的覆寫對應。
- 執行對應並下載 from,to CSV 和檢查表。
使用須知
每個定義最多 200,000 個字元,每個列舉最多 10,000 個值。比對在瀏覽器中完成。可下載兩個 CSV 檔案和一份 JSON 報告。
比對
相同 JSON 型別的相同值會精確比對。正規化比對也會忽略字母大小寫、空格、連字號和底線,同時保留其他標點及 Unicode 字元。若兩個新值都可能符合某個舊值,系統會將該舊值標記為不明確,而不會猜測。若同一列舉中不同值的 CSV 文字相同,例如 1 和 "1",就會拒絕處理,因為雙欄遷移檔案無法區分它們。透過 from,to CSV 輸入的覆寫對應優先;to 留白表示刪除該值。
列舉的位置
對於 JSON 或 YAML,工具會使用文件中唯一的列舉陣列,或使用 JSON Pointer 指定的陣列。對於 GraphQL SDL 和 .proto 檔案,會使用唯一的列舉,或使用你指定的列舉。一般清單按每行一個值處理。
使用結果
from,to CSV 只包含已對應的值,可直接用於 Dataset value mapper。檢查用 CSV 會列出每個舊值及其狀態,也會列出沒有任何對應的新值。工具只建立對應,不會變更資料。