> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# الصيغة

> أشر إلى حقول أخرى واحسب النصوص والأرقام والتواريخ والشروط المنطقية باستخدام الصيغ.

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

## حالات الاستخدام

| السيناريو       | مناسب لـ                                                                           |
| --------------- | ---------------------------------------------------------------------------------- |
| الحساب التلقائي | حساب السعر الإجمالي أو الربح أو الدرجة من الكمية وسعر الوحدة والخصم والحقول الأخرى |
| معالجة النصوص   | ضم النصوص أو استخراج المحتوى أو تحليل المعلومات حسب فاصل                           |
| معالجة التاريخ  | حساب فروق التواريخ أو التحقق من النطاقات الزمنية أو إنشاء تواريخ مستقبلية          |
| المنطق الشرطي   | إرجاع نتائج مختلفة بناءً على الشروط، مثل الحالة أو التلميحات أو الفئات             |

## أساسيات الصيغ

### أنواع البيانات

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

| النوع | الوصف                   | الاستخدامات الشائعة                     |
| ----- | ----------------------- | --------------------------------------- |
| رقم   | أعداد صحيحة أو عشرية    | العمليات الحسابية والتجميعات والمقارنات |
| نص    | قيم نصية                | الضم والاستخراج والاستبدال والتقسيم     |
| تاريخ | قيم تاريخ أو تاريخ ووقت | حساب الفواصل ومقارنة التواريخ           |
| منطقي | `TRUE` أو `FALSE`       | الشروط والعمليات المنطقية               |

### الإشارة إلى الحقول

في الصيغة، أشر إلى حقل آخر باسم الحقل. ضع اسم الحقل بين `{}` واجعله مطابقًا لاسم الحقل الفعلي:

```js theme={null}
{سعر الوحدة} * {الكمية}
```

### العوامل

| العامل | الاستخدام                                |
| ------ | ---------------------------------------- |
| `+`    | يحسب مجموع الأرقام أو يضم السلاسل النصية |
| `-`    | يحسب الفرق بين الأرقام                   |
| `*`    | يحسب حاصل ضرب الأرقام                    |
| `/`    | يحسب حاصل قسمة الأرقام                   |
| `%`    | يحسب باقي القسمة                         |

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

### الدوال الشائعة

تنفذ الدوال عمليات محددة. على سبيل المثال، تحسب `SUM` المجموع، وتستخرج `LEFT` الأحرف من بداية النص، وتستخرج `TEXTBEFORE` النص السابق لفاصل، وتقسّم `TEXTSPLIT` النص حسب فاصل.

راجع [ورقة الصيغ المرجعية](/ar/basic/field/formula/cheat-sheet) لمزيد من الدوال.

### معالجة النصوص

| العملية      | أمثلة للدوال                         | الوصف                              |
| ------------ | ------------------------------------ | ---------------------------------- |
| ضم النصوص    | `&`، `CONCATENATE`                   | يضم قيمتين نصيتين أو أكثر          |
| استخراج النص | `LEFT`، `RIGHT`، `MID`، `TEXTBEFORE` | يستخرج جزءًا من سلسلة نصية         |
| تقسيم النص   | `TEXTSPLIT`                          | يقسّم النص إلى قيم متعددة حسب فاصل |

### الشروط المنطقية

استخدم الدالة `IF` لإرجاع قيم مختلفة بناءً على شرط:

```js theme={null}
IF(condition, value_if_true, value_if_false)
```

عند التحقق مما إذا كان حقل فارغًا، قارنه مع `BLANK()`. على سبيل المثال، تُرجع `IF({الوزن}=BLANK(), 1, 2)` القيمة `1` عندما يكون حقل رقمي فارغًا، وتُرجع `2` خلاف ذلك.

### التعبيرات المعقدة

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

```js theme={null}
({سعر الوحدة} * {الكمية}) * (1 - {الخصم})
```

## عرض النتائج وصيانتها

### التنسيق والعرض التفاعلي

يمكن لنتائج الصيغ أيضًا استخدام إعدادات [التنسيق](/ar/basic/field/common/formatter) و[العرض التفاعلي](/ar/basic/field/common/show-as)، مثل النسبة المئوية أو شريط التقدم أو أنماط الأيقونات. وتعتمد الخيارات المتاحة على نوع نتيجة الصيغة.

### تصحيح الأخطاء والتحسين

* **التحقق من أنواع البيانات**: تأكد من أن العمليات والدوال تستخدم أنواع البيانات الصحيحة.
* **التحقق من مراجع الحقول**: تأكد من كتابة أسماء الحقول بصورة صحيحة.
* **الاختبار خطوة بخطوة**: قسّم الصيغ المعقدة إلى أجزاء أصغر واختبرها بصورة منفصلة.
* **تجنب العمليات الحسابية المتكررة**: إذا كان الحساب نفسه يُستخدم في عدة مواضع، ففكر في تخزين النتيجة في حقل منفصل.