مرجع القواعدمرجع
هذه الصفحة هي التفاصيل الدقيقة وراء القواعد: التحقق والمفاتيح — كيف تكتب بالضبط الشروط والمقارنات والقيم الافتراضية. لقائمة كل أنواع القواعد انظر تلك الصفحة؛ ولتحويل المال والوحدات انظر تحويل العملات والوحدات.
القواعد الشرطية — نوع القاعدة conditional (أو اسمه الآخر validation) — تطبّق قاعدة فقط عندما يتحقق شرط: إيصال مطلوب فقط فوق 100، أو سبب مطلوب فقط عند رفض مطالبة. الصيغ الثلاث التالية تُقرأ بالمعنى نفسه:
required if <condition>[if] <condition> [then] required(<condition>) then required— مثلًا(total > 100) then required
| العامل | المعنى |
|---|---|
is = == | يساوي |
is not != <> | لا يساوي |
> >= | أكبر من · أكبر أو يساوي (يدرك التواريخ والأرقام) |
< <= | أصغر من · أصغر أو يساوي |
ادمج الشروط بـAND أو OR أو XOR. الأولوية الأقوى لـAND، ثم XOR، ثم OR. والقيمة المقتبسة التي تحوي إحدى هذه الكلمات لا تُقسَّم أبدًا — "Research and Development" تبقى كما هي.
| يمكن أن تكون القيمة | المعنى |
|---|---|
123 | رقمًا |
"Active" | نصًا بين علامتي اقتباس |
2026-07-01 | تاريخًا يُكتب سنة-شهر-يوم |
start_date | قيمة حقل آخر |
empty | صحيحةً عندما يكون الحقل فارغًا (دون اقتباس؛ أما "empty" المقتبسة فتعني الكلمة نفسها حرفيًا) |
system date | تاريخ الحفظ — وأيضًا current date وtoday وnow |
current year | السنة الحالية (مثل 2026) — وأيضًا this year؛ لحقول year |
current month | الشهر الحالي بصيغة YYYY-MM (مثل 2026-07) — لحقول month |
<date>.year | جزءًا تقويميًا من حقل تاريخ آخر — وأيضًا .month و.day و.quarter و.week |
HEADER.status أو status from HEADER — كي تستطيع قاعدة على بند أن تقرأ قيمة من الترويسة. وتُطابَق أسماء الحقول بتسامح — حالة الأحرف والمسافات والأخطاء الإملائية القريبة كلها تمرّ.المقارنات والنطاقات. في قاعدة required (أو كقيمة conditional مجرّدة)، يمكن أن تحمل خلية Value مقارنة — بالكلمات أو بالرموز — تُفحَص مقابل قيمة الحقل نفسه:
| خلية Value | تعني |
|---|---|
greater or equal to start_date | القيمة ≥ start_date |
less than 100 | القيمة < 100 |
>= start_date | الصيغة الرمزية للمعنى نفسه |
equal to X · not equal to X | يجب أن تطابق / يجب أن تختلف |
between <low> and <high> | نطاق يشمل الحدّين (نوع القاعدة between) |
يمكنك كتابة الاتجاه بكلمات عادية أيضًا — وكل منها يقبل بعده or equal to اختياريًا. والطرف الذي تقارن به قد يكون رقمًا، أو تاريخًا، أو نصًا بين علامتي اقتباس، أو حقلًا آخر، أو كلمات "اليوم"؛ كما تعمل current year وcurrent month وجزء التاريخ مثل field.year:
| الكلمات | الاتجاه |
|---|---|
| greater · more · later · after | أعلى، أو لاحقًا في الزمن |
| less · smaller · earlier · before | أدنى، أو أسبق في الزمن |
القيم الافتراضية. يمكن لخلية Value في أي قاعدة أن تملأ الحقل مسبقًا، فيقلّ ما يكتبه الناس وتبدأ السجلات متّسقة. النص الثابت يبقى كما كُتب؛ أما الإشارة أو الحساب فيُحسبان عند فتح النموذج (أو صف بند جديد):
| خلية Value | تملأ بـ |
|---|---|
default value "Created" | النص الحرفي "Created" |
default = 0 | الرقم 0 |
default = HEADER.currency_code | قيمة منسوخة من حقل آخر |
default = amount / 100 | حساب |
system date · today · now | تاريخ إنشاء السجل — اقرنه بـdisplay لعرضه للقراءة فقط |