چرخه عمر برچسب

برچسب‌ها، فیلدها و انتخاب‌ها در طول زندگی خود حالت‌های خاصی را طی می‌کنند. علاوه بر این، برچسب‌ها ممکن است بازبینی‌های متفاوتی داشته باشند. نمودار زیر چرخه عمر برچسب، از جمله تجدید نظر را نشان می دهد:

1. ایجاد یک برچسب ( create() ) - برچسب ایجاد و در یک پایگاه داده به عنوان revision_id=1 ذخیره می شود. برچسب دارای وضعیت UNPUBLISHED_DRAFT است. در این حالت:
   • کاربران نمی توانند برچسب را ببینند
   • کاربران نمی‌توانند این برچسب را روی موارد Drive اعمال کنند.
2. (اختیاری) به‌روزرسانی یک برچسب، فیلد یا انتخاب ( delta() ) - هر به‌روزرسانی، حتی قبل از انتشار، در یک پایگاه داده ذخیره می‌شود و بازبینی برچسب افزایش می‌یابد.
3. انتشار یک برچسب ( publish() ) — برچسب حالت PUBLISHED را دارد و کاربران می توانند برچسب را اعمال کنند. انتشار برچسب، بازبینی آن را افزایش می دهد.
4. (اختیاری) به‌روزرسانی یک برچسب، فیلد یا انتخاب ( delta() ) - برچسب، فیلد یا انتخاب به‌روزرسانی می‌شود و در یک پایگاه داده به عنوان یک برچسب پیش‌نویس ذخیره می‌شود. برچسب دارای وضعیت PUBLISHED با hasUnpublishedChanges=true است به این معنی که تغییرات پیش نویس وجود دارد، اما برای کاربران در دسترس نیستند. هر به‌روزرسانی بازبینی برچسب را افزایش می‌دهد.
5. (اختیاری) انتشار یک برچسب ( publish() ) — در صورت موجود بودن، پیش نویس فعلی منتشر می شود. برچسب دارای وضعیت PUBLISHED است و کاربران می توانند برچسب را اعمال کنند. انتشار برچسب نسخه آن را افزایش می دهد.
6. غیرفعال کردن یک برچسب ( disable() ) - این برچسب دارای وضعیت DISABLED است، اگرچه کاربران می توانند برچسب را از طریق API اعمال کنند. با این حال، یک برچسب غیرفعال در رابط کاربری نشان داده نمی‌شود مگر اینکه برای نمایش پیکربندی شده باشد. منسوخ شدن برچسب، بازبینی آن را افزایش می دهد.
7. فعال کردن یک برچسب ( enable() ) - برچسب به حالت PUBLISHED برمی‌گردد و کاربران می‌توانند برچسب را اعمال کنند. انتشار برچسب، بازبینی آن را افزایش می دهد.
8. حذف یک برچسب ( delete() ) - برچسب حالت DELETED دارد و قابل اعمال نیست. برچسب های حذف شده در نهایت پاک می شوند.

مهم است که تأکید کنیم که هر به‌روزرسانی برای یک برچسب، بازبینی برچسب را افزایش می‌دهد. و اگر برچسب قبلاً منتشر شده باشد، انتشار مجدد آن پس از n به‌روزرسانی به این معنی است که شماره ویرایش منتشر شده آن revision + n + 1 تعداد به‌روزرسانی‌های متوالی است.