إنتقل إلى المحتوى الرئيسي

مرجع التحقق من صحة مدخلات الأنشطة (Validation Rules)

يوفر هذا المرجع التقني القوانين والقيود البرمجية المفروضة على حقول إدخال وتعديل الأنشطة في لوحة تحكم Skool.Cool لضمان عدم حدوث أخطاء أثناء الحفظ.

مصفوفة تحققات النموذج (Form Validation Registry)​

اسم الحقل في الواجهةنوع الحقلالقيود البرمجيةمثال مقبولرسالة الخطأ المتوقعة عند المخالفة
Activity Nameنصمطلوب، طول النص بين 3 إلى 100 حرف.نادي الروبوت المتقدمActivity Name is required / Length must be between 3 and 100 characters
Suffixنصمطلوب فقط في الأنشطة الفرعية، طول النص بين 1 إلى 50 حرف.المجموعة بSuffix is required
Descriptionنص طويلاختياري، الحد الأقصى للطول 500 حرف.تعلم لغات البرمجة وتصميم الألعاب الفكريةDescription cannot exceed 500 characters
Genderقائمة منسدلةمطلوب اختيار قيمة واحدة (Boy, Girl, Co-ed).BoyPlease select a gender option
Age Rangesاختيار متعددمطلوب اختيار فئة عمرية واحدة على الأقل من الفئات المتاحة.8-10 yearsPlease select at least one age range
Start Dateتاريخمطلوب، يجب أن يكون تاريخاً صحيحاً لا يسبق تاريخ اليوم عند الإنشاء الجديد.15/09/2026Start date cannot be in the past
End Dateتاريخمطلوب، يجب أن يكون بعد تاريخ البدء (EndDate > StartDate).15/12/2026End date must be after start date
Capacityرقممطلوب، قيمة عددية صحيحة موجبة أكبر من 0.25يقبل الأرقام فقط بفلترة validateNumberInput()
Feesرقم ماليمطلوب (عدا الأنشطة المجانية)، قيمة أكبر من أو تساوي 0.350يقبل الأرقام فقط بفلترة validateNumberInput
Sibling Discount Valueرقممطلوب عند تفعيل الخصم. إذا كان نوع الخصم نسبة مئوية، يجب أن تتراوح القيمة بين 1 و 100.15Discount value must be between 1 and 100
Image Fileملف صورةاختياري. الحجم الأقصى 5MB. الصيغ المقبولة: jpg, jpeg, png, gif, webp.logo.pngInvalid file type / File too large. Max size is 5 MB.
Location URLنص (رابط)مطلوب فقط عند إلغاء تفعيل خيار "موقع النشاط نفس موقع المدرسة". يجب أن يطابق تنسيق URL صحيح.https://maps.google.com/?q=...Invalid URL format

كيفية التعامل مع أخطاء التحقق (Handling Validation Errors)​

  1. يمنع المعالج الخماسي الانتقال بين تبويبات النموذج إذا كان التبويب الحالي يحتوي على حقل إلزامي فارغ أو مخالف للقيود (تظهر الحقول بلون أحمر).
  2. في حال إرسال بيانات مخالفة للخادم بطريقة ملتوية، سيقوم الخادم برفض الطلب وإرجاع تفاصيل الخطأ لتظهر في الشريط الأحمر العلوي للنموذج (_errorMessage).