Labellebenszyklus

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

Diagramm zum Lebenszyklus von Labels.
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. In diesem 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 noch vor der Veröffentlichung in einer Datenbank gespeichert und die Revision des Labels wird 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 Versionsnummer erhöht.
  4. Optional: Label, Feld oder Auswahl aktualisieren (delta()): Das Label, Feld oder die Auswahl wird aktualisiert und in einer Datenbank als Entwurfslabel gespeichert. Das Label hat den Status PUBLISHED. hasUnpublishedChanges=true bedeutet, dass es Änderungen am Entwurf gibt, die aber nicht für Nutzer verfügbar sind. Bei jeder Aktualisierung wird die Version des Labels erhöht.
  5. (Optional) Label veröffentlichen (publish()): Sofern verfügbar, wird der aktuelle Entwurf veröffentlicht. Das Label hat den Status PUBLISHED und Nutzer können es anwenden. Wenn Sie das Label veröffentlichen, wird die 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 der Benutzeroberfläche angezeigt, wenn dies konfiguriert wurde. Wenn Sie das Label einstellen, wird die Version erhöht.
  7. Label aktivieren (enable()): Das Label wird in den Status PUBLISHED zurückversetzt und Nutzer können es anwenden. Durch das Veröffentlichen des Labels wird die Versionsnummer erhöht.
  8. Label löschen (delete()): Das Label hat den Status DELETED und kann nicht angewendet werden. Gelöschte Labels werden nach einer gewissen Zeit gelöscht.

Wichtig: Bei jeder Aktualisierung eines Labels wird die Version des Labels erhöht. Wenn das Label bereits veröffentlicht wurde, wird nach n Updates die veröffentlichte Überarbeitungsnummer als „Überarbeitung + n + 1“ (Anzahl der aufeinanderfolgenden Updates) festgelegt.