happytails.ai
繁體中文

API 列舉遷移對應工具

將舊列舉值對應至新列舉,並查看哪些值未對應、已刪除或新增。支援 JSON Schema、OpenAPI、GraphQL、protobuf 和一般清單。

每個定義最多 200,000 個字元,每個列舉最多 10,000 個值。比對在瀏覽器中完成。可下載兩個 CSV 檔案和一份 JSON 報告。 JSON Schema、OpenAPI、GraphQL 列舉、.proto 列舉,或每行一個值。 最多 200,000 個字元。 執行前請檢查設定。

處理結果

回報問題或分享想法。

API 列舉遷移對應工具
  1. 貼上舊列舉定義。
  2. 貼上新的列舉定義,並選擇值比對方式。
  3. 為已重新命名的值新增已確認的覆寫對應。
  4. 執行對應並下載 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 會列出每個舊值及其狀態,也會列出沒有任何對應的新值。工具只建立對應,不會變更資料。