Cykl życia etykiet

Etykiety, pola i opcje przechodzą przez określone stany w trakcie swojego istnienia. Etykiety mogą też mieć różne wersje. Ten diagram pokazuje cykl życia etykiety, w tym jej wersje:

Diagram cyklu życia etykiet.
Rysunek 3. Cykl życia etykiety
  1. Utwórz etykietę (create()) – etykieta jest tworzona i przechowywana w bazie danych jako revision_id=1. Etykieta ma stan UNPUBLISHED_DRAFT. W tym stanie:
    • Użytkownicy nie mogą wyświetlać etykiety
    • Użytkownicy nie mogą stosować etykiety do elementów na Dysku.
  2. (Opcjonalnie) Zaktualizuj etykietę, pole lub wybór (delta()) – każda aktualizacja, nawet przed opublikowaniem, jest przechowywana w bazie danych, a wersja etykiety jest zwiększana.
  3. Opublikuj etykietę (publish()) – etykieta ma stan PUBLISHED i użytkownicy mogą ją stosować. Opublikowanie etykiety zwiększa jej wersję.
  4. (Opcjonalnie) Zaktualizuj etykietę, pole lub wybór (delta()) – etykieta, pole lub wybór zostaną zaktualizowane i zapisane w bazie danych jako wersja robocza etykiety. Etykieta ma stan PUBLISHED, przy czym hasUnpublishedChanges=true oznacza, że istnieją zmiany w wersji roboczej, ale nie są one dostępne dla użytkowników. Każda aktualizacja zwiększa numer wersji etykiety.
  5. (opcjonalnie) Opublikuj etykietę (publish()) – jeśli jest dostępna, publikowana jest najnowsza wersja robocza. Etykieta ma stan PUBLISHED i użytkownicy mogą ją zastosować. Opublikowanie etykiety zwiększa jej wersję.
  6. Wyłączenie etykiety (disable()) – etykieta ma stan DISABLED, ale użytkownicy mogą stosować ją za pomocą interfejsu API. Wyłączona etykieta nie jest jednak wyświetlana w interfejsie, chyba że skonfigurujesz jej wyświetlanie. Wycofanie etykiety powoduje zwiększenie jej wersji.
  7. Włącz etykietę (enable()) – etykieta wraca do stanu PUBLISHED, a użytkownicy mogą ją stosować. Opublikowanie etykiety zwiększa jej wersję.
  8. Usuń etykietę (delete()) – etykieta ma stan DELETED i nie można jej zastosować. Usunięte etykiety są ostatecznie usuwane.

Warto podkreślić, że każda aktualizacja etykiety zwiększa jej numer wersji. Jeśli etykieta została już opublikowana, ponowne opublikowanie jej po n aktualizacjach oznacza, że opublikowany numer wersji to wersja + n + 1 kolejnych aktualizacji.