標籤生命週期

標籤、領域和選項在生活中會經歷特定狀態。 此外，標籤也可能有不同的修訂版本。下圖顯示 標籤的生命週期，包括修訂版本

標籤生命週期圖表。
圖 3. 標籤的生命週期
  1. 建立標籤 (create())：建立標籤並儲存在 revision_id=1 格式。標籤的狀態為 UNPUBLISHED_DRAFT。 處於這個狀態時：
    • 使用者無法查看標籤
    • 使用者無法將標籤套用至雲端硬碟項目。
  2. (選用) 更新標籤、欄位或選項 (delta()) - 每次更新 會將標籤儲存在資料庫中 就必須遞增
  3. 發布標籤 (publish()) - 標籤的狀態為 PUBLISHED。 使用者才能套用標籤發布標籤會遞增修訂版本。
  4. (選用) 更新標籤、欄位或選項 (delta())：標籤、 或選項更新後，就會以草稿標籤的形式儲存在資料庫中。 標籤的狀態為 PUBLISHED，hasUnpublishedChanges=true 代表意義 有草稿變更，但使用者無法存取。每次更新 遞增標籤修訂版本。
  5. (選用) 發布標籤 (publish())：如果有的話，就是最新的 已發布草稿。標籤的狀態為 PUBLISHED，使用者可以 並套用標籤發布標籤會遞增版本。
  6. 停用標籤 (disable())：標籤處於 DISABLED 狀態 但使用者可以透過 API 套用標籤但停用的標籤 不會顯示在 UI 中。淘汰標籤 遞增修訂版本。
  7. 啟用標籤 (enable())：標籤會回傳至 PUBLISHED 狀態 以便使用者套用標籤發布標籤會遞增修訂版本。
  8. 刪除標籤 (delete()) - 標籤的狀態為 DELETED。 無法套用系統最終會清除已刪除的標籤。

請特別注意，每次更新標籤都會 修訂版本。如果標籤已發布 n 次更新後，代表其發布的修訂版本編號為 n + 1 鍵