> ## 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.

# التجميع

> اجمع القيم من السجلات المرتبطة، مثل المجموع والعدد والمتوسط والقيمة القصوى والقيمة الدنيا.

تحسب حقول التجميع إحصاءات من عدة سجلات مرتبطة. يبدأ حقل التجميع عادةً من حقل **ارتباط** موجود، ويحدد حقلًا مستهدفًا من السجلات المرتبطة، ثم يحسب النتيجة باستخدام دالة مختارة.

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

| السيناريو    | مناسب لـ                                                       |
| ------------ | -------------------------------------------------------------- |
| مبلغ الطلب   | تجميع الأسعار من بنود الطلب لحساب إجمالي الطلب                 |
| تقدّم المهام | حساب عدد المهام المرتبطة أو المهام المكتملة أو متوسط التقييمات |
| قيمة العميل  | تجميع إجمالي الإنفاق أو عدد الطلبات من طلبات العميل            |
| تنظيف الوسوم | دمج الوسوم أو المشاركين أو قنوات المصدر من السجلات المرتبطة    |

## الإنشاء والتهيئة

<Steps>
  <Step title="إنشاء علاقة ارتباط">
    قبل إنشاء حقل تجميع، أنشئ حقل **ارتباط**.
  </Step>

  <Step title="اختيار نوع الحقل">
    انقر على `+` في رأس الجدول لإضافة حقل واختر **التجميع**.
  </Step>

  <Step title="اختيار حقل الارتباط والحقل المستهدف">
    اختر حقل الارتباط الذي يوفر مصدر البيانات، ثم اختر الحقل المستهدف المراد حسابه.
  </Step>

  <Step title="اختيار دالة التجميع">
    اختر دالة بناءً على نوع الحقل المستهدف، مثل المجموع أو العدد أو المتوسط أو القيمة القصوى أو القيمة الدنيا.
  </Step>
</Steps>

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

يمكن لنتائج التجميع عادةً استخدام إعدادات التنسيق والعرض التفاعلي:

* **التنسيق**: اضبط الدقة العشرية أو رموز العملات أو النسب المئوية.
* **العرض التفاعلي**: اعرض النتائج الرقمية على هيئة أشرطة أو حلقات أو أنماط عرض أخرى.

راجع [التنسيق](/ar/basic/field/common/formatter) و[العرض التفاعلي](/ar/basic/field/common/show-as) للاطلاع على التفاصيل.

## الاستخدامات الشائعة

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

## صيغ التجميع المدعومة

| اسم الصيغة     | الشرح                                                 |
| -------------- | ----------------------------------------------------- |
| COUNTALL       | يحسب جميع القيم، بما فيها القيم النصية والقيم الفارغة |
| COUNTA         | يحسب القيم غير الفارغة                                |
| COUNT          | يحسب العناصر الرقمية                                  |
| SUM            | يحسب مجموع كل القيم الرقمية                           |
| MAX            | يعيد أكبر قيمة رقمية                                  |
| MIN            | يعيد أصغر قيمة رقمية                                  |
| AND            | يعيد true إذا كانت جميع القيم true                    |
| OR             | يعيد true إذا كانت أي قيمة true                       |
| XOR            | يعيد true إذا كان عدد القيم التي تساوي true فرديًا    |
| ARRAY\_JOIN    | يربط جميع القيم في مصفوفة لتكوين سلسلة نصية           |
| ARRAY\_UNIQUE  | يزيل القيم المكررة ويعيد مصفوفة ذات قيم فريدة         |
| ARRAY\_COMPACT | يزيل القيم الفارغة ويعيد مصفوفة جديدة                 |
| CONCATENATE    | يربط عدة قيم لتكوين سلسلة نصية                        |

## ملاحظات

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