Etykiety, pola i wybory przechodzą przez życie przez określone stany. Poza tym etykiety mogą mieć różne wersje. Poniższy diagram przedstawia cykl życia etykiety, w tym zmiany:
- Utwórz etykietę (
create()
) – etykieta zostanie utworzona i zapisana w jakorevision_id=1
. Etykieta ma stanUNPUBLISHED_DRAFT
. W tym stanie:- Użytkownicy nie mogą zobaczyć etykiety
- Użytkownicy nie mogą stosować tej etykiety do elementów na Dysku.
- (Opcjonalnie) Aktualizacja etykiety, pola lub wyboru (
delta()
) – po każdej aktualizacji nawet przed jej opublikowaniem, są przechowywane w bazie danych, a etykieta wersji zwiększa się. - Opublikuj etykietę (
publish()
) – etykieta ma stanPUBLISHED
i użytkownicy mogą zastosować etykietę. Opublikowanie etykiety zwiększa jej wersję. - (Opcjonalnie) Zaktualizuj etykietę, pole lub opcję (
delta()
) – etykietę, lub wybór zostanie zaktualizowany i zapisany w bazie danych jako etykieta robocza. etykieta ma stanPUBLISHED
zhasUnpublishedChanges=true
oznaczającym pojawiają się zmiany w wersji roboczej, ale nie są one dostępne dla użytkowników. Każda aktualizacja zwiększa wersję etykiety. - (Opcjonalnie) Opublikuj etykietę (
publish()
) – jeśli jest dostępna, najbardziej aktualna wersja robocza została opublikowana. Etykieta ma stanPUBLISHED
, a użytkownicy mogą zastosować etykietę. Opublikowanie etykiety powoduje zwiększenie jej wersji. - Wyłącz etykietę (
disable()
) – etykieta ma stanDISABLED
. ale użytkownicy mogą ją stosować za pomocą interfejsu API. Wyłączona etykieta nie jest widoczna w interfejsie, jeśli nie została skonfigurowana tak, aby była wyświetlana. Wycofanie etykiety zwiększa jej wersję. - Włącz etykietę (
enable()
) – etykieta ma stanPUBLISHED
. a użytkownicy mogą ją zastosować. Opublikowanie etykiety zwiększa jej wersję. - Usuń etykietę (
delete()
) – etykieta ma stanDELETED
i nie można zastosować. Usunięte etykiety są ostatecznie trwale usuwane.
Należy pamiętać, że każda aktualizacja etykiety zwiększa jej wartość wersji. Jeśli etykieta została już opublikowana, opublikuj ją ponownie. po n aktualizacjach oznacza, że numer opublikowanej wersji to wersja + n + 1 liczby kolejnych aktualizacji.