Cykl życia etykiet

Etykiety, pola i opcje przechodzą przez określone stany w trakcie swojego cyklu życia. Etykiety mogą też mieć różne wersje. Poniższy diagram przedstawia cykl życia etykiety, w tym wersjonowanie:

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 opcję (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 opcję (delta()) – etykieta, pole lub opcja jest aktualizowana i przechowywana w bazie danych jako wersja robocza. Etykieta ma stan PUBLISHED z hasUnpublishedChanges=true, co oznacza, że istnieją zmiany w wersji roboczej, ale nie są one dostępne dla użytkowników. Każda aktualizacja zwiększa wersję 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ą stosować. Opublikowanie etykiety zwiększa jej wersję.
  6. Wyłącz etykietę (disable()) – etykieta ma stan DISABLED, ale użytkownicy mogą ją stosować za pomocą interfejsu API. Wyłączona etykieta nie jest jednak wyświetlana w interfejsie, chyba że jest skonfigurowana tak, aby się wyświetlała. Wycofanie etykiety zwiększa jej wersję.
  7. Włącz etykietę (enable()) – etykieta wraca do stanu PUBLISHED i 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.

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