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

# Airtable

> الوصول إلى الجداول من Airtable

## كيف يعمل

يقوم موصل Airtable بفهرسة السجلات من قواعد بيانات Airtable الخاصة بك. يصبح كل سجل مستندًا قابلًا للبحث في Gorbit،
مع الحفاظ على أسماء وقيم الحقول.

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

يتم سحب تحديثات الجدول كل 24 ساعة افتراضيًا.

## الإعداد

### 1. إنشاء رمز الوصول الشخصي

<Steps>
  <Step title="افتح Builder Hub">
    في Airtable، انقر على **أيقونة الملف الشخصي** في الزاوية العلوية اليمنى وحدد **Builder Hub**.
  </Step>

  <Step title="انتقل إلى رموز الوصول الشخصية">
    في الشريط الجانبي لـ Builder Hub، انقر على **Personal access tokens**، ثم انقر على **Create new token**.
  </Step>

  <Step title="تكوين النطاقات">
    أعطِ رمزك اسمًا (مثل "Gorbit") وأضف النطاقات التالية:

    * `data.records:read` — قراءة بيانات السجلات
    * `data.recordComments:read` — قراءة تعليقات السجلات
    * `schema.bases:read` — قراءة مخططات القواعد والجداول
    * `user.email:read` — قراءة عناوين البريد الإلكتروني للمستخدمين (لحقول المتعاونين)
  </Step>

  <Step title="منح الوصول إلى قواعدك">
    تحت **Access**، امنح الرمز الوصول إلى جميع القواعد التي تريد فهرستها في Gorbit.

    إذا كنت تخطط لاستخدام خيار **الكل**، تأكد من أن الرمز لديه حق الوصول إلى كل قاعدة تريد تضمينها.
  </Step>

  <Step title="إنشاء ونسخ الرمز">
    انقر على **Create token** وانسخه. لن تتمكن من رؤيته مرة أخرى.
  </Step>
</Steps>

### 2. إضافة الموصل في Gorbit

<Steps>
  <Step title="افتح موصل Airtable">
    انتقل إلى لوحة الإدارة وحدد موصل **Airtable**.
  </Step>

  <Step title="إنشاء بيانات اعتماد">
    أنشئ بيانات اعتماد جديدة والصق رمز الوصول الشخصي الخاص بك.
  </Step>

  <Step title="اختر ما تريد فهرسته">
    لديك خيران:

    **الكل** — يكتشف ويفهرس تلقائيًا جميع القواعد والجداول التي يمكن لرمزك الوصول إليها.
    لا حاجة لتكوين إضافي.

    **جدول محدد** — يفهرس جدولًا واحدًا. لاستخدام هذا الخيار:

    * افتح الجدول الذي تريده في Airtable في متصفحك.
    * انسخ عنوان URL من شريط العناوين (يبدو مثل `https://airtable.com/appXXX/tblYYY/viwZZZ`).
    * الصقه في حقل **Airtable URL**.

    يتم استخراج معرف القاعدة ومعرف الجدول ومعرف العرض تلقائيًا من عنوان URL.
  </Step>
</Steps>

### خيارات متقدمة

* **معاملة جميع الحقول باستثناء المرفقات كبيانات وصفية** — عند التمكين، يتم تخزين الحقول النصية (مثل "العنوان" أو "الوصف")
  كأزواج قيم-مفاتيح للبيانات الوصفية بدلاً من محتوى المستند القابل للبحث.
  فقط محتويات ملفات المرفقات تصبح المحتوى القابل للبحث للمستند.
  استخدم هذا عندما يكون المحتوى الأساسي الذي تهتم به في ملفات المرفقات،
  والأعمدة الأخرى هي مجرد تسميات أو فئات.

* **Share ID** (للجدول المحدد فقط) — إذا كنت تريد أن تستخدم روابط السجلات في Gorbit عنوان URL لعرض مشترك، أدخل معرف المشاركة هنا (مثل `shrkfjEzDmLaDtK83`). يمكنك العثور على هذا عن طريق إنشاء عرض مشترك في Airtable.