Cykl życia etykiet

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:

Diagram cyklu życia etykiet.
Rysunek 3. Cykl życia etykiety
  1. Utwórz etykietę (create()) – etykieta zostanie utworzona i zapisana w bazie danych jako revision_id=1. Stan etykiety to UNPUBLISHED_DRAFT. W takim 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 jej opublikowaniem, jest przechowywana w bazie danych, a wersja etykiety jest zwiększana.
  3. Opublikuj etykietę (publish()) – etykieta ma stan PUBLISHED, a użytkownicy mogą ją stosować. Opublikowanie etykiety powoduje zwiększenie jej wersji.
  4. (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 stan PUBLISHED z atrybutem hasUnpublishedChanges=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.
  5. (Opcjonalnie) Opublikuj etykietę (publish()) – jeśli ta opcja jest dostępna, zostanie opublikowana najnowsza wersja robocza. Etykieta ma stan PUBLISHED, a użytkownicy mogą ją stosować. Opublikowanie etykiety powoduje zwiększenie jej wersji.
  6. Wyłącz etykietę (disable()) – etykieta ma stan DISABLED, 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.
  7. Włącz etykietę (enable()) – etykieta zostanie zwrócona do stanu PUBLISHED, a użytkownicy będą mogli ją zastosować. Opublikowanie etykiety powoduje zwiększenie jej wersji.
  8. Usunąć etykietę (delete()) – etykieta ma stan DELETED 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.