قواعد التحقق

نظرة عامة

قاعدة التحقق هي شرط على سجل. عندما تُقيَّم إلى خطأ، يرفض Twenty السجل ويعرض رسالة القاعدة.

لا تُفرض قواعد التحقق إلا في مساحات العمل التي تتوفر فيها الميزة.

عرّف قاعدة باستخدام defineValidationRule من twenty-sdk/define:

import { defineValidationRule, ruleExpression } from 'twenty-sdk/define';

import { INVOICE_UNIVERSAL_IDENTIFIER } from '../objects/invoice.object';

const { and, field, gt, isNonEmptyString } = ruleExpression;

export default defineValidationRule({
  universalIdentifier: '8d3f2c6e-1b7a-4f0e-9c52-6a1e0d4b7f31',
  objectUniversalIdentifier: INVOICE_UNIVERSAL_IDENTIFIER,
  name: 'Invoice has an amount',
  expression: and(gt(field('amount'), 0), isNonEmptyString(field('reference'))),
  message: 'An invoice needs an amount and a reference',
});

يمكنك أيضًا إنشاء قالب أولي باستخدام واجهة سطر الأوامر:

twenty app add validation-rule --name invoice-has-amount --object <object-uuid>

الخاصية	مطلوب	الوصف
`universalIdentifier`	نعم	المعرّف الثابت للقاعدة
`objectUniversalIdentifier`	نعم	الكائن الذي تنطبق عليه القاعدة. يمكن أن يكون كائنًا من تطبيقك أو كائنًا قياسيًا.
`name`	نعم	الاسم المعروض في الإعدادات
`expression`	نعم	`ruleExpression` أو سلسلة نصية
`رسالة`	نعم	الرسالة المعروضة عند فشل القاعدة
`errorFieldUniversalIdentifier`	لا	الحقل الذي تُرفق به الرسالة. يجب أن ينتمي إلى كائن القاعدة.
`description`	لا	وصف أطول
`icon`	لا	اسم الأيقونة

كتابة التعبيرات

يوفر ruleExpression ما يلي:

تقرأ field('name') حقلاً، وتقرأ field('company.employees') حقلاً عبر علاقة متعدد إلى واحد.
now هو التاريخ والوقت الحاليان.
تجمع and وor وnot الشروط.
تقارن eq وnotEq وgt وgte وlt وlte القيم.
تحسب add وsubtract وmultiply وdivide القيم.
تتحقق isIn(field('stage'), ['NEW', 'WON']) من قيمة مقابل قائمة.
دوال مثل isNonEmptyString وisDefined.

ينتج المُنشئ سلسلة نصية عادية، وهي ما يكتبه twenty app pull مجددًا. يمكنك كتابة تلك السلسلة النصية مباشرةً:

expression: 'amount > 0 and isNonEmptyString(reference)',

تستخدم السلاسل النصية and وor وnot و== و!= و\< و\<= و> و>= و+ و- و* و/ وin [...]، وليس && أو ||. يوضع النص بين علامتي اقتباس مفردتين أو مزدوجتين. يمكن للقاعدة قراءة الحقول التي تعلنها، وحقول النظام التي يوفرها Twenty، مثل createdAt. تتحقق واجهة سطر الأوامر CLI من التعبيرات مقارنةً بكائنات تطبيقك نفسها. بالنسبة إلى كائن خارج تطبيقك، لا تتحقق إلا من البنية النحوية، ويتحقق الخادم من الحقول وقت المزامنة.

الحقول التي تصبح غير متاحة

الحالة	النتيجة
يزيل تطبيقك حقلاً تقرؤه قاعدته	تفشل المزامنة مع ظهور خطأ يذكر القاعدة والحقل
تعطّل مساحة عمل حقلاً خارج تطبيقك	تنجح المزامنة وتبقى القاعدة غير مفعلة
تحذف مساحة عمل حقلاً خارج تطبيقك، ويبقى تعبير قاعدتك دون تغيير	تنجح المزامنة وتبقى القاعدة غير مفعلة
تعيد مساحة عمل تسمية حقل خارج تطبيقك	تنجح المزامنة وتحتفظ بالقاعدة بالاسم الجديد، والذي يكتبه `twenty app pull` مجددًا
تسمي قاعدة جديدة أو معدلة حقلاً غير موجود	تفشل المزامنة
تحذف مساحة عمل حقل خطأ القاعدة	تنجح المزامنة ولا تعود القاعدة مرتبطة بذلك الحقل

تحتفظ المزامنة بـ isActive الخاص بقاعدة موجودة، لذا تظل القاعدة التي عطّلها مسؤول مساحة العمل غير مفعلة. القواعد الجديدة فقط تبدأ مفعلة.

المطورون

التطبيقات

واجهة برمجة التطبيقات

الاستضافة الذاتية

المساهمة

مكتبة واجهة المستخدم

نظرة عامة

كتابة التعبيرات

الحقول التي تصبح غير متاحة

​نظرة عامة

​كتابة التعبيرات

​الحقول التي تصبح غير متاحة

نظرة عامة

كتابة التعبيرات

الحقول التي تصبح غير متاحة