## 🔁 الدوال العامة والمرجعية

دوال تشير إلى قطعة بيانات — حقل، أو صف مرتبط، أو الصف الحالي نفسه — أو تدمج قيمًا دون أن تقتصر على نوع بيانات واحد.

| الدالة       | الوصف                                                                   | الصياغة                                               | المعاملات                                                                                                                          | مثال                                                     |
| ------------ | ----------------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| `FIELD`      | يُرجع قيمة حقل آخر في الصف نفسه، حسب الاسم.                             | `FIELD(Field Name)`                                   | **Field Name** — اسم الحقل المراد استرجاعه.                                                                                        | `FIELD('Priority') = 'High'`                             |
| `LOOKUP`     | يُرجع قيمة (أو قيم) حقل في جدول مرتبط، للصفوف المتصلة عبر حقل ربط.      | `LOOKUP(Link Field Name, Field Name in Linked Table)` | **Link Field Name** — حقل الربط المتصل بالجدول الآخر.<br>**Field Name in Linked Table** — الحقل المراد استرجاعه من الجدول المرتبط. | `LOOKUP('Assigned To', 'Full Name') = 'Fahad Al-Otaibi'` |
| `ROW_ID`     | يُرجع الرقم التعريفي الفريد للصف الحالي. لا تأخذ أي مدخلات.             | `ROW_ID()`                                            | *لا شيء.*                                                                                                                          | `CONCAT('Row ', ROW_ID()) = 'Row 1'`                     |
| `CONCAT`     | يدمج أي عدد من القيم — نصوص أو أرقام أو نتائج صيغ أخرى — في نص واحد.    | `CONCAT(Value, Value, ...)`                           | **Value** — أي عدد من النصوص أو الأرقام أو نتائج الصيغ المراد دمجها.                                                               | `CONCAT(ROW_NUMBER, '- ', FIELD('Name')) = '1- Fahad'`   |
| `WHEN_EMPTY` | يُرجع قيمة بديلة عند فراغ المعامل الأول؛ وإلا يُرجع المعامل الأول نفسه. | `WHEN_EMPTY(Value, Default Value)`                    | **Value** — القيمة المراد فحصها.<br>**Default Value** — القيمة البديلة عند الفراغ.                                                 | `WHEN_EMPTY(FIELD('Nickname'), 'N/A')`                   |
| `MINUS`      | يطرح الرقم الثاني من الأول. يماثل العامل `-`.                           | `MINUS(Number, Number)`                               | **Number 1** — الرقم المطروح منه.<br>**Number 2** — الرقم المطروح.                                                                 | `MINUS(3, 1) = 2`                                        |