Cykl życia etykiet

Etykiety, pola i wybory przechodzą przez życie przez określone stany. Poza tym etykiety mogą mieć różne wersje. Poniższy diagram przedstawia cykl życia etykiety, w tym zmiany:

Diagram cyklu życia etykiet.
Rysunek 3. Cykl życia etykiety
  1. Utwórz etykietę (create()) – etykieta zostanie utworzona i zapisana w jako revision_id=1. Etykieta ma stan UNPUBLISHED_DRAFT. W tym stanie:
    • Użytkownicy nie mogą zobaczyć etykiety
    • Użytkownicy nie mogą stosować tej etykiety do elementów na Dysku.
  2. (Opcjonalnie) Aktualizacja etykiety, pola lub wyboru (delta()) – po każdej aktualizacji nawet przed jej opublikowaniem, są przechowywane w bazie danych, a etykieta wersji zwiększa się.
  3. Opublikuj etykietę (publish()) – etykieta ma stan PUBLISHED i użytkownicy mogą zastosować etykietę. Opublikowanie etykiety zwiększa jej wersję.
  4. (Opcjonalnie) Zaktualizuj etykietę, pole lub opcję (delta()) – etykietę, lub wybór zostanie zaktualizowany i zapisany w bazie danych jako etykieta robocza. etykieta ma stan PUBLISHED z hasUnpublishedChanges=true oznaczającym pojawiają się 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, najbardziej aktualna wersja robocza została opublikowana. Etykieta ma stan PUBLISHED, a użytkownicy mogą zastosować etykietę. Opublikowanie etykiety powoduje zwiększenie jej wersji.
  6. Wyłącz etykietę (disable()) – etykieta ma stan DISABLED. ale użytkownicy mogą ją stosować za pomocą interfejsu API. Wyłączona etykieta nie jest widoczna w interfejsie, jeśli nie została skonfigurowana tak, aby była wyświetlana. Wycofanie etykiety zwiększa jej wersję.
  7. Włącz etykietę (enable()) – etykieta ma stan PUBLISHED. a użytkownicy mogą ją zastosować. Opublikowanie etykiety zwiększa jej wersję.
  8. Usuń etykietę (delete()) – etykieta ma stan DELETED i nie można zastosować. Usunięte etykiety są ostatecznie trwale usuwane.

Należy pamiętać, że każda aktualizacja etykiety zwiększa jej wartość wersji. Jeśli etykieta została już opublikowana, opublikuj ją ponownie. po n aktualizacjach oznacza, że numer opublikowanej wersji to wersja + n + 1 liczby kolejnych aktualizacji.