Labellebenszyklus

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

1. Label erstellen (create()): Das Label wird erstellt und in einer Datenbank als revision_id=1 gespeichert. Das Label hat den Status UNPUBLISHED_DRAFT. In diesem Status gilt:
   • Nutzer können das Label nicht ansehen
   • Nutzer können das Label nicht auf Drive-Elemente anwenden.
2. (Optional) Label, Feld oder Auswahl aktualisieren (delta()): Jede Aktualisierung wird in einer Datenbank gespeichert und die Überarbeitung des Labels wird erhöht – auch vor ihrer Veröffentlichung.
3. Label veröffentlichen (publish()): Das Label hat den Status PUBLISHED und Nutzer können das Label anwenden. Durch das Veröffentlichen des Labels wird die Überarbeitung erhöht.
4. (Optional) Label, Feld oder Auswahl aktualisieren (delta()): Das Label, das Feld oder die Auswahl wird aktualisiert und in einer Datenbank als Labelentwurf gespeichert. Das Label hat den Status PUBLISHED mit hasUnpublishedChanges=true. Das bedeutet, dass Entwurfsänderungen vorhanden sind, die für Nutzer aber nicht verfügbar sind. Mit jeder Aktualisierung wird die Überarbeitung des Labels erhöht.
5. Optional: Label veröffentlichen (publish()): Falls verfügbar, wird der neueste Entwurf veröffentlicht. Das Label hat den Status PUBLISHED und Nutzer können das Label anwenden. Durch die Veröffentlichung des Labels wird seine Version erhöht.
6. Label deaktivieren (disable()): Das Label hat den Status DISABLED, obwohl Nutzer das Label über die API anwenden können. Ein deaktiviertes Label wird jedoch nur dann auf einer UI angezeigt, wenn es für die Anzeige konfiguriert wurde. Wenn Sie das Label verwerfen, wird die Überarbeitung erhöht.
7. Label aktivieren (enable()): Das Label wird in den Status PUBLISHED zurückgesetzt und Nutzer können das Label 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.

Es ist wichtig zu betonen, dass bei jeder Aktualisierung eines Labels die Überarbeitung des Labels erhöht wird. Wenn das Label bereits veröffentlicht wurde, bedeutet eine erneute Veröffentlichung nach n Aktualisierungen, dass die veröffentlichte Überarbeitungsnummer Überarbeitung + n + 1 Anzahl aufeinanderfolgender Aktualisierungen lautet.