标签、字段和选项在生活中会经历特定状态。 此外,标签可能有不同的修订版本。下图显示了 标签生命周期(包括修订):
<ph type="x-smartling-placeholder">- </ph>
- 创建标签 (
create()
) - 创建标签并将其存储在 数据库为revision_id=1
。标签的状态为UNPUBLISHED_DRAFT
。 在此状态下: <ph type="x-smartling-placeholder">- </ph>
- 用户无法查看标签
- 用户无法将标签应用于云端硬盘内容。
- (可选)更新标签、字段或选择 (
delta()
):每次更新时, 就存储在数据库中,而标签的 修订版本 - 发布标签 (
publish()
) - 标签的状态为PUBLISHED
用户可以应用标签发布标签将递增其修订版本。 - (可选)更新标签、字段或选择 (
delta()
):标签、 字段,或者选项被更新并作为草稿标签存储在数据库中。通过 标签的状态为PUBLISHED
,表示hasUnpublishedChanges=true
存在草稿更改,但用户无法查看这些更改。每次更新 递增标签的修订版本。 - (可选)发布标签(
publish()
)- 最新的标签(如果有) 草稿已发布。标签的状态为“PUBLISHED
”,用户可以 应用标签。发布标签会递增其版本。 - 停用标签 (
disable()
) - 标签的状态为DISABLED
但用户也可以通过 API 应用标签但是,停用标签 不会在界面中显示,除非将其配置为显示。弃用该标签 递增其修订版本。 - 启用标签 (
enable()
) - 标签会恢复为PUBLISHED
状态 用户可以应用此标签发布标签将递增其修订版本。 - 删除标签 (
delete()
) - 标签的状态为DELETED
无法应用。已删除的标签最终会被完全清除。
请务必强调,每次更新标签都会使该标签的 修订版本如果该标签已发布,可再次发布 “n”之后的更新表示其已发布的修订版本号是“修订版本 + n + 1” 连续更新的次数。