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

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

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 من التحديثات المتتالية.