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

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

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