Etykiety, pola i wybory przechodzą przez życie przez określone stany. Poza tym etykiety mogą mieć różne wersje. Na diagramie poniżej widać cykl życia etykiet, w tym ich sprawdzanie:
- Utwórz etykietę (
create()
) – etykieta zostanie utworzona i zapisana w bazie danych 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) Zaktualizuj etykietę, pole lub wybór (
delta()
) – każda aktualizacja, nawet przed jej opublikowaniem, jest przechowywana w bazie danych, a liczba wersji etykiety zwiększa się. - Opublikuj etykietę (
publish()
) – etykieta ma stanPUBLISHED
, a użytkownicy mogą ją zastosować. Opublikowanie etykiety zwiększa jej wersję. - (Opcjonalnie) Zaktualizuj etykietę, pole lub opcję (
delta()
) – etykieta, pole lub wybór zostaną zaktualizowane i zapisane w bazie danych jako etykieta robocza. Etykieta ma stanPUBLISHED
, gdziehasUnpublishedChanges=true
oznacza, że występują 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 ta opcja jest dostępna, zostanie opublikowana najnowsza wersja robocza. Etykieta ma stanPUBLISHED
, a użytkownicy mogą ją zastosować. Opublikowanie etykiety powoduje zwiększenie jej wersji. - Wyłącz etykietę (
disable()
) – etykieta ma stanDISABLED
, ale użytkownicy mogą ją stosować za pomocą interfejsu API. Jednak wyłączona etykieta nie jest widoczna w interfejsie, jeśli nie została skonfigurowana tak, aby była widoczna. Wycofanie etykiety powoduje zwiększenie liczby jej wersji. - Włącz etykietę (
enable()
) – etykieta zostanie zwrócona do stanuPUBLISHED
, a użytkownicy będą mogli ją zastosować. Opublikowanie etykiety zwiększa jej wersję. - Usuń etykietę (
delete()
) – etykieta ma stanDELETED
i nie można jej zastosować. Usunięte etykiety są ostatecznie trwale usuwane.
Należy podkreślić, że każda aktualizacja etykiety zwiększa jej wersję. Jeśli etykieta została już opublikowana, ponowne opublikowanie jej po zaktualizowaniu n oznacza, że numer opublikowanej wersji to wersja + n + 1 liczba kolejnych aktualizacji.