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

# Asana

> فهرسة المهام والتعليقات من مشاريع Asana

## كيف يعمل

يسحب موصل Asana المهام والتعليقات المرتبطة بها من مشاريع محددة أو جميع المشاريع في مساحة عمل.

## الإعداد

### التفويض

<Steps>
  <Step title="إنشاء رمز الوصول الشخصي">
    * سجل الدخول إلى حساب Asana الخاص بك وانتقل إلى [https://app.asana.com/0/my-apps](https://app.asana.com/0/my-apps)
    * انقر على "Create New Personal Access Token"
    * أعطِه اسمًا (مثل "Gorbit Integration") وأنشئ الرمز
    * انسخ الرمز — ستحتاج إلى تقديمه لـ Gorbit
  </Step>
</Steps>

### الفهرسة

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

  <Step title="قدم التكوين">
    * **Asana API Token**: الصق رمز الوصول الشخصي الذي أنشأته سابقًا
    * **Workspace ID**: أدخل معرف مساحة عمل Asana الخاص بك. يمكنك العثور عليه على [https://app.asana.com/api/1.0/workspaces](https://app.asana.com/api/1.0/workspaces). إنه رقم يبدو مثل 1234567890123456.
    * **Project IDs** (اختياري): إذا كنت تريد فهرسة مشاريع محددة، أدخل معرفاتها مفصولة بفواصل. اترك هذا فارغًا لفهرسة جميع المشاريع في مساحة العمل. مثال: 1234567890123456,2345678901234567. يمكنك العثور على معرف المشروع بالنقر على مشروع في Asana. في عنوان URL، سيبدو مثل [https://app.asana.com/0/1208338159336610/1208338159510597،](https://app.asana.com/0/1208338159336610/1208338159510597،) حيث "1208338159336610" هو معرف المشروع.
    * **Team ID** (اختياري): إذا كنت تريد فهرسة المهام المرئية للفريق بالإضافة إلى المهام العامة،
      أدخل معرف الفريق. اترك هذا فارغًا إذا لم تكن بحاجة إلى هذه الميزة.
  </Step>

  <Step title="ابدأ الفهرسة">
    انقر على "Connect" لبدء عملية الفهرسة
  </Step>
</Steps>

ملاحظة: سيحترم الموصل أذونات المستخدم المرتبط برمز API المقدم.
تأكد من أن هذا المستخدم لديه حق الوصول إلى جميع المشاريع التي تريد فهرستها.