Labellebenszyklus

Labels, Felder und Entscheidungen durchlaufen während ihres Lebens bestimmte Bundesstaaten. Außerdem können Labels unterschiedliche Versionen haben. Das folgende Diagramm zeigt den Labellebenszyklus, einschließlich der Überarbeitung:

Abbildung 3: Lebenszyklus eines Labels

1. Label erstellen (create()): Das Label wird erstellt und in einer Datenbank als revision_id=1 gespeichert. Das Label hat den Status UNPUBLISHED_DRAFT. Status:
   • Nutzer können das Label nicht sehen
   • Nutzer können das Label nicht auf Drive-Elemente anwenden.
2. (Optional) Label, Feld oder Auswahl aktualisieren (delta()): Jede Aktualisierung wird – auch vor ihrer Veröffentlichung – in einer Datenbank gespeichert und die Überarbeitung des Labels erhöht.
3. Label veröffentlichen (publish()): Das Label hat den Status PUBLISHED und Nutzer können es anwenden. Durch das Veröffentlichen des Labels wird die Überarbeitung erhöht.
4. (Optional) Label, Feld oder Auswahl aktualisieren (delta()): Das Label, Feld oder Auswahl wird aktualisiert und als Labelentwurf in einer Datenbank gespeichert. Das Label hat den Status PUBLISHED mit hasUnpublishedChanges=true. Dies bedeutet, dass Änderungen am Entwurf vorgenommen wurden, diese Nutzern aber nicht zur Verfügung stehen. Mit jeder Aktualisierung erhöht sich die Überarbeitung des Labels.
5. (Optional) Label veröffentlichen (publish()): Falls verfügbar, wird der aktuellste Entwurf veröffentlicht. Das Label hat den Status PUBLISHED und Nutzer können das Label anwenden. Durch das Veröffentlichen des Labels wird seine Version erhöht.
6. Label deaktivieren (disable()): Das Label hat den Status DISABLED, Nutzer können es aber über die API anwenden. Ein deaktiviertes Label wird jedoch nur dann in einer UI angezeigt, wenn es für die Anzeige konfiguriert wurde. Wird das Label verworfen, erhöht sich die Überarbeitung.
7. Label aktivieren (enable()): Das Label wird auf den Status PUBLISHED zurückgesetzt und Nutzer können es anwenden. Durch das Veröffentlichen des Labels wird die Überarbeitung erhöht.
8. Label löschen (delete()): Das Label hat den Status DELETED und kann nicht angewendet werden. Gelöschte Labels werden dauerhaft gelöscht.

Wichtig ist, dass jede Aktualisierung eines Labels die Überarbeitung des Labels erhöht. Wenn das Label bereits veröffentlicht wurde, bedeutet eine erneute Veröffentlichung nach n Updates, dass die veröffentlichte Überarbeitungsnummer „Version“ + n + 1 Anzahl aufeinanderfolgender Updates lautet.