قواعد التحقق من حقول النشاط (Validation Rules)
يوضّح هذا المرجع القواعد المفروضة على حقول شاشة «إضافة نشاط» حتى تعرف الحقول المطلوبة والحدود المسموحة ولماذا قد يبقى زر الحفظ معطّلاً. الشاشة نفسها موصوفة خطوةً بخطوة في صفحة إضافة نشاط جديد.
النموذج مقسّم إلى خطوات: «الأساسيات» [Basics] · «الجدول» [Schedule] · «الطاقم» [Staff] · «الوسائط» [Media] · «الدفع والموقع» [Payment & location] — وتظهر خطوة سادسة «الأسئلة» [Questions] إذا كانت مدرستك تستخدم أسئلة التسجيل. تستطيع التنقّل بين الخطوات بحرية، لكن الحقول ذات النجمة الحمراء (*) إلزامية.
مصفوفة قواعد التحقق (Form Validation Registry)
| الحقل في الواجهة | نوع الحقل | القاعدة | مثال مقبول | الرسالة عند المخالفة |
|---|---|---|---|---|
«اسم النشاط» [Activity name] | نص | مطلوب، بحد أقصى 200 حرف. | نادي الروبوت المتقدم | «اسم النشاط مطلوب.» [Activity Name is required.] / «اسم النشاط طويل جدًا.» [Activity Name is too long.] |
«لاحقة النشاط» [Activity suffix] (تظهر عند «إضافة مجموعة») | نص | اختيارية، بحد أقصى 100 حرف. | المجموعة ب | «لاحقة النشاط طويلة جدًا.» [Activity Suffix is too long.] |
«وصف النشاط» [Activity description] | نص طويل | اختياري، بحد أقصى 4000 حرف. | تعلم لغات البرمجة وتصميم الألعاب الفكرية | «وصف النشاط طويل جدًا.» [Activity description is too long.] |
«جنس النشاط» [Activity gender] | قائمة منسدلة | مطلوب، اختر «ذكور» [Male] أو «إناث» [Female] أو «مختلط» [Both]. | ذكور | «جنس النشاط مطلوب.» [Activity Gender is required.] |
«السعة» [Capacity] | رقم | مطلوبة، عدد صحيح أكبر من 0. لا يغيّر النموذج ما تكتبه: إن كتبت 0 أو كسراً مثل 12.5 تظهر الرسالة أسفل الحقل. | 25 | «السعة مطلوبة.» [Capacity is required.] / «السعة يجب أن تكون أكبر من صفر.» [Capacity must be greater than 0.] / «يجب أن تكون السعة عددًا صحيحًا دون كسور.» [Capacity must be a whole number (no fractions).] |
«الرسوم (ر.س)» [Fees (SAR)] | رقم | اختيارية (أدخلها للأنشطة المدفوعة)، وهي المبلغ الإجمالي الذي يدفعه ولي الأمر شاملاً الضريبة إن وُجدت. الرسوم إما 0 (نشاط مجاني) أو 1.00 ر.س فأكثر، وتظهر الرسالة أسفل الحقل فور إدخال قيمة بينهما. | 350 | «يجب أن تكون الرسوم 0 للنشاط المجاني، أو 1.00 ر.س على الأقل؛ فالدفع الإلكتروني لا يقبل مبلغًا أقل من 1.00 ر.س.» [Fees must be 0 for a free activity, or at least 1.00 SAR. Online payment cannot charge less than 1.00 SAR.] |
«الفئات العمرية» [Age ranges] | اختيار متعدد | اختيارية، أضِف صفًّا واحدًا أو أكثر من القائمة؛ يعرض كل خيار اسم الصف ومداه العمري. | الرابع الابتدائي · 9 إلى 10 سنوات | — (لا رسالة خطأ) |
«تاريخ البداية» [Start date] | تاريخ | يُختار من التقويم. | 15/09/2026 | — (تظهر رسالة ترتيب التاريخين أسفل «تاريخ النهاية») |
«تاريخ النهاية» [End date] | تاريخ | يُختار من التقويم، ولا يجوز أن يسبق «تاريخ البداية» (يجوز أن يساويه). | 15/12/2026 | «لا يمكن أن يسبق تاريخ النهاية تاريخ البداية.» [The end date cannot be before the start date.] |
«قيمة الخصم» [Discount value] | رقم | تظهر عند تفعيل «خصم الإخوة»؛ اختر «نوع الخصم» [Discount type] — «نسبة مئوية (%)» [Percentage] أو «مبلغ ثابت (ر.س)» [Fixed amount] — ثم أدخل القيمة (أرقام فقط). لا يُقبل خصم يترك على الطفل الثاني فأكثر مبلغًا أكبر من الصفر وأقل من 1.00 ر.س، وتظهر الرسالة أسفل الحقل فور ذلك؛ أما الخصم الكامل فمقبول. | 15 | «خصم الإخوة هذا يجعل المبلغ المستحق على الطفل الثاني فصاعدًا أقل من 1.00 ر.س، والدفع الإلكتروني لا يقبل مبلغًا أقل من ذلك. اجعل الخصم كاملًا، أو اترك 1.00 ر.س على الأقل للدفع.» [This sibling discount leaves the 2nd child onward paying less than 1.00 SAR, which online payment cannot charge. Make it a full discount, or leave at least 1.00 SAR to pay.] |
«طرق الدفع» [Payment methods] | اختيار متعدد | مطلوب اختيار طريقة واحدة على الأقل من المتاحة لمدرستك. | نقدي | «اختر طريقة دفع واحدة على الأقل.» [Please select at least one payment method.] |
«رفع صورة» [Upload image] | ملف صورة | اختياري. الحجم الأقصى 5 ميجابايت. الصيغ المقبولة: jpg, jpeg, png, gif, webp. | logo.png | «نوع ملف غير صالح، المسموح فقط: jpg، jpeg، png، gif، webp.» [Invalid file type, only jpg, jpeg, png, gif, webp allowed.] / «الملف كبير جدًا. الحد الأقصى 5 ميجابايت.» [File too large. The max size is 5 MB.] |
«موقع جديد» [New location] | نص (رابط) | مطلوب فقط عند إلغاء تفعيل خيار «مثل المدرسة» [Same as school]. | https://maps.app.goo.gl/abc | «موقع النشاط مطلوب.» [Activity Location is required.] / «موقع النشاط طويل جدًا.» [Activity Location is too long.] |
التواريخ تُختار من التقويم في خطوة «الجدول»، بينما تُحدَّد أوقات الجلسات الأسبوعية بعد حفظ النشاط من شاشة الجدول الأسبوعي للجلسات.
لماذا يبقى زر «حفظ النشاط» معطّلاً؟
- زر «حفظ النشاط»
[Save activity]يبقى معطّلاً حتى تكتمل جميع الحقول المطلوبة عبر كل خطوات النموذج — لا يكفي أن تكون الخطوة الظاهرة أمامك صحيحة. يظهر بجانب الزر تنبيه «أكمل الحقول المطلوبة للحفظ»[Complete the required fields to save]، وتظهر رسالة الخطأ بلون أحمر أسفل كل حقل مخالف. تنقّل بين الخطوات وابحث عن الحقول ذات النجمة الحمراء. - الحقول المطلوبة دائمًا: اسم النشاط، السعة، جنس النشاط، وطريقة دفع واحدة على الأقل. أما «موقع جديد» فيصبح مطلوبًا فقط عند إلغاء «مثل المدرسة».
- حدّ
1.00ر.س لا يعطّل الزر: مخالفة هذا الحدّ في «الرسوم» أو «قيمة الخصم» تُظهر رسالتها أسفل الحقل، لكنها لا تعطّل زر «حفظ النشاط». فإن ضغطته والقيمة ما زالت مخالفة لا يُحفظ النشاط، وتتكرّر الرسالة نفسها في الشريط الأحمر فوق أزرار الحفظ والتنقّل لتراها من أي خطوة كنت فيها، ثم تختفي منه بمجرّد تصحيح القيمة. راجع ضبط الرسوم والسعة. - رفض الخادم: إذا مرّت القيمة على فحوصات الشاشة ثم رفضها الخادم عند الحفظ، تظهر رسالة الخطأ في شريط أحمر فوق أزرار الحفظ والتنقّل. وإذا كان سبب الرفض حدّ
1.00ر.س، تظهر في الشريط الرسالة نفسها الواردة في الجدول أعلاه.
الأسئلة الشائعة
ليش زر «حفظ النشاط» ما يشتغل ويظهر رماديًا؟ لأن أحد الحقول المطلوبة ناقص أو مخالف. زر [حفظ النشاط] يبقى معطّلاً حتى تكتمل جميع الحقول المطلوبة في كل الخطوات (اسم النشاط، السعة، جنس النشاط، وطريقة دفع واحدة على الأقل). تنقّل بين الخطوات وابحث عن الحقول ذات النجمة الحمراء. الشرح الكامل في إضافة نشاط جديد.
كم أقصى عدد حروف لاسم النشاط والوصف؟
اسم النشاط يقبل حتى 200 حرف، ووصف النشاط حتى 4000 حرف. إذا تجاوزت الحد تظهر رسالة «... طويل جدًا» أسفل الحقل ويتعذّر الحفظ حتى تختصره.
وش صيغ الصور المسموحة وكم الحجم الأقصى؟
عبر زر [رفع صورة] في خطوة «الوسائط» ترفع صورة بصيغة jpg أو jpeg أو png أو gif أو webp، وبحد أقصى 5 ميجابايت. أي صيغة أو حجم خارج ذلك يُرفض مع رسالة تنبيه فورية.
وين أحدّد السعة والرسوم؟
في خطوة «الأساسيات». السعة مطلوبة ويجب أن تكون عدداً صحيحاً أكبر من صفر، أما الرسوم فاختيارية وتُدخل أرقامًا فقط، وتكون إما صفرًا أو 1.00 ر.س فأكثر. لمزيد من التفصيل راجع ضبط الرسوم والسعة.
ليش يطلب مني «موقع جديد»؟ حقل [موقع جديد] يصبح مطلوبًا فقط عند إلغاء تفعيل خيار «مثل المدرسة» في خطوة «الدفع والموقع». اترك «مثل المدرسة» مفعّلاً ليأخذ النشاط موقع مدرستك تلقائيًا دون إدخال رابط.