Cykl życia etykiet

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

1. Utwórz etykietę (create()) – etykietę tworzymy i przechowujemy 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()) – etykiety mają stan PUBLISHED i użytkownicy mogą je stosować. Publikacja etykiety powoduje zwiększenie jej wersji.
4. (Opcjonalnie) Zmień etykietę, pole lub wybór (delta()) – etykietę, pole lub wybór aktualizujemy i zapisujemy w bazie danych jako wersję roboczą etykiety. Etykieta ma stan PUBLISHED, a PUBLISHED oznacza, że istnieją zmiany w wersji roboczej, ale nie są one dostępne dla użytkowników.hasUnpublishedChanges=true Każda aktualizacja zwiększa wersję etykiety.
5. (Opcjonalnie) Opublikuj etykietę (publish()) – jeśli jest dostępna, zostanie opublikowany najnowszy projekt. Etykieta ma stan PUBLISHED i użytkownicy mogą ją zastosować. Publikowanie etykiety powoduje zwiększenie jej wersji.
6. Wyłącz etykietę (disable()) – stan etykiety to DISABLED, ale użytkownicy mogą zastosować ją za pomocą interfejsu API. Jednak wyłączona etykieta nie jest widoczna w interfejsie użytkownika, chyba że została skonfigurowana do wyświetlania. Wycofanie etykiety powoduje zwiększenie jej numeru wersji.
7. Włącz etykietę (enable()) – etykiety staną się dostępne (PUBLISHED) i użytkownicy będą mogli je stosować. Publikacja etykiety powoduje zwiększenie jej wersji.
8. Usuń etykietę (delete()) – etykiety o stanie DELETED nie można zastosować. Usuwane etykiety są ostatecznie usuwane.

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