المدققون

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

قد تختلف مجموعة المدققين حسب نوع البيانات.

أنواع المدققين

لكل نوع بيانات (يفتح في علامة تبويب جديدة) مجموعته الخاصة من المدققين المتاحين. فيما يلي جميع المدققين الذين قد تصادفهم في مختلف أنواع البيانات.

حقل مطلوب (Required field)

تجعل هذه القاعدة ملء الحقل إلزاميًا. لا تحتاج إلى إعدادات إضافية.

تقليم المسافات حول البيانات الواردة (Trimming spaces around incoming data)

تحذف هذه القاعدة المسافات من بداية السلسلة النصية ونهايتها. لا تحتاج إلى إعدادات إضافية.

التحقق من السلسلة (Checking the string)

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

التحقق من URL (URL verification)

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

التحقق من الرقم (Checking for a number)

تتحقق هذه القاعدة مما إذا كانت القيمة رقمًا. في الإعدادات الإضافية، يمكنك تحديد ما إذا كان الرقم صحيحًا، وتعيين قيمته الدنيا والقصوى.

تقريب الرقم (Rounding a number)

لا تتحقق هذه القاعدة من أن القيمة رقمية، بل تقرّب الرقم وفق القواعد المحددة في الإعدادات الإضافية. في الإعدادات الإضافية، يمكنك تحديد منزلة التقريب وقاعدته.

التحقق من البريد الإلكتروني (Email Verification)

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

القيمة الافتراضية (Default value)

تضع هذه القاعدة قيمة افتراضية في السمة إذا لم تُدخَل أي قيمة. في الإعدادات الإضافية، يمكنك تحديد القيمة الافتراضية.

التحقق من القائمة المحددة (Given list screening)

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

قناع الحقل (Field mask)

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

التحقق بالتعبير النمطي (Regular expression validation)

تتحقق هذه القاعدة مما إذا كانت البيانات المدخلة تطابق تعبيرًا نمطيًا. في الإعدادات الإضافية، يمكنك تحديد التعبير النمطي. لمعرفة المزيد عن التعبيرات النمطية، انظر "هنا".

التعبير النمطي

رغم أنه يمكنك إضافة عدة مدققين إلى حقل سمة واحد، فإن التحقق بالتعبير النمطي لا يتوافق مع عمليات التحقق الأخرى من القيمة. بعد إضافة تعبير نمطي، لا تعود القائمة تقترح: Checking the string وChecking for a number وDefault value وGiven list screening وField mask وComparison وLogical وEmail Verification وURL verification وRounding a number وTrimming spaces around incoming data.

والعكس صحيح: إذا كان للحقل بالفعل Trimming spaces around incoming data، فلن يُقترح التعبير النمطي ولا Field mask ولا Given list screening (ولا Size وChecking files أيضًا).

المقارنة (Comparison)

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

المنطقي (Logical)

تتحقق هذه القاعدة مما إذا كانت قيمة السمة منطقية. في الإعدادات الإضافية، يمكنك ضبط طريقة تفسير القيم غير المنطقية.

الحجم (Size)

تتحقق هذه القاعدة من حجم الصورة. في الإعدادات الإضافية، يمكنك تحديد الحد الأقصى لعرض الصورة (Max X) وارتفاعها (Max Y) بالبكسل؛ ولا يُحدَّد حد أدنى للحجم.

التحقق من الملفات (Checking files)

تتحقق هذه القاعدة من مطابقة الملف المرفوع للمعايير المحددة. في الإعدادات الإضافية، يمكنك ضبط الحد الأدنى والأقصى لحجم الملف، ووحدة القياس، وقائمة امتدادات الملفات المسموح بها (Extensions).

نطاق التاريخ والوقت (Date and time range for restriction)

تقيّد هذه القاعدة القيم التي يمكن اختيارها في السمة. وهي متاحة للأنواع "Date and Time" و"Date" و"Time". في الإعدادات الإضافية، حدد الحدين الأدنى والأعلى في الحقلين Minimum date and time value وMaximum date and time value؛ ويتبع تنسيق الحقلين نوع السمة (تاريخ أو وقت أو تاريخ مع وقت). إذا خرجت القيمة المختارة عن هذه الحدود، تظهر للمستخدم رسالة خطأ.

الأخطاء المخصصة

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

أمثلة

مثال: التحقق من حقل البريد الإلكتروني

في هذا المثال، يُضاف إلى القيمة النصية ما يلي:

• إزالة المسافات المحتملة من بداية السلسلة ونهايتها
• التحقق من أن السلسلة عنوان بريد إلكتروني

مثال: التحقق من حقل كلمة المرور

في هذا المثال، يُضاف إلى القيمة النصية ما يلي:

• التحقق من طول السلسلة وتركيبها باستخدام تعبير نمطي

مثال: التحقق من حقل الصورة

في هذا المثال، يُضاف إلى القيمة النصية ما يلي:

• التحقق من أبعاد الصورة
• التحقق من حجم ملف الصورة
• خطأ مخصص