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

# جلب السجلات

> استرد السجلات من جدول باستخدام عوامل تصفية وترقيم صفحات اختياريين

<Tip>
  نوصي بشدة باستخدام «تشغيل برنامج نصي» لإنشاء عمليات الأتمتة، لأنه يستطيع تغطية جميع سلوكيات الإجراءات، بما فيها الإجراءات التي كان يلزم إنشاؤها يدويًا لولا ذلك. ما عليك سوى وصف متطلباتك للذكاء الاصطناعي في الدردشة.

  يُرجى ملاحظة أنه إذا أضفت إجراءات يدويًا، فلن يتعرف عليها الذكاء الاصطناعي أو يعدّلها لاحقًا.
</Tip>

## الإنشاء بالذكاء الاصطناعي

افتح دردشة الذكاء الاصطناعي في الشريط الجانبي الأيمن للجدول وصِف ما تريده.

يتولى الذكاء الاصطناعي كل شيء: يختار المشغّل المناسب، وينتقي الإجراءات الملائمة، ويربط الحقول، ويهيئ سير العمل بالكامل تلقائيًا.

صِف الهدف مرة واحدة، وسيصبح سير العمل جاهزًا دون الحاجة إلى إعداد يدوي.

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

## التهيئة

| الإعداد      | مطلوب | الوصف                                                                                              |
| ------------ | ----- | -------------------------------------------------------------------------------------------------- |
| الجدول       | نعم   | الجدول المطلوب الاستعلام منه                                                                       |
| طريقة العرض  | لا    | قصر النتائج على السجلات المرئية في طريقة عرض محددة (ترث عوامل التصفية والفرز والحقول المخفية منها) |
| عامل التصفية | لا    | شروط تصفية إضافية تُطبق فوق عامل تصفية طريقة العرض، إن وُجد                                        |
| التخطي       | لا    | عدد السجلات المطلوب تخطيها من البداية (لترقيم الصفحات)                                             |
| الأخذ        | لا    | الحد الأقصى لعدد السجلات المطلوب إعادتها (لترقيم الصفحات)                                          |

## كيفية الإعداد

1. أضف إجراء **جلب السجلات** إلى سير العمل.
2. اختر **الجدول** المطلوب الاستعلام منه. استخدم [الوصول عبر قواعد البيانات](/ar/basic/automation/actions/records/cross-base) إذا كان الجدول في قاعدة بيانات مختلفة.
3. (اختياري) اختر **طريقة عرض** لوراثة إعداداتها لعوامل التصفية والفرز ورؤية الحقول.
4. (اختياري) أضف شروط **عامل التصفية** لتضييق النتائج. مثلًا، `الحالة` تساوي `نشط` و`تاريخ الاستحقاق` قبل اليوم.
5. (اختياري) اضبط **التخطي** و**الأخذ** لترقيم الصفحات. مثلًا، اضبط التخطي على 0 والأخذ على 100 لجلب أول 100 سجل.
6. احفظ الإجراء. عند تشغيل سير العمل، ستتاح النتائج في مصفوفة للخطوات اللاحقة.

## المخرجات: التعامل مع النتائج

المخرجات هي **مصفوفة سجلات**. يتضمن كل سجل في المصفوفة:

* **معرّف السجل** — المعرّف الفريد.
* **جميع قيم الحقول** — كل حقل في الجدول (أو طريقة العرض، إذا اخترت واحدة).

### استخدام النتائج في الخطوة التالية

* **الإشارة إلى سجل واحد:** إذا كنت تتوقع نتيجة واحدة فقط (أو تريد الأولى)، فيمكنك الإشارة إلى حقول السجل الأول مباشرةً باستخدام منتقي المتغيرات **+**.
* **التكرار على جميع السجلات:** أضف إجراء [الحلقة (دفعة)](../logic/loop-run) بعد جلب السجلات، واختر مصفوفة النتائج مصدرًا للبيانات. وأشر داخل الحلقة إلى حقول كل عنصر.
* **المعالجة في برنامج نصي:** مرر المصفوفة إلى خطوة [تشغيل برنامج نصي](/ar/basic/automation/actions/ai/ai-script) للمعالجة أو التصفية أو التحويل المخصص.

## ترقيم الصفحات

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

| الإعداد | الغرض                                 | المثال                 |
| ------- | ------------------------------------- | ---------------------- |
| التخطي  | عدد السجلات المطلوب تخطيها من البداية | `0` (البدء من البداية) |
| الأخذ   | عدد السجلات المطلوب إعادتها           | `100` (إعادة 100 سجل)  |

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

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

* **البحث عن المهام المتأخرة لإرسال تذكيرات.** صفِّ المهام التي يسبق تاريخ استحقاقها اليوم ولا تساوي حالتها "مكتملة". كرر على النتائج وأرسل رسالة لكل منها.
* **جمع البيانات لملخص يومي.** استرد جميع السجلات المحدّثة خلال آخر 24 ساعة واجمعها في رسالة ملخص.
* **البحث عن سجلات مرتبطة قبل الإنشاء أو التحديث.** قبل إنشاء نسخة مكررة، تحقق مما إذا كان يوجد سجل بالبريد الإلكتروني نفسه.
* **تغذية البيانات إلى إجراء ذكاء اصطناعي.** اجلب سجلات ذات حقول نصية طويلة، ثم استخدم الإنشاء بالذكاء الاصطناعي داخل حلقة لتلخيص كل منها أو تصنيفه.
* **مزامنة السجلات مع نظام خارجي.** اجلب جميع السجلات التي تغيرت منذ آخر مزامنة، ثم ادفعها إلى CRM أو مستودع بيانات عبر طلبات HTTP.

## نصائح

* **استخدم عوامل التصفية.** كلما كان عامل التصفية أكثر تحديدًا، قل عدد السجلات المعادة وزادت سرعة الإجراء.
* **حدّ النتائج باستخدام الأخذ.** إذا كنت تحتاج إلى أول 10 سجلات فقط، فاضبط الأخذ على 10. لا حاجة إلى استرداد آلاف السجلات عندما تحتاج إلى عدد قليل.
* **اختر طريقة عرض** تصفّي البيانات التي تحتاج إليها وترتبها بالفعل، فهذا يبسط تهيئة الأتمتة.
* **تجنب جلب الجدول بالكامل** ما لم تكن تحتاج حقًا إلى جميع السجلات. تستغرق مجموعات النتائج الكبيرة وقتًا أطول وتستخدم موارد أكثر، خصوصًا عند دمجها مع حلقة.
* لا يعدّل جلب السجلات أي بيانات — فهو للقراءة فقط.
* إذا أعاد الاستعلام صفرًا من السجلات، فستتلقى الخطوات اللاحقة التي تشير إلى النتائج مصفوفة فارغة. تأكد من أن سير العمل يعالج ذلك بسلاسة (مثل عدم إرسال رسالة تقول "إليك نتائجك" عندما لا توجد نتائج).
* تعمل عوامل التصفية في جلب السجلات مثل عوامل تصفية طرق العرض: يمكنك دمج الشروط بمنطق AND/OR.
* عند استخدام الوصول عبر قواعد البيانات، يُنفذ الاستعلام بصلاحيات منشئ سير العمل. وإذا فقد المنشئ الوصول إلى قاعدة البيانات المستهدفة، فستفشل الخطوة.

## موضوعات ذات صلة

* [الوصول عبر قواعد البيانات](/ar/basic/automation/actions/records/cross-base) — الاستعلام من جداول في قواعد بيانات أخرى
* [الحلقة (دفعة)](../logic/loop-run) — التكرار على مصفوفة النتائج
* [إنشاء سجل](/ar/basic/automation/actions/records/create-record) — إنشاء سجلات استنادًا إلى البيانات المستردة
* [تحديث سجل](/ar/basic/automation/actions/records/update-record) — تحديث السجلات التي عثر عليها جلب السجلات