> ## Documentation Index
> Fetch the complete documentation index at: https://twenty-claude-cool-pascal-5ay683.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# الأسئلة الشائعة حول سير العمل

> الأسئلة الشائعة حول سير العمل في Twenty.

<AccordionGroup>
  <Accordion title="لماذا لا أستطيع تفعيل سير عمل؟">
    من المحتمل أن تكون مشكلة أذونات. تحتاج إلى صلاحية الوصول إلى سير العمل لإنشائها وتفعيلها.

    **الحل**: تواصل مع مسؤول مساحة العمل لمنحك صلاحية الوصول إلى سير العمل ضمن **الإعدادات → الأعضاء → الأدوار**.

    إذا لم ترَ قسم سير العمل إطلاقاً في الشريط الجانبي لديك، فهذا يؤكد أنها مشكلة أذونات.
  </Accordion>

  <Accordion title="لماذا لا أرى زر سير العمل اليدوي في شريط التنقل العلوي؟">
    تظهر عمليات سير العمل اليدوية في شريط التنقل فقط إذا تم إعدادها بشكل صحيح:

    1. يجب أن يكون سير العمل **مفعَّلاً** (ليس في وضع المسودة)
    2. يجب تعيين موضع شريط التنقل إلى **Pinned**
    3. بالنسبة لمشغلات Single/Bulk، يجب أن تكون في صفحة الكائن الصحيحة

    **للتحقق**: افتح سير العمل → انقر المشغل → تأكد من أن "Navbar placement" معيّن إلى "Pinned".

    يمكنك دائماً الوصول إلى عمليات سير العمل اليدوية عبر **Cmd + K** (أو **Ctrl + K**) بغض النظر عن إعدادات شريط التنقل.
  </Accordion>

  <Accordion title="ما الفرق بين المشغلات اليدوية Single وGlobal وBulk؟">
    | النوع         | السجلات المطلوبة  | عمليات تشغيل سير العمل             |
    | ------------- | ----------------- | ---------------------------------- |
    | \| **Global** | لا شيء            | مرة واحدة، دون إدخال سجل           |
    | \| **Single** | واحد أو أكثر محدد | مرة لكل سجل محدد                   |
    | \| **Bulk**   | واحد أو أكثر محدد | مرة واحدة، مع جميع السجلات كمصفوفة |

    * **Global**: استخدمه عندما لا يحتاج سير العمل إلى سياق أي سجل (مثال: إنشاء تقرير)
    * **Single**: استخدمه عندما تريد معالجة كل سجل محدد بشكل مستقل (مثال: إرسال رسائل بريد إلكتروني فردية)
    * **Bulk**: استخدمه عندما تحتاج إلى معالجة السجلات معاً أو تحسين استخدام الرصيد (يتطلب إجراء Iterator)

    راجع [مشغلات سير العمل](/l/ar/user-guide/workflows/capabilities/workflow-triggers) للحصول على التفاصيل.
  </Accordion>

  <Accordion title="لا أرى عقدة If/Else. ماذا يجب أن أفعل؟">
    عقدة If/Else صريحة غير متاحة بعد، لكنها ضمن خارطة الطريق لدينا.

    **الحل المؤقت الحالي**: أنشئ عدة فروع من خطوتك، يبدأ كل منها بإجراء **Filter**:

    ```
    Step 1
       │
       ├── Branch A: Filter (condition = true) → Actions...
       │
       └── Branch B: Filter (condition = false) → Actions...
    ```

    فقط الفرع الذي يمر فيه شرط التصفية سيُنفِّذ إجراءاته اللاحقة.

    راجع [كيفية استخدام الفروع](/l/ar/user-guide/workflows/capabilities/workflow-branches) للحصول على دليل خطوة بخطوة.
  </Accordion>

  <Accordion title="هل تعمل فروع سير العمل بالتوازي؟">
    **نعم**، تعمل الفروع بالتوازي افتراضياً.

    إذا كنت تريد تنفيذ فرع واحد فقط:

    * أضف إجراء **Filter** في بداية كل فرع
    * عيّن شروطاً متعاكسة (مثال: Branch A: status = "Open", Branch B: status ≠ "Open")

    الفروع التي لا تستوفي شرط التصفية تتوقف عن التنفيذ، بينما تستمر الفروع الأخرى.
  </Accordion>

  <Accordion title="هل يمكنني دمج الفروع معاً مرة أخرى؟">
    **نعم**. بعد اكتمال فروعك المتوازية، يمكنك إضافة خطوة يتصل بها الفرعان.

    في محرر سير العمل:

    1. أكمل إجراءات الفروع
    2. أضف خطوة جديدة بعد الفروع
    3. اسحب الاتصالات من نهاية كل فرع إلى هذه الخطوة الجديدة

    ستُنفَّذ الخطوة المدمجة بعد اكتمال جميع الفروع المتصلة.
  </Accordion>

  <Accordion title="ما الحد الأقصى لنتائج Search Records؟">
    **تعيد Search Records بحد أقصى 200 سجل.**

    إذا كنت بحاجة إلى معالجة المزيد:

    * أضف عوامل تصفية أكثر تحديداً لتقليل النتائج
    * استخدم سير عمل مجدولاً للمعالجة على دفعات
    * فكّر في استخدام الـAPI للعمليات المجمّعة

    بالنسبة لمعظم سير العمل، يكفي 200 سجل. إذا بلغت هذا الحد بشكل متكرر، فكر في إعادة هيكلة الأتمتة لديك.
  </Accordion>

  <Accordion title="هل يمكنني إضافة CC إلى الأشخاص في رسائل البريد الخاصة بسير العمل؟">
    **ليس بعد.** حقولا CC وBCC لإجراء Send Email على خارطة الطريق لدينا.

    **الحل المؤقت الحالي**: أضف عدة إجراءات Send Email للإرسال إلى مستلمين إضافيين، أو استخدم HTTP Request للإرسال عبر خدمة بريد إلكتروني خارجية تدعم CC.
  </Accordion>

  <Accordion title="كيف أستخدم مخرجات الخطوات السابقة؟">
    كل إجراء ينتج بيانات مخرجات يمكن استخدامها في الخطوات اللاحقة.

    **للإشارة إلى بيانات الخطوات السابقة**:

    * استخدم أداة اختيار المتغير عند تكوين حقل
    * أو اكتب `{{stepName.fieldName}}` مباشرةً

    **أمثلة**:

    * بيانات المشغل: `{{trigger.object.email}}`
    * نتائج البحث: `{{searchRecords[0].name}}`
    * مخرجات الكود: `{{code.calculatedValue}}`

    مرّر المؤشر فوق أي حقل في تكوين الإجراء لرؤية المتغيرات المتاحة من الخطوات السابقة.
  </Accordion>

  <Accordion title="لماذا يفشل Iterator لدي؟">
    **Iterator يتطلب مُدخلًا من نوع مصفوفة.** مشكلات شائعة:

    1. **المدخل ليس مصفوفة**: تأكد من أنك تمرر نتائج من Search Records أو إجراء آخر يُرجع مصفوفة
    2. **المصفوفة فارغة**: أضف عامل تصفية قبل Iterator للتحقق من `{{searchRecords.length}} > 0`
    3. **تم اختيار متغير خاطئ**: تأكد من اختيارك للمصفوفة نفسها، وليس سجلاً واحداً

    **الإعداد الصحيح**:

    1. Search Records (تُرجع مصفوفة)
    2. Filter: length > 0
    3. Iterator: اختر `{{searchRecords}}`
    4. الإجراءات داخل Iterator تستخدم `{{iterator.currentItem.fieldName}}`
  </Accordion>

  <Accordion title="ما أقصى وقت تنفيذ لإجراءات Code؟">
    إجراءات Code (دوال منطقية) لديها **مهلة افتراضية قدرها 5 دقائق** (300 ثانية).

    أقصى مهلة يمكن ضبطها هي **15 دقيقة** (900 ثانية).

    إذا تجاوز الكود هذا الحد، سيفشل الإجراء بخطأ انتهاء المهلة.

    **نصائح لتجنب انتهاء المهلة**:

    * قسّم العمليات الكبيرة إلى أجزاء أصغر باستخدام Iterator
    * تجنب العمليات الحسابية الثقيلة؛ استخدم خدمات خارجية عبر HTTP Request للمعالجة المكثفة
    * حسّن الكود لديك لتقليل وقت التنفيذ
    * إذا كنت بحاجة إلى معالجة أطول، ففكّر في استخدام سير عمل مجدول يعالج البيانات على دفعات
  </Accordion>

  <Accordion title="كيف أقرأ تشغيلات سير العمل؟">
    تعرض تشغيلات سير العمل سجل التنفيذ وتساعدك على تصحيح المشكلات.

    **الوصول إلى التشغيلات**:

    * في محرر سير العمل → لوحة **التشغيلات** على اليمين
    * أو انتقل إلى **تشغيلات سير العمل** في الشريط الجانبي

    **فهم التشغيل**:

    * **الحالة**: قيد التشغيل، مكتمل، فشل، في الانتظار
    * **الخطوات**: اطّلِع على الخطوات التي تم تنفيذها ومخرجاتها
    * **الأخطاء**: انقر الخطوات الفاشلة لرؤية رسائل الخطأ
    * **البيانات**: اعرض بيانات الإدخال/الإخراج في كل خطوة

    راجع [تشغيلات سير العمل](/l/ar/user-guide/workflows/capabilities/workflow-runs) للحصول على التفاصيل.
  </Accordion>

  <Accordion title="لماذا لا أرى تشغيلات سير العمل الخاصة بي؟">
    قد تفشل تشغيلات سير العمل فوراً بسبب حدود المعدل. تفرض Twenty حداً صارماً يبلغ 5,000 عملية تشغيل في الساعة لكل مساحة عمل.

    إذا تجاوزت هذا الحد، ستُعلَّم عمليات سير العمل فوراً كفاشلة ولن تظهر في قائمة عمليات التشغيل لديك.

    **سيناريوهات شائعة تصل إلى هذا الحد**:

    * اختيار أكثر من 5,000 سجل باستخدام مشغل يدوي Single
    * تشغيل عدة سير عمل بالتزامن عبر مساحة العمل
    * مشغلات آلية عالية التكرار (مثال: Record Updated على كائن مزدحم)

    **حلول**:

    * استخدم مشغلات **Bulk** بدلاً من Single لمعالجة العديد من السجلات في تشغيل واحد
    * وزّع العمليات الدفعية الكبيرة زمنياً
    * استخدم عوامل تصفية لتقليل تكرار المشغل
    * قم بجدولة سير العمل الثقيلة خلال ساعات خارج أوقات الذروة
  </Accordion>

  <Accordion title="ما هي حدود معدل سير العمل؟">
    لدى Twenty حدّان للمعدل لضمان استقرار النظام:

    | الحد           | القيمة           | السلوك                                                        |
    | -------------- | ---------------- | ------------------------------------------------------------- |
    | \| **حد مرن**  | 100 تشغيل/دقيقة  | تُصفّ في قائمة الانتظار بحالة "Not Started" وتُعالَج تدريجياً |
    | \| **حد صارم** | 5,000 تشغيل/ساعة | تفشل التشغيلات فوراً                                          |

    **الحد المرن (100/دقيقة)**: لن تفشل سير العمل لديك—ستنتظر فقط في قائمة الانتظار وتُعالَج بمرور الوقت. يمكنك تشغيل أكثر من 100 سجل؛ سيكون التنفيذ أبطأ.

    **الحد الصارم (5,000/ساعة)**: ينطبق هذا على مساحة العمل بالكامل. إذا تجاوز مجموع تشغيلات جميع سير العمل لديك 5,000 تشغيل في ساعة واحدة، فسوف تفشل التشغيلات الإضافية فوراً.

    **نصائح للبقاء ضمن الحدود**:

    * استخدم مشغلات Bulk مع Iterator بدلاً من مشغلات Single للدفعات الكبيرة
    * ادمج الأتمتة ذات الصلة في عدد أقل من سير العمل
    * استخدم سير عمل مجدولة لتوزيع الحمل بمرور الوقت
  </Accordion>

  <Accordion title="هل يمكنني إعادة محاولة تشغيل سير عمل فاشل؟">
    **لا، لا توجد حالياً وظيفة إعادة المحاولة التلقائية.**

    إذا فشل تشغيل سير عمل، فستحتاج إلى:

    1. راجع الخطأ في **الإعدادات → سير العمل → \[سير العمل الخاص بك] → التشغيلات**
    2. أصلِح المشكلة (البيانات، الإعداد، أو الخدمة الخارجية)
    3. قم بتشغيل سير العمل يدوياً مرة أخرى على السجل/السجلات المتأثرة

    **نصائح لتقليل حالات الفشل**:

    * أضف عقد **Filter** للتحقق من البيانات قبل الإجراءات
    * استخدم **Search Records** للتحقق مما إذا كانت السجلات ذات الصلة موجودة
    * اختبر بدقة باستخدام عدد قليل من السجلات قبل العمليات المجمّعة

    وظيفة إعادة المحاولة التلقائية ضمن خارطة الطريق لإصدار مستقبلي.
  </Accordion>

  <Accordion title="هل يجب إلغاء تفعيل سير العمل قبل استيراد CSV؟">
    **نعم، إذا كانت سير العمل لديك تُشغَّل بإنشاء السجلات أو تحديثها.**

    عند استيراد البيانات عبر CSV، يمكن لكل سجل يتم إنشاؤه أو تحديثه تشغيل سير العمل. قد يؤدي الاستيراد الكبير (آلاف السجلات) إلى:

    * بلوغ حد 5,000 تشغيل/ساعة
    * استهلاك قدر كبير من اعتمادات سير العمل
    * إرسال رسائل بريد إلكتروني أو إشعارات غير متوقعة
    * إنشاء مهام أو سجلات مكررة

    **قبل الاستيراد الكمي**:

    1. اذهب إلى **الإعدادات → سير العمل**
    2. حدّد سير العمل المُشغَّلة بواسطة الكائن الذي تقوم باستيراده
    3. **عطِّلها** مؤقتاً
    4. شغّل استيراد CSV الخاص بك
    5. **أعد تفعيل** سير العمل عند الانتهاء

    **بديل**: إذا كنت تحتاج إلى أن تعمل سير العمل على البيانات المستوردة، فقم بالاستيراد على دفعات أصغر للبقاء ضمن حدود المعدل.
  </Accordion>

  <Accordion title="كيف أرتّب مخطط سير العمل؟">
    إذا بدا مخطط سير العمل لديك فوضوياً مع تشتت العقد، فيمكنك تنظيمه تلقائياً:

    1. انقر بزر الفأرة الأيمن في أي مكان على مخطط سير العمل
    2. انقر **Tidy up workflow**

    سيؤدي ذلك إلى إعادة ترتيب جميع العقد تلقائياً في مخطط نظيف ومنظم.
  </Accordion>
</AccordionGroup>