Etykiety, pola i wybory przechodzą przez konkretne stany na każdym etapie życia. Dodatkowo etykiety mogą mieć różne wersje. Poniższy diagram przedstawia cykl życia etykiety z uwzględnieniem poprawek:
- Utwórz etykietę (
create()
) – etykieta zostanie utworzona i zapisana w bazie danych jakorevision_id=1
. Stan etykiety toUNPUBLISHED_DRAFT
. W takim stanie:- Użytkownicy nie mogą wyświetlać etykiety
- Użytkownicy nie mogą stosować 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 wersja etykiety jest zwiększana. - Opublikuj etykietę (
publish()
) – etykieta ma stanPUBLISHED
, a użytkownicy mogą ją stosować. Opublikowanie etykiety powoduje zwiększenie jej wersji. - (Opcjonalnie) Zaktualizuj etykietę, pole lub wybór (
delta()
) – etykieta, pole lub wybór zostaną zaktualizowane i zapisane w bazie danych jako etykieta robocza. Etykieta ma stanPUBLISHED
z atrybutemhasUnpublishedChanges=true
, co oznacza, że istnieją zmiany w wersji roboczej, ale użytkownicy nie mają do nich dostępu. 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ą stosować. Opublikowanie etykiety powoduje zwiększenie jej wersji. - Wyłącz etykietę (
disable()
) – etykieta ma stanDISABLED
, chociaż użytkownicy mogą ją stosować za pomocą interfejsu API. Wyłączona etykieta nie będzie jednak widoczna w interfejsie użytkownika, dopóki jej nie skonfigurujesz. Wycofywanie etykiety powoduje zwiększenie jej wersji. - Włącz etykietę (
enable()
) – etykieta zostanie zwrócona do stanuPUBLISHED
, a użytkownicy będą mogli ją zastosować. Opublikowanie etykiety powoduje zwiększenie jej wersji. - Usunąć etykietę (
delete()
) – etykieta ma stanDELETED
i nie można jej zastosować. Usunięte etykiety są ostatecznie trwale usuwane.
Ważne jest, aby podkreślić, że każda aktualizacja etykiety zwiększa jej wersję. Jeśli etykieta została już opublikowana, opublikowanie jej ponownie po n zmianach oznacza, że numer opublikowanej wersji to wersja + n i 1 liczba kolejnych aktualizacji.