دورة حياة التصنيف

تمرّ التصنيفات والحقول والخيارات بحالات معيّنة طوال دورة حياتها. بالإضافة إلى ذلك، قد تحتوي التصنيفات على نُسخ مختلفة. يوضّح المخطّط التالي مراحل دورة حياة التصنيف، بما في ذلك المراجعة:

رسم بياني لمراحل نشاط التصنيفات
الشكل 3. مراحل نشاط التصنيف
  1. إنشاء تصنيف (create()): يتم إنشاء التصنيف وتخزينه في قاعدة بيانات باسم revision_id=1. التصنيف لديه الحالة UNPUBLISHED_DRAFT. في هذه الحالة:
    • لا يمكن للمستخدمين عرض التصنيف
    • لا يمكن للمستخدمين تطبيق التصنيف على عناصر Drive.
  2. (اختياري) تعديل تصنيف أو حقل أو خيار (delta()): يتم تخزين كل تعديل، حتى قبل نشره، في قاعدة بيانات، ويتمّ رفع تنقيح التصنيف.
  3. نشر تصنيف (publish()): يكون التصنيف في الحالة PUBLISHED ويمكن للمستخدمين تطبيقه. يؤدي نشر التصنيف إلى زيادة تنقيحه.
  4. (اختياري) تعديل تصنيف أو حقل أو خيار (delta()): يتم تعديل التصنيف أو الحقل أو الخيار وتخزينه في قاعدة بيانات كتصنيف مسودّة. يحمل التصنيف الحالة PUBLISHED مع hasUnpublishedChanges=true، ما يعني أنّ هناك تغييرات مسودة، ولكنها غير متاحة للمستخدمين. يؤدي كل تعديل إلى زيادة المراجعة الخاصة بالعلامة.
  5. (اختياري) نشر تصنيف (publish()): يتم نشر أحدث ملف سحابي مسودّة، إذا كان متاحًا. يحمل التصنيف الحالة PUBLISHED ويمكن للمستخدمين تطبيقه. يؤدي نشر التصنيف إلى زيادة إصداره.
  6. إيقاف تصنيف (disable()): يكون التصنيف في الحالة DISABLED مع أنّه يمكن للمستخدمين تطبيق التصنيف من خلال واجهة برمجة التطبيقات. ومع ذلك، لا يظهر التصنيف غير مفعّل في واجهة المستخدم ما لم يتم ضبطه للظهور. يؤدي إيقاف التصنيف نهائيًا إلى زيادة تنقيحه.
  7. تفعيل تصنيف (enable()): يتم إرجاع التصنيف إلى الحالة PUBLISHED ويمكن للمستخدمين تطبيق التصنيف. يؤدي نشر التصنيف إلى زيادة تنقيحه.
  8. حذف تصنيف (delete()): التصنيف في الحالة DELETED ولا يمكن تطبيقه. تتم إزالة التصنيفات المحذوفة في النهاية.

من المهم التأكيد على أنّ كل تعديل على تصنيف يزيد من مراجعة التصنيف. وإذا سبق نشر التصنيف، يعني نشره مرة أخرى بعد n تحديث أنّ رقم المراجعة المنشور هو المراجعة + n + 1 عدد التحديثات المتتالية.