Files
twenty/packages/twenty-docs/l/ar/user-guide/workflows/workflow-troubleshooting.mdx
T
github-actions[bot] b1ef395627 i18n - docs translations (#16160)
Created by Github action

Co-authored-by: github-actions <github-actions@twenty.com>
2025-11-27 23:20:41 +01:00

130 lines
8.0 KiB
Plaintext

---
title: استكشاف مشكلات سير العمل وإصلاحها
info: استخدم تقنيات استكشاف الأخطاء وإصلاحها ونصائح تحسين الأداء لتصحيح وتحسين مهام سير العمل لديك.
image: /images/user-guide/what-is-twenty/20.png
sectionInfo: أتمتة العمليات والاندماج مع الأدوات الخارجية
---
<Frame>
<img src="/images/user-guide/what-is-twenty/20.png" alt="Header" />
</Frame>
## استكشاف الأخطاء باستخدام عمليات سير العمل
استخدم واجهة **عمليات سير العمل** لاستكشاف المشاكل:
- الوصول عبر لوحة **العمليات** في محرر سير العمل
- انقر على العمليات الفردية لرؤية بيانات الإدخال/الإخراج لكل خطوة
- تحقق من حالة التنفيذ، رسائل الخطأ، وتدفق البيانات بين الخطوات
## المشاكل الشائعة والحلول
### لم يتم تشغيل سير العمل
**المشكلة**: لا يتم تنفيذ سير العمل عند توقعه.
**حلول**:
- تحقق من أن سير العمل **نشط** (وليس في وضع المسودة)
- تأكد من تطابق إعداد التشغيل مع بنية بياناتك
- بالنسبة لمحركات السجل، تأكد من تحديد الكائن والحقول الصحيحة
- بالنسبة لمحفزات الويب هوك، تحقق من عنوان URL وتنسيق البيانات المتوقعة
- بالنسبة لمحركات الجدولة، تحقق من تكوين التوقيت
### النماذج غير قابلة للوصول
**المشكلة**: من الصعب العثور على إجراءات النماذج أو الوصول إليها في سير العمل الآلي.
<Warning>
النماذج مصممة حاليًا لتشغيل يدوي فقط. بالنسبة لمهام سير العمل مع محركات أخرى (سجل تم إنشاؤه، تم تحديثه، إلخ)، يمكن الوصول إلى النماذج فقط من خلال واجهة تشغيل سير العمل، وهو ليس التجربة المتوقعة. سيتم إصدار مركز الإشعارات في عام 2026 لدعم النماذج في مهام سير العمل المؤتمتة بشكل صحيح.
</Warning>
**إصلاح مؤقت**: استخدم المحركات اليدوية عند الحاجة إلى النماذج، أو أعد هيكلة سير العمل لتجنب النماذج في التدفقات التلقائية.
### الاستهلاك العالي للائتمان
**المشكلة**: تستهلك سير العمل أكثر من المتوقع من الائتمان.
**الأسباب الشائعة والحلول**:
- **استدعاءات API غير فعالة**: اجعل استدعاءات API دفعة ممكنة بدلاً من الطلبات الفردية
- **تكوين مشغل يدوي خاطئ**: استخدم `Bulk` للتوافر بدلاً من `Single` لمعالجة سجلات متعددة في تشغيل واحد لسير العمل
- **عوامل تصفية مفقودة**: أضف منطقًا شرطيًا لإيقاف سير العمل عندما لا يتم استيفاء المعايير
- **خطوات غير ضرورية**: أزل الإجراءات الزائدة وحسن منطق سير العمل
- **الحقيقي مقابل المجدول**: استخدم مهام سير العمل المجدولة للعمليات غير العاجلة
### قيود سير العمل المتزامن
**المشكلة**: الوصول إلى حد 100 سير عمل متزامن لكل مساحة عمل.
<Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning><Warning>لا يمكنك تشغيل أكثر من 100 سير عمل بالتوازي في أي وقت لكل مساحة عمل.</Warning></Warning>
**حلول**:
- استخدم `Bulk` للتوافر للمشغلات اليدوية لمعالجة سجلات متعددة في تشغيل واحد
- قم بتنفيذ تأخيرات بين تشغيل ملفات سير العمل باستخدام المشغلات المجدولة
- حسن سير العمل لتعمل بشكل أسرع وتقليل وقت التنفيذ المتزامن
- النظر في المعالجة الجماعية خلال ساعات الهدوء
### تقييد معدل API
**المشكلة**: فشل استدعاءات API الخارجية بسبب قيود المعدل.
**حلول**:
- استخدم مهام سير العمل المجدولة بدلاً من المشغلات الفورية عندما يكون ذلك ممكنًا
- قم بتنفيذ تأخيرات بين استدعاءات API في الإجراءات البرمجية
- قم بتجميع طلبات API عند دعم الخدمة الخارجية لذلك
- مراقبة تشغيل سير العمل لأخطاء الحد الزمني وتعديل التوقيت
### مشكلات المكرر
**المشكلة**: لا تعمل إجراءات المكرر كما هو متوقع.
**حلول**:
- **ملاحظة**: المكرر حاليًا في مرحلة البيتا. قم بتنشيطه ضمن الإعدادات → الإصدارات → Lab
- تحقق من أن الإدخال هو مجموعة من السجلات من خطوة سابقة
- تحقق من أن الإجراءات داخل المكرر مُعدّة بشكل صحيح
- استخدم المكرر مع المشغلات اليدوية `Bulk` لأداء مثالي
### فقدان الأذونات
**المشكلة**: لا يمكن الوصول إلى قسم سير العمل.
<Warning>
إذا لم تظهر لك قسم سير العمل، فهذا بسبب مشكلة الأذونات. اتصل بمسؤول مساحة العمل لمنحك الوصول إلى سير العمل.
</Warning>
## نصائح لتحسين الأداء
### أفضل الممارسات في الأداء
- **ابدأ ببساطة** وأضف التعقيد تدريجيًا
- **استخدم `Bulk` للتوافر** للمشغلات اليدوية لمعالجة سجلات متعددة بكفاءة
- **أضف الفلاتر مبكرًا** لإيقاف سير العمل عندما لا يتم استيفاء المعايير
- **إجراء مكالمات API مجمعة** واستخدم مهام سير العمل المجدولة للعمليات غير العاجلة
- **أخفِ تشغيل سير العمل** من الصفحات التي تعرض جميع سير العمل لتحسين أداء التحميل
- **راقب استخدام الاعتمادات** بانتظام في الإعدادات → الفوترة
### الوقاية من الأخطاء
- **اختبار في وضع المسودة** قبل تنشيط سير العمل
- **التحقق من صحة استجابات API** وتنفيذ إجراءات بديلة
- **استخدم أسماء خطوات وصفية** لصيانة أسهل
- **وثق المنطق المعقد** لأعضاء الفريق
## الحصول على المساعدة
### موارد الخدمة الذاتية
- استعرض [ميزات سير العمل](/l/ar/user-guide/workflows/workflow-features) للحصول على تفاصيل فنية
- تحقق من [اعتمادات سير العمل](/l/ar/user-guide/workflows/workflow-credits) للحصول على نصائح لتحسين الأداء
- استكشف [الأتمتة الداخلية](/l/ar/user-guide/workflows/internal-automations) و[تكامل الأداة الخارجية](/l/ar/user-guide/workflows/external-tool-integration) للحصول على أمثلة
### الدعم المهني
- اتصل بخدمات [خدمات المحترفين](/l/ar/user-guide/workflows/professional-services) لمزيد من استكشاف الأخطاء المعقدة
- اتصل بالدعم عبر contact@twenty.com للحصول على المساعدة الفنية