Skip to main content

بطاقة سريعة

عندما يعجز الشرط والتقسيم الجاهزان عن التعبير عن منطقك، تكتب كوداً. هذا الإجراء ينفّذ JavaScript حقيقياً كخطوة كاملة الصلاحية داخل المسار — لا مجرد تعبير حسابي بسيط.

الحقول

وسائط مطلوبة: محرر دالة JavaScript مفتوحاً بكود بسيط (مثال: تحويل تاريخ لصيغة نصية)، مع معامل دخل واحد وربط مخرج واحد. المسار المقترح: /images/help/automations/action-js-function.webp

معاملات الدخل: القيمة الحقيقية وقيمة الاختبار

كل معامل يقبل متغيراً ديناميكياً من المسار (بيانات العميل، إجابة سؤال سابق، نتيجة إجراء سابق)، بالإضافة إلى قيمة اختبار مستقلة تُستخدم فقط عند تجربة الكود أثناء البناء — دون التأثير على القيمة الحقيقية المستخدمة عند التشغيل الفعلي.
استخدم قيم اختبار قريبة من الحالات الحدّية الحقيقية (نص فارغ، رقم سالب، تاريخ غير صالح) لا فقط حالة “الطريق السعيد” — هذا يكشف أخطاء الكود قبل أن يكشفها عميل حقيقي.

ربط المخرجات

بعد تنفيذ الكود، تحتاج أن تحدد أي قيمة من نتيجته تريد الاحتفاظ بها لاستخدامها في خطوات لاحقة (شرط، رسالة، طلب HTTP آخر). لكل مخرج تربطه:
  1. القيمة المصدر: اسم المتغيّر أو الحقل في نتيجة الكود.
  2. الحقل الهدف: أين تُحفظ — حقل على بطاقة العميل، أو متغيّر مسار عادي.
  3. قيمة افتراضية عند الفشل: تُستخدم إن فشل تنفيذ الكود أو لم يُرجع القيمة المتوقعة، بحيث لا يتوقف المسار بقيمة فارغة غير متوقعة.

متى تستخدمه؟

لا تكتب منطقاً بسيطاً (مثل “أكبر من ١٠٠”) في كود JavaScript إن كان الشرط يكفي — الشرط أسهل للفريق غير التقني أن يقرأه ويعدّله لاحقاً. استخدم الكود فقط عندما يتجاوز المنطق ما تعبّر عنه العقد الجاهزة.

أخطاء شائعة

ذات صلة

آخر تعديل في ٩ أغسطس ٢٠٢٦