إجراء المكرِّر (Iterator)

يقوم إجراء Iterator بالمرور على قائمة من العناصر التي أعادتها خطوة سابقة، ويشغّل إجراءاتك مرة واحدة لكل عنصر. استخدمه لمعالجة البيانات الكبيرة، مثل المستخدمين أو الطلبات أو المنتجات التي يعيدها نظام آخر، في تشغيل واحد للأتمتة، دون الحاجة إلى إعداد كل عنصر يدويًا.

ملاحظة: يحتاج Iterator إلى مصفوفة كمُدخل، لذا يجب أن يأتي بعد خطوة تعيد مصفوفة، مثل قادح Webhook أو إجراء Call API. ولا يمكن أن يأتي مباشرة بعد قادح مثل When a record is created. وإلى أن تعيد خطوة سابقة مصفوفة، يظهر Iterator باللون الرمادي في قائمة الإجراءات.

كيفية إعداد Iterator

1. الحصول على مصفوفة من خطوة سابقة

أضف خطوة تعيد مصفوفة. على سبيل المثال، استخدم Call API لطلب بيانات من نظام آخر، واختر المتابعة عند Success. أو ابدأ الأتمتة بقادح Webhook يستقبل قائمة.

2. إضافة Iterator

اختر + Add Action، ثم اختر Iterator (Iterate over an array and run actions for each item). إذا كان Iterator باللون الرمادي، مرّر المؤشر فوقه: ستظهر تلميحة تطلب منك ربطه بإجراء سابق يعيد مصفوفة، مثل قادح Webhook أو Call API.

3. تهيئة Iterator

• Source array: اختر المصفوفة التي تريد المرور عليها. تعرض القائمة المصفوفات التي أعادتها الخطوات السابقة، مثل 2. items، أي المصفوفة items التي أعادتها الخطوة 2
• Maximum iterations: أقصى عدد من العناصر التي تتم معالجتها في تشغيل واحد. القيمة الافتراضية هي 1,000، والحد الأقصى هو 1K سجل

اختر تم لحفظ الخطوة. استخدم Change Type إذا أردت استبدال Iterator بإجراء آخر.

4. إضافة إجراءات لكل عنصر

أسفل Iterator، اختر + Add Action ثم اختر الإجراءات التي تريد تشغيلها لكل عنصر. تظهر بإزاحة أسفل Iterator، مثل 2.1.1 Update a record in القائمة الخاصة بك. كما يعرض Iterator مسار If no record found للحالة التي لا تحتوي فيها المصفوفة على عناصر، ويمكنك إضافة شرط باستخدام + Only continue if.

التحقق مما حدث

افتح سجلات الأتمتة لمعرفة كيف جرى تشغيلها. تعرض الصفحة أعداد Executions وSuccess Executions وFailed Executions، ومخططًا بيانيًا، وجدول Executions log الذي يتضمن:

• Status: هل نجح التشغيل أم فشل
• Last run date: وقت التشغيل
• Reason: سبب فشل التشغيل، إن حدث الفشل
• Logs: اختر Open Log لعرض التفاصيل

يفتح Open Log صفحة Automation Log. وتحت Log Items، يظهر كل عنصر عالجه Iterator كسطر Execute child action. اختر أي سطر لعرض Details الخاصة به على اليمين، واستخدم Copy لنسخها.

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

• حالة استخدام للأعمال: تجلب خطوة Call API أحدث الطلبات من نظام متجرك. يمر Iterator على items التي تمت إعادتها، ويقوم إجراء Update record بتحديث السجل المطابق لكل طلب.
• حالة استخدام بسيطة: تستدعي الأتمتة API عامًا يعيد قائمة، ويضيف Iterator كل نتيجة إلى قائمة Tasks الخاصة بك.

💡 نصيحة: ابدأ بقيمة صغيرة لـ Maximum iterations أثناء الاختبار، لتتمكن من مراجعة السجل قبل معالجة المصفوفة بالكامل.

هل تحتاج إلى مساعدة؟ تواصل مع فريق الدعم لدينا أو اطّلع على الدليل الكامل لـ Webhook.