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

المدققون

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

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

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

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

حقل مطلوب (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)​

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

التعبير العادي

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

المقارنة (Comparison)​

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

المنطقية (Logical)​

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

الحجم (Size)​

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

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

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

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

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

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

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

أمثلة​

مثال على التحقق من حقل البريد الإلكتروني.​

في هذا المثال، سيتم إضافة قيمة سلسلة:

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

مثال على التحقق من حقل كلمة المرور.​

في هذا المثال، سيتم إضافة قيمة سلسلة:

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

مثال على التحقق من حقل الصورة.​

في هذا المثال، سيتم إضافة قيمة سلسلة:

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