Ciclo di vita di un'etichetta

Le etichette, i campi e le scelte attraversano stati specifici durante il loro ciclo di vita. Inoltre, le etichette potrebbero avere revisioni diverse. Il seguente diagramma mostra il ciclo di vita dell'etichetta, inclusa la gestione delle revisioni:

Diagramma del ciclo di vita delle etichette.
Figura 3. Ciclo di vita di un'etichetta
  1. Crea un'etichetta (create()): l'etichetta viene creata e archiviata in un database come revision_id=1. L'etichetta ha lo stato UNPUBLISHED_DRAFT. In questo stato:
    • Gli utenti non possono visualizzare l'etichetta
    • Gli utenti non possono applicare l'etichetta agli elementi di Drive.
  2. (Facoltativo) Aggiorna un'etichetta, un campo o una scelta (delta()): ogni aggiornamento, anche prima della pubblicazione, viene archiviato in un database e la revisione dell'etichetta viene incrementata.
  3. Pubblica un'etichetta (publish()): l'etichetta ha lo stato PUBLISHED e gli utenti possono applicarla. La pubblicazione dell'etichetta ne incrementa la revisione.
  4. (Facoltativo) Aggiorna un'etichetta, un campo o una scelta (delta()): l'etichetta, il campo o la scelta viene aggiornato e memorizzato in un database come bozza di etichetta. L'etichetta ha lo stato PUBLISHED con hasUnpublishedChanges=true, il che significa che sono presenti modifiche alla bozza, ma non sono disponibili per gli utenti. Ogni aggiornamento incrementa la revisione dell'etichetta.
  5. (Facoltativo) Pubblica un'etichetta (publish()): se disponibile, viene pubblicata la bozza più recente. L'etichetta ha lo stato PUBLISHED e gli utenti possono applicarla. La pubblicazione dell'etichetta ne incrementa la versione.
  6. Disattivare un'etichetta (disable()): l'etichetta ha lo stato DISABLED, anche se gli utenti possono applicarla tramite l'API. Tuttavia, un'etichetta disattivata non viene visualizzata in un'interfaccia utente, a meno che non sia configurata per essere mostrata. Il ritiro dell'etichetta ne incrementa la revisione.
  7. Attiva un'etichetta (enable()): l'etichetta torna allo stato PUBLISHED e gli utenti possono applicarla. La pubblicazione dell'etichetta ne incrementa la revisione.
  8. Eliminare un'etichetta (delete()): l'etichetta ha lo stato DELETED e non può essere applicata. Le etichette eliminate vengono eliminate definitivamente.

È importante sottolineare che ogni aggiornamento di un'etichetta incrementa la revisione dell'etichetta. Inoltre, se l'etichetta è già stata pubblicata, la sua ripubblicazione dopo n aggiornamenti significa che il numero di revisione pubblicato è revisione + n + 1 numero di aggiornamenti successivi.