قواعد التحقق

​

ما هي قواعد التحقق؟

قاعدة التحقق هي شرط يجب أن يكون صحيحًا قبل أن يمكن إنشاء سجل أو تحديثه. إذا كان الشرط غير صحيح، يمنع Twenty الحفظ ويعرض رسالة تشرح ما الذي يجب تغييره. استخدم القواعد لطلب المعلومات في الوقت المناسب، مثل مبلغ قبل أن تصبح الفرصة عميلاً، أو لمنع القيم غير المتسقة، مثل تاريخ انتهاء قبل تاريخ بدء.

​

إنشاء قاعدة تحقق

1. انتقل إلى الإعدادات → نموذج البيانات وحدد الكائن الذي تريد تكوينه.
2. افتح علامة التبويب الإعدادات، واعثر على قواعد التحقق، وانقر على إضافة قاعدة.
3. امنح القاعدة اسمًا ووصفًا اختياريًا لشرح الغرض منها.
4. اكتب شرطًا. ابدأ بكتابة اسم حقل أو دالة، وحدد اقتراحات من لوحة المساعدة.
5. ضمن الخطأ، أدخل رسالة توضّح للمستخدمين كيفية إصلاح السجل. استخدم إظهار على لإرفاقها بحقل محدد أو حدد السجل بالكامل.
6. تحقق من المعاينة لمعرفة كيفية تصرف الشرط على السجلات الحالية.
7. انقر على تنشيط لبدء فرض القاعدة.

تظل القواعد الجديدة غير نشطة حتى تقوم بتنشيطها. تحتاج القاعدة إلى اسم وشرط صالح ورسالة خطأ قبل أن يمكن تنشيطها.

​

معاينة قاعدتك

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

​

اكتب شرطًا

اكتب الشرط الذي يسمح بالحفظ. على سبيل المثال، يسمح employees > 0 بحفظ شركة فقط عندما يكون عدد موظفيها أكبر من صفر. استخدم أسماء الحقول مثل employees، بدلًا من تسميات العرض مثل الموظفون. يؤدي تحديد حقل من المساعد إلى إدراج المرجع الصحيح. ضع النص بين علامتَي اقتباس مفردتين أو مزدوجتين، واستخدم الأقواس لتجميع الشروط. استخدم and وor بدلا من && و||.

​

التحقق من القيم المفقودة

لجعل حقل مطلوبا، استخدم not isEmpty(fieldName). ينطبق هذا أيضا على الحقول المركبة، مثل عناوين البريد الإلكتروني والعناوين.

​

الإشارة إلى الحقول المركبة والمرتبطة

استخدم نقطة لقراءة جزء من حقل مركب، مثل name.firstName أو amount.amountMicros. يمكنك أيضا قراءة حقل عبر علاقة متعدد إلى واحد، مثل company.name لشخص. حدد الحقول من المساعد للعثور على المسارات المتاحة. تُخزَّن مبالغ العملة بالمايكرو: وحدة عملة واحدة تساوي 1000000 مايكرو. على سبيل المثال، يتطلب amount.amountMicros >= 100000000 مبلغا لا يقل عن 100 بعملة السجل. بالنسبة إلى حقول الاختيار، قارن قيمة الخيار المخزنة، مثل 'CUSTOMER'، بدلا من تسمية العرض الخاصة بها. تحقق من أمثلة المساعد لمعرفة القيم المتاحة في حقلك.

​

قواعد نموذجية

كيّف أسماء الحقول وقيم الخيارات مع نموذج بياناتك. الحقول startDate وendDate وtags أدناه أمثلة على حقول مخصصة. يستخدم مثال الفرصة or لجعل متطلب المبلغ مشروطا: يمكن حفظ المراحل الأخرى دون مبلغ.

​

متى يتم التحقق من القواعد

يتم التحقق من القواعد النشطة عند إنشاء السجلات أو تحديثها، بما في ذلك التغييرات التي تُجرى عبر API والاستيرادات وسير العمل. يجب أن يجتاز السجل جميع القواعد النشطة لكائنه حتى يتم حفظه. لا يؤدي تنشيط قاعدة إلى تغيير السجلات الحالية. يجب تصحيح السجل الذي لا يستوفي الشرط الجديد في المرة التالية التي يُحفظ فيها. يتم تقييم الشرط الذي يقرأ سجلا مرتبطا عند حفظ السجل الذي تنتمي إليه القاعدة. لا تؤدي إزالة السجل المرتبط وحدها إلى إعادة التحقق منه.

​

تعديل قاعدة أو تعطيلها أو حذفها

ارجع إلى الإعدادات → نموذج البيانات → الكائن الخاص بك → الإعدادات → قواعد التحقق، ثم انقر فوق القاعدة.

• تعديل: حدّث الشرط أو الرسالة، وتحقق من المعاينة، ثم انقر فوق حفظ. بالنسبة إلى قاعدة غير نشطة، يكون هذا الزر هو تنشيط.
• تعطيل: في منطقة الخطر، انقر فوق تعطيل لإيقاف فرض القاعدة مع الاحتفاظ بتكوينها. انقر فوق تمكين لفرضها مرة أخرى.
• حذف: في منطقة الخطر، انقر فوق حذف وأكّد لإزالة القاعدة نهائيا. لا تتغير السجلات الحالية.

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