Жизненный цикл этикетки

Метки, поля и варианты выбора проходят определённые состояния на протяжении своего жизненного цикла. Кроме того, метки могут иметь различные версии. На следующей диаграмме показан жизненный цикл метки, включая версии:

Диаграмма жизненного цикла этикеток.
Рисунок 3. Жизненный цикл этикетки
  1. Создание метки ( create() ) — метка создаётся и сохраняется в базе данных как revision_id=1 . Метка имеет состояние UNPUBLISHED_DRAFT . В этом состоянии:
    • Пользователи не могут просматривать этикетку
    • Пользователи не могут применять метку к элементам Диска.
  2. (необязательно) Обновите метку, поле или выбор ( delta() ) — каждое обновление, даже до его публикации, сохраняется в базе данных, а номер версии метки увеличивается.
  3. Публикация метки ( publish() ) — метка имеет статус PUBLISHED , и пользователи могут её применять. Публикация метки увеличивает её номер версии.
  4. (необязательно) Обновить метку, поле или вариант ( delta() ) — метка, поле или вариант обновляются и сохраняются в базе данных как черновик метки. Метка имеет статус PUBLISHED с hasUnpublishedChanges=true что означает наличие черновиков изменений, но они недоступны пользователям. Каждое обновление увеличивает номер версии метки.
  5. (необязательно) Опубликовать метку ( publish() ) — если доступно, публикуется самый последний черновик. Метка имеет статус PUBLISHED , и пользователи могут её применить. Публикация метки увеличивает её версию.
  6. Отключение метки ( disable() ) — метка имеет состояние DISABLED , хотя пользователи могут применить её через API. Однако отключённая метка не отображается в пользовательском интерфейсе, если не настроено её отображение. Отмена метки увеличивает её версию.
  7. Включить метку ( enable() ) — метка возвращается в состояние PUBLISHED , и пользователи могут её применить. Публикация метки увеличивает её номер версии.
  8. Удалить метку ( delete() ) — метка имеет статус DELETED и не может быть применена. Удалённые метки в конечном итоге очищаются.

Важно подчеркнуть, что каждое обновление метки увеличивает её номер версии. И если метка уже была опубликована, её повторная публикация после n обновлений означает, что номер опубликованной версии равен номеру версии + n + 1.