Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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:
Rysunek 3. Cykl życia etykiety
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.
(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.
Opublikowanie etykiety (publish()) – etykiety mają stan PUBLISHED i użytkownicy mogą je stosować. Publikacja etykiety powoduje zwiększenie jej wersji.
(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.
(Opcjonalnie) Opublikuj etykietę (publish()) – jeśli jest dostępna, zostanie opublikowana najnowsza wersja robocza. Etykieta ma stan PUBLISHED i użytkownicy mogą ją zastosować. Publikowanie etykiety powoduje zwiększenie jej wersji.
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.
Włącz etykietę (enable()) – etykiety staną się dostępne (PUBLISHED) i użytkownicy będą mogli je stosować. Publikowanie etykiety powoduje zwiększenie jej wersji.
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 opublikowany numer jej wersji to wersja + n + 1 liczba kolejnych aktualizacji.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2024-12-21 UTC."],[[["Labels, fields, and choices transition through various states such as UNPUBLISHED_DRAFT, PUBLISHED, DISABLED, and DELETED during their lifecycle."],["Labels are initially created in an UNPUBLISHED_DRAFT state and can't be viewed or applied until published."],["Every update to a label, including drafts and publishes, increments its revision number."],["Published labels can be disabled and re-enabled, each action impacting their state and revision."],["Deleting a label renders it unusable and eventually leads to its permanent removal."]]],["Labels have lifecycles involving creation, updates, publishing, disabling, enabling, and deletion. Upon creation, a label is an `UNPUBLISHED_DRAFT` and each update increments its revision number. Publishing transitions it to `PUBLISHED`, enabling user application. Updates to a published label create drafts (`hasUnpublishedChanges=true`) and also increment the revision. Disabling sets the state to `DISABLED`, while enabling returns it to `PUBLISHED`. Deletion changes the state to `DELETED`, and eventually the label is purged. Every label update increments the revision count.\n"]]
