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

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

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