标签生命周期

标签、字段和选项在生活中会经历特定状态。 此外,标签可能有不同的修订版本。下图显示了 标签生命周期(包括修订):

标签生命周期图。
图 3. 标签的生命周期
<ph type="x-smartling-placeholder">
    </ph>
  1. 创建标签 (create()) - 创建标签并将其存储在 数据库为 revision_id=1。标签的状态为 UNPUBLISHED_DRAFT。 在此状态下: <ph type="x-smartling-placeholder">
      </ph>
    • 用户无法查看标签
    • 用户无法将标签应用于云端硬盘内容。
  2. (可选)更新标签、字段或选择 (delta()):每次更新时, 就存储在数据库中,而标签的 修订版本
  3. 发布标签 (publish()) - 标签的状态为 PUBLISHED 用户可以应用标签发布标签将递增其修订版本。
  4. (可选)更新标签、字段或选择 (delta()):标签、 字段,或者选项被更新并作为草稿标签存储在数据库中。通过 标签的状态为 PUBLISHED,表示 hasUnpublishedChanges=true 存在草稿更改,但用户无法查看这些更改。每次更新 递增标签的修订版本。
  5. (可选)发布标签(publish()- 最新的标签(如果有) 草稿已发布。标签的状态为“PUBLISHED”,用户可以 应用标签。发布标签会递增其版本。
  6. 停用标签 (disable()) - 标签的状态为 DISABLED 但用户也可以通过 API 应用标签但是,停用标签 不会在界面中显示,除非将其配置为显示。弃用该标签 递增其修订版本。
  7. 启用标签 (enable()) - 标签会恢复为 PUBLISHED 状态 用户可以应用此标签发布标签将递增其修订版本。
  8. 删除标签 (delete()) - 标签的状态为 DELETED 无法应用。已删除的标签最终会被完全清除。

请务必强调,每次更新标签都会使该标签的 修订版本如果该标签已发布,可再次发布 “n”之后的更新表示其已发布的修订版本号是“修订版本 + n + 1” 连续更新的次数。