اختبار سير عمل في Shopify Flow

يمكنك اختبار سير عمل قبل تنشيطه. يتيح لك ذلك التحقق من منطق سير العمل والتأكد من صحة المتغيرات والمعلَمات قبل تنشيط سير العمل ليعمل بمفرده. لا يتخذ اختبار سير العمل إجراءات مثل إرسال الإشعارات، أو تحديث الطلبات أو المنتجات، أو إجراء أي تغييرات على بيانات متجرك النشط. يمكنك اختبار سير عمل في أي وقت في Shopify Flow.

يبدأ كل اختبار ببيانات حدث البدء. توجد 3 طرق للحصول على بيانات حدث البدء في Shopify Flow، اعتمادًا على ما إذا كنت تريد استخدام بيانات متجر حقيقية أم بيانات متجر محاكاة:

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

اعتبارات لاختبار سير عمل في Shopify Flow

قبل اختبار سير عمل، راجع الاعتبارات التالية:

• تستخدم مهام سير العمل في وضع الاختبار بيانات متجرك الحقيقية لإرجاع متغيرات Liquid وتحديد منطق سير العمل، لكنها لا تتخذ إجراءات أو تجري تعديلات على متجرك. تتوقف عملية التشغيل الاختبارية عند أول إجراء يحاول إجراء تغيير في منطق سير العمل لمنع حدوث تغييرات غير مقصودة.
• يمكنك اختبار سير عمل في أي مرحلة عند إنشائه. لا يشترط أن يكون سير العمل مكتملًا لاختبار نسختك الحالية، ولكن يجب أن تكون جميع الخطوات في سير العمل صالحة. لا يمكن استخدام الخطوات غير المكتملة أو التي تم إعدادها بشكل غير صحيح في الاختبار.
• لا تتضمن قائمة عمليات التشغيل الأخيرة لسير العمل عمليات التشغيل الاختبارية لسير العمل.
• تعرض الإجراءات في سير العمل التي تتصل بخدمات خارجية، مثل إرسال طلب HTTP، معاينات للإعدادات أثناء الاختبار، ولكنها تعرض رسالة لا يمكن محاكاة هذا الإجراء كقيمة للبيانات المرجعة بدلاً من البيانات الفعلية.

استخدام أحداث مسجلة حقيقية لاختبار سير عمل في Shopify Flow

عند تسجيل الأحداث، يستخدم سير العمل بيانات المتجر الحقيقية بناءً على حدث البدء الذي عينته لإنتاج قائمة بأحداث الاختبار. واعتمادًا على طبيعة حدث البدء، قد تحتاج إلى تنفيذ الإجراء يدويًا لإنشاء حدث اختبار. على سبيل المثال، إذا كنت تختبر حدث تم إنشاء المجموعة، فستحتاج إلى إنشاء مجموعة يدويًا في مسؤول Shopify ليقوم سير العمل بتسجيل الحدث لاختباره.

الخطوات:

1. من مسؤول Shopify، انتقل إلى التطبيقات > Flow.

2. في قسم مهام سير العمل، انقر على سير العمل الذي تريد اختباره.

3. انقر على تعديل لفتح محرر سير العمل.

4. في مشغّل سير العمل، انقر على اختبار سير العمل.

5. في مربع الحوار اختبار سير العمل، انقر على + إضافة حدث > تسجيل الأحداث لتفعيل وضع الاختبار في سير العمل.

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

7. في مربع حوار حدث الاختبار، تُعرض جميع أحداث الاختبار المُشغّلة في قائمة تسجيل الأحداث. حدّد حدث الاختبار الذي تريد تشغيل سير عمل الاختبار له.

8. يسلّط سير العمل الضوء على شروط وإجراءات معينة ليعرض بشكل مرئي مسار المنطق الذي يستخدمه سير العمل، بناءً على حدث المشغّل الذي تحدده. يمكنك القيام بأي من الإجراءات التالية:

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

9. اختياري: انقر على إيقاف التسجيل للخروج من وضع الاستماع. يمكنك استئناف الاستماع لأحداث الاختبار المباشرة مرة أخرى بالنقر على بدء التسجيل.

إنشاء أحداث محاكاة لاختبار سير عمل في Shopify Flow

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

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

إذا كنت لا ترغب في تحديد البيانات لإنشاء حدث اختبار بنفسك، فيمكن لـ Sidekick إنشاء مجموعة من أحداث الاختبار لك.

الخطوات:

تعديل أحداث الاختبار المحفوظة في Shopify Flow

يمكنك تعديل محتوى أحداث الاختبار المحفوظة لسير عملك في أي وقت. يمكنك أيضًا إزالة أي أحداث اختبار محفوظة بالكامل.

الخطوات:

1. من مسؤول Shopify، انتقل إلى التطبيقات > Flow.

2. في قسم مهام سير العمل، انقر على سير العمل الذي تريد اختباره.

3. انقر على تعديل لفتح محرر سير العمل.

4. في مشغّل سير العمل، انقر على اختبار سير العمل.

5. في قائمة الأحداث المحفوظة، مرّر المؤشر فوق حدث الاختبار الذي ترغب في تعديله، ثم انقر على … > تعديل.

6. حدّث محتوى الحقول في حدث الاختبار. قد تحتاج إلى النقر على X لإزالة البيانات قبل أن تتمكن من تحديد بيانات جديدة.

7. انقر على حفظ.

8. اختياري: لحذف حدث الاختبار المحفوظ، مرّر المؤشر فوق حدث الاختبار الذي ترغب في حذفه، ثم انقر على … > إزالة.

مراجعة اختبار سير العمل

عندما تختبر سير عمل في Shopify Flow، راجع المعلومات التالية للتأكد من أن سير عملك يتصرف كما هو متوقع بناءً على حدث مشغّل الاختبار:

• هل المنطق العام لسير العمل يسير كما تتوقع؟ على سبيل المثال، إذا كان شرط حدث الاختبار صحيحًا (true)، فهل يتبع سير العمل المسار المنطقي لتحقق الشرط؟
• هل يستخدم سير العمل المتغيرات الصحيحة في جميع الشروط والإجراءات؟ على سبيل المثال، قد تكون طلبت من سير العمل التحقق من المتغير fulfillments_item.totalQuantity، الذي يُرجع مجموع كميات كافة البنود الخاصة بعملية تلبية طلب، بدلاً من المتغير order.fulfillmentsCount.count، الذي يُرجع عدد عمليات تلبية الطلبات في الطلب.
• هل يستخدم سير العمل المعاملات الصحيحة في جميع الشروط والمتغيرات؟
  • تأكد من منطق AND/OR. على سبيل المثال، بالنسبة لشرط يحتوي على عناصر متعددة، هل يتحقق الشرط من صحة كلا العنصرين (أ AND ب)، أم عنصر واحد فقط (أ OR ب)؟
  • تأكد من منطق None of/At least one of/All of، عند الاقتضاء.
  • تأكد من صحة معاملات المتغير الخاص بك، مثل منطق Equal to وNot equal to وDoes not exist وExists وGreater than وLess than وIs at least one of، عند الاقتضاء.
• هل تحدث شروط وإجراءات سير العمل بالتسلسل الصحيح؟ على سبيل المثال، قد يتم إعداد سير عملك للتحقق من عدة شروط مختلفة في نفس الوقت، بدلاً من التحقق من شرط واحد قبل الانتقال إلى الشرط التالي بناءً على النتيجة.

إذا تصرف سير عمل الاختبار بشكل غير متوقع، فراجع المعلومات حول استكشاف أخطاء سير العمل في Shopify Flow وإصلاحها.