نوصي بشدة باستخدام «تشغيل برنامج نصي» لإنشاء عمليات الأتمتة، لأنه يستطيع تغطية جميع سلوكيات الإجراءات، بما فيها الإجراءات التي كان يلزم إنشاؤها يدويًا لولا ذلك. ما عليك سوى وصف متطلباتك للذكاء الاصطناعي في الدردشة.يُرجى ملاحظة أنه إذا أضفت إجراءات يدويًا، فلن يتعرف عليها الذكاء الاصطناعي أو يعدّلها لاحقًا.
الإجراءات المدعومة
مصادر المصفوفات
لاستخدام الحلقة، تحتاج إلى مصفوفة بوصفها مدخلًا. تشمل المصادر الشائعة:
كيفية الإعداد
- افتح إجراءً مدعومًا (مثل إنشاء سجل أو إرسال بريد إلكتروني).
- انقر على تشغيل الحلقة أسفل منتقي الجدول (أو في منطقة تهيئة الإجراء).
- في منتقي مصدر البيانات، اختر متغير مصفوفة من خطوة سابقة، مثل مصفوفة السجلات من خطوة جلب السجلات.
- تعرض منطقة ربط الحقول الآن خصائص كل عنصر منفرد (لا المصفوفة كاملةً). انقر على + للإشارة إلى خصائص العنصر الحالي، مثل اسم السجل الحالي أو بريده الإلكتروني أو حالته.
- احفظ الإجراء. عند تشغيل سير العمل، يُنفّذ الإجراء مرة لكل عنصر في المصفوفة.
كيفية الإشارة إلى العنصر الحالي
عندما تكون الحلقة نشطة، يعرض منتقي المتغيرات + خصائص العنصر الحالي في التكرار. مثال:
- عند التكرار على مخرجات جلب السجلات، يمكنك الإشارة إلى
العنصر الحالي ← الحقول ← الاسم والعنصر الحالي ← الحقول ← البريد الإلكتروني، إلخ.
- عند التكرار على مصفوفة خطاف ويب، يمكنك الإشارة إلى
العنصر الحالي ← product_name والعنصر الحالي ← quantity، إلخ.
يختلف ذلك عن الوضع دون حلقة، حيث تشير إلى المصفوفة كاملةً أو فهرس محدد.
مثال عملي: إرسال رسائل تذكير للمهام المتأخرة
- المشغّل: في وقت مجدول — يوميًا الساعة 9:00 صباحًا.
- الإجراء 1: جلب السجلات — من جدول المهام، مع عامل التصفية: تاريخ الاستحقاق قبل اليوم AND الحالة لا تساوي “مكتملة”.
- الإجراء 2: إرسال بريد إلكتروني مع تمكين الحلقة، مصدر البيانات = مصفوفة سجلات الإجراء 1.
- إلى: حقل بريد المكلّف في العنصر الحالي.
- الموضوع:
تذكير: "{{current item → Task Name}}" متأخرة
- النص:
مرحبًا {{current item → Assignee Name}}، كان موعد استحقاق مهمتك "{{current item → Task Name}}" في {{current item → Due Date}}. يُرجى تحديثها.
النتيجة: رسالة مخصصة واحدة لكل مهمة متأخرة.
نص مصفوفة HTTP
بالنسبة إلى إجراءات طلب HTTP، تقدم الحلقة وضعًا خاصًا باسم نص المصفوفة. فبدلًا من إرسال طلب HTTP واحد لكل عنصر، وهو ما قد يكون بطيئًا ويبلغ حدود المعدل، يرسل نص المصفوفة المصفوفة كاملةً كمصفوفة JSON واحدة في طلب واحد.
يفيد ذلك عندما تدعم واجهة API الخارجية العمليات الدفعية، مثل إنشاء عدة سجلات في استدعاء API واحد أو إرسال دفعة أحداث إلى خدمة تحليلات.
لاستخدام نص المصفوفة:
- فعّل الحلقة في إجراء طلب HTTP.
- اختر وضع نص المصفوفة بدلًا من الوضع الافتراضي لكل عنصر.
- تُسلسل المصفوفة كاملةً كمصفوفة JSON وتُرسل في نص الطلب.
اعتبارات الأداء
- تعالج الحلقة العناصر تسلسليًا، لا بالتوازي. تستغرق حلقة على 100 عنصر نحو 100 ضعف زمن تنفيذ واحد.
- للمصفوفات الكبيرة (مئات أو آلاف العناصر)، تحقق مما إذا كان الإجراء الخارجي يقبل مدخلات دفعية. استخدم نص مصفوفة HTTP عندما تدعم واجهة API ذلك.
- إذا كنت تكرر على مخرجات جلب السجلات وتنفذ طلبات HTTP لكل سجل، فانتبه إلى حدود معدل واجهة API الخارجية.
- لمجموعات البيانات الكبيرة جدًا، قسّم العمل إلى دفعات أصغر باستخدام ترقيم الصفحات في جلب السجلات (تخطي/أخذ)، مع عدة عمليات تشغيل للأتمتة.
حالات الاستخدام
- إنشاء سجلات دفعة واحدة. اجلب سجلات من جدول، ثم كرر لإنشاء سجلات مقابلة في جدول آخر.
- إرسال رسائل مخصصة إلى قائمة. اجلب قائمة جهات اتصال وكرر لإرسال رسالة مخصصة إلى كل منها.
- تحديث عدة سجلات. اجلب السجلات المطابقة لشرط وكرر لتحديث كل منها (مثل تمييز جميع المهام المتأخرة بأنها “مصعّدة”).
- تنفيذ استدعاءات API لكل سجل. ادفع بيانات كل سجل إلى نظام خارجي، واحدًا تلو الآخر.
- معالجة دفعة سجلات بالذكاء الاصطناعي. كرر على السجلات واستخدم الإنشاء بالذكاء الاصطناعي لتصنيف بيانات كل منها أو تلخيصها أو استخراجها.
نصائح
- تحقق دائمًا من حجم المصفوفة قبل تمكين الحلقة. إذا أعاد جلب السجلات 1,000 سجل، فستعمل الحلقة 1,000 مرة.
- إذا كانت الحلقة تنشئ سجلات أو تحدّثها في الجدول نفسه الذي شغّل الأتمتة، فاحذر من إعادة تشغيل الأتمتة. استخدم عوامل تصفية في المشغّل لتجنب الحلقات.
- تتاح نتائج جميع تكرارات الحلقة في مصفوفة للخطوات اللاحقة، لكن قد تكون هذه المصفوفة كبيرة جدًا في الحلقات الضخمة. لا تشر إلا إلى ما تحتاج إليه.
موضوعات ذات صلة
- جلب السجلات — المصدر الأكثر شيوعًا للمصفوفات المستخدمة في الحلقة
- إنشاء سجل — يُستخدم عادةً داخل حلقة لإنشاء سجلات دفعة واحدة
- طلب HTTP — يُستخدم عادةً داخل حلقة لاستدعاءات API لكل عنصر
- إرسال بريد إلكتروني — يُستخدم عادةً داخل حلقة لإرسال البريد على دفعات
