توفّر Shopify Flow أتمتة مفيدة لتصنيف الطلبات وإرسال التنبيهات وتحديث الوسوم، لكن إعادة تشغيل مهمة فاشلة دون فهم سجلها قد تكرر الإجراء نفسه. قد تصل رسالة داخلية مرتين، أو يضاف الوسم أكثر من مرة، أو يُرسل طلب خارجي جديد مع أن المحاولة الأولى نجحت جزئيًا. لذلك يجب أن تبدأ مراجعة تشغيل Shopify Flow من سجل التنفيذ ومعرّف المورد، لا من الضغط مباشرة على Retry.
ترتبط هذه المراجعة بخدمة إنشاء متجر Shopify، ويمكن استكمالها بمقال اختبار أثر تطبيقات Shopify على القالب لأن تغييرات التطبيقات والأذونات قد تؤثر في خطوات الأتمتة.
ما الذي يعرضه سجل Shopify Flow؟
توضح وثائق Shopify لمراقبة التشغيل أن كل تنفيذ ينتج Workflow run يعرض الحالة والمسار الذي اتخذته الشروط ونتيجة الإجراءات والأخطاء. يمكن البحث في التشغيلات بالنص الموجود في بيانات الخطوة، أو بمعرّف طلب أو عميل، أو بنطاق زمني، أو باسم سير العمل وحالة الخطأ.
تُحفظ تشغيلات Flow المكتملة لمدة 14 يومًا، لذلك لا تؤجل جمع الأدلة. سجّل Run ID ومعرّف الطلب ووقت التنفيذ وإصدار سير العمل قبل إجراء تعديل. انتبه إلى أن الوقت يظهر بحسب المنطقة الزمنية للمتجر، لا بالضرورة منطقة جهاز الموظف.
فرّق بين فشل الخطوة ونجاح الأثر الخارجي
قد تُظهر الخطوة خطأ اتصال بعد أن يكون النظام الخارجي قد استلم الطلب. مثال ذلك إرسال Webhook إلى نظام شحن ثم انقطاع الرد قبل وصول التأكيد إلى Flow. إعادة المحاولة العمياء قد تنشئ بوليصة ثانية. قبل إعادة التشغيل، افحص النظام المستلم باستخدام معرّف فريد مثل رقم الطلب أو مفتاح العملية.
أما الخطوات المحلية مثل إضافة وسم، فقد تكون بطبيعتها قابلة للتكرار دون أثر إضافي، لكن لا تفترض ذلك لكل إجراء. إرسال بريد، إنشاء سجل، خصم نقاط، أو طلب شحن يحتاج حماية من التكرار. صمّم الإجراء بحيث يفحص وجود النتيجة أو يستخدم مفتاح idempotency عندما يدعم الطرف الآخر ذلك.
خطوات التشخيص وإعادة المحاولة
- حدد التشغيل الصحيح: ابحث بمعرّف الطلب أو العميل وبوقت الحدث، ثم افتح المسار والبيانات التي دخلت كل شرط.
- افحص ما حدث بالفعل: راجع Actions والنتائج والنظام الخارجي، وحدد آخر خطوة مؤكدة قبل الخطأ.
- أصلح السبب أولًا: صحح الإذن أو الحقل الفارغ أو شرط القائمة أو اتصال التطبيق، ثم اختبر ببيانات غير حساسة.
- قرر نطاق الإعادة: أعد تشغيل Run واحدًا أولًا، ولا تحدد مجموعة كبيرة حتى تتأكد من نتيجة العينة.
- راجع التشغيل الجديد: اربط Retry بالتشغيل الأصلي، وافحص الوسوم والرسائل والطلبات الخارجية بعده.
توضح وثائق Shopify لإعادة المحاولة أن التشغيل لا يمكن أن يكون ما يزال Running أو Waiting، وأن سير العمل يجب أن يكون نشطًا وأن يظل المشغل متوافقًا. تستخدم الإعادة بيانات المشغل الأصلية، لكنها قد تجلب أحدث البيانات في خطوات Get data وتقيّم الشروط والإجراءات بناء عليها؛ لذلك قد لا تسلك المسار نفسه إذا تغير الطلب بعد المحاولة الأولى.
مثال افتراضي
مثال افتراضي: سير عمل يبدأ عند دفع الطلب، ثم يضيف وسم «مدفوع» ويرسل بياناته إلى شركة شحن. أضاف الوسم بنجاح، لكن خطوة الشحن انتهت بخطأ 504. قبل الضغط على Retry، بحث الفريق في نظام الشحن برقم الطلب ووجد أن بوليصة الشحن أُنشئت بالفعل. لو أعاد التشغيل كاملًا بلا فحص، ربما أنشأ بوليصة ثانية.
عدّل الفريق التكامل ليرسل رقم الطلب كمفتاح فريد ويتحقق من وجود البوليصة قبل الإنشاء. ثم اختبر طلبًا جديدًا، وترك التشغيل القديم موثقًا بدل إعادة إرساله. هذا مثال توضيحي ولا يعني أن كل خطأ 5xx أدى إلى نجاح خارجي.
كيف تمنع الأخطاء المتكررة؟
ضع شروطًا واضحة للحقول الاختيارية قبل استخدام الإجراء. لا تفترض أن كل طلب مرتبط بعميل مسجل أو أن كل منتج يحمل Metafield. راقب التشغيلات التي تدخل حالة Rate limited أو تبقى Running طويلًا، وخفف الحلقات التي تقرأ قوائم كبيرة. إذا كان سير العمل يحتوي For each، افحص عدد العناصر والمسار لكل تكرار.
استخدم أسماء تصف الهدف والإصدار، وأضف وسمًا تنظيميًا لسير العمل. عند تعديل منطق مهم، انسخ التصميم إلى نسخة اختبار، وعطّل النسخة القديمة بعد التحقق حتى لا يعمل سيران على المشغل نفسه.
قائمة مراجعة قبل Retry
- [ ] حُدد Run ID والطلب أو المورد المرتبط به.
- [ ] روجع آخر إجراء نجح داخل Flow.
- [ ] فُحص النظام الخارجي قبل إعادة أي طلب.
- [ ] أُصلح السبب وليس رسالة الخطأ فقط.
- [ ] سير العمل نشط والمشغل ما زال متوافقًا.
- [ ] التشغيل ليس Running أو Waiting.
- [ ] اختُبرت إعادة واحدة قبل المجموعة.
- [ ] توجد حماية من تكرار الشحن أو النقاط أو الرسائل.
- [ ] روجعت نتيجة التشغيل الجديد وربطت بالأصلي.
- [ ] حُفظت الأدلة قبل انتهاء نافذة السجل.
المراجعة المنضبطة تجعل إعادة المحاولة قرارًا مبنيًا على حالة حقيقية. والهدف ليس جعل كل تشغيل أخضر بأي ثمن، بل ضمان أن الأثر التجاري حدث مرة واحدة وبالبيانات الصحيحة.
المراجع والمصادر
محتوى إرشادي أُعد بمساعدة الذكاء الاصطناعي. الأمثلة افتراضية للتوضيح، وليست نتائج لعملاء تمايز.
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويق
نسمعك