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:
- Label erstellen (
create()
): Das Label wird erstellt und in einer Datenbank alsrevision_id=1
gespeichert. Das Label hat den StatusUNPUBLISHED_DRAFT
. In diesem Status gilt:- Nutzer können das Label nicht ansehen
- Nutzer können das Label nicht auf Drive-Elemente anwenden.
- (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. - Label veröffentlichen (
publish()
): Das Label hat den StatusPUBLISHED
und Nutzer können das Label anwenden. Durch das Veröffentlichen des Labels wird die Überarbeitung erhöht. - (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 StatusPUBLISHED
mithasUnpublishedChanges=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. - Optional: Label veröffentlichen (
publish()
): Falls verfügbar, wird der neueste Entwurf veröffentlicht. Das Label hat den StatusPUBLISHED
und Nutzer können das Label anwenden. Durch die Veröffentlichung des Labels wird seine Version erhöht. - Label deaktivieren (
disable()
): Das Label hat den StatusDISABLED
, 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. - Label aktivieren (
enable()
): Das Label wird in den StatusPUBLISHED
zurückgesetzt und Nutzer können das Label anwenden. Durch das Veröffentlichen des Labels wird die Überarbeitung erhöht. - Label löschen (
delete()
): Das Label hat den StatusDELETED
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.