فهم الإجراءات في Shopify Flow

في سير العمل، الإجراءات هي المهام التي يُنفذها تطبيق Flow عندما تتحقق شروط سير العمل. وتشمل الإجراءات الشائعة إضافة إشارات للطلبات أو العملاء، وإرسال رسائل بريد إلكتروني أو إشعارات Slack، وتحديث المخزون، وتعليق التنفيذ، وإلغاء الطلبات، وإنشاء طلبات مسودة. كما يمكنك أتمتة الإجراءات في تطبيقات الموصّلات التابعة لجهات خارجية التي قمت بتثبيتها، مثل إرسال البيانات إلى Google Sheets أو Klaviyo أو ShipStation.

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

اختيار الإجراءات لسير عملك

توجد العديد من الإجراءات المختلفة التي يمكنك الاختيار من بينها لإنجاز مهمة ضمن سير العمل. ويساعد فهم المهام المحددة التي يمكن أتمتتها في Shopify Flow على ضمان عمل سير العمل بشكل صحيح.

تندرج الإجراءات ضمن الفئات التالية:

  • إجراءات المتجر: تعمل هذه الإجراءات على تغيير شيء ما في متجر Shopify الخاص بك، مثل إضافة الإشارات أو تحديث المخزون أو إلغاء الطلبات.
  • إجراءات التواصل: تُرسل هذه الإجراءات إشعارات قابلة للتخصيص عبر المنصة التي تختارها، مثل إرسال رسالة بريد إلكتروني إلى نفسك أو إلى فريقك، أو نشر رسالة في Slack، أو إرسال بريد إلكتروني تسويقي لعملائك.
  • إجراءات التطبيق: تنفذ هذه الإجراءات مهمة في تطبيق متصل. وتعتمد الخيارات المتاحة على موصّلات التطبيقات المثبتة في متجرك. ولا تمتلك جميع التطبيقات موصّلاً مرتبطاً بتطبيق Shopify Flow.
  • الإجراءات المتقدمة: تُعدّل هذه الإجراءات سلوك أو بيانات سير العمل، وتتضمن الأنواع التالية:
    • إجراءات جلب البيانات: تعمل هذه الإجراءات على جلب قائمة ببيانات إضافية من متجرك لا يتم توفيرها بشكل افتراضي في مُشغّل سير العمل لاستخدامها ضمن سير عملك. وتستدعي هذه الإجراءات استعلاماً مزوداً بمجموعة من الفلاتر، مثل الحصول على قائمة ببيانات المنتجات التي تم تحديثها في اليوم الأخير.
    • إجراءات التجميع: تُجري هذه الإجراءات عمليات حسابية على بيانات القائمة في سير العمل، مثل العدد أو المجموع.
    • إجراء لكل حلقة (التكرار): يتيح لك هذا الإجراء تنفيذ مهمة على كل عنصر يتم إرجاعه في قائمة، ضمن حلقة تكرار.
    • إجراء إرسال الطلب: تُستخدم هذه الإجراءات لإرسال البيانات واستلامها من Shopify GraphQL Admin API أو واجهات برمجة التطبيقات (API) الخارجية.
    • إجراء الانتظار: نوع فريد من الإجراءات يقوم بإيقاف سير العمل من الانتقال إلى الخطوة التالية حتى انقضاء مدة زمنية محددة.

عند اتخاذ قرار بشأن كيفية تنفيذ إجرائك أثناء بناء سير العمل، يُرجى مراجعة الاعتبارات التالية بناءً على المهمة التي تريد من سير العمل أتمتتها:

تأكيد البيانات التي يوفرها سير عملك

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

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

تأكيد توقيت الإجراءات في سير العمل

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

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

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

إضافة المتغيرات في الإجراءات لإرجاع بيانات ديناميكية

يمكن استخدام المتغيرات في خطوات الإجراء لإدراج بيانات ديناميكية في نص مخصص، كما هو الحال في رسائل البريد الإلكتروني للعملاء. يتم تنسيق هذه المتغيرات بـ نفس تنسيق النقاط في GraphQL Admin API المستخدم في الشروط وتغليفها بأقواس مزدوجة {{ }}. عند استخدام المتغيرات في الإجراءات، فإنها تعمل كعنصر نائب يُرجع القيمة المحددة للمتغير بناءً على البيانات المقدمة أثناء مسار العمل.

على سبيل المثال، في إجراء إرسال فاتورة الطلب (Send order invoice)، يحتوي حقل الموضوع (Subject) الخاص بالبريد الإلكتروني على المتغير order.name افتراضيًا، ويكون منسقًا بالشكل "فاتورة {{order.name}}". هذا يعني أنه عند إرسال البريد الإلكتروني، سيكون سطر الموضوع في البريد الإلكتروني النهائي هو "فاتورة #1000" أو أيًا كان رقم الطلب بناءً على تلك القيمة للطلب.

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

على سبيل المثال، في إجراء إرسال فاتورة الطلب (Send order invoice) نفسه، قد تضيف المحتوى التالي في حقل الرسالة المخصصة (Custom message)، والذي يحتوي على عدة متغيرات تتضمن قيمًا ديناميكية بناءً على البيانات التي يقدمها مسار العمل:

Hello {{order.customer.firstName}}! This is the invoice for order {{order.name}}, which you placed on {{order.createdAt}}.

{% if order.fullyPaid = 'false' %}
     Please complete any outstanding payments in the next 5 business days.
{% endif %}

تعرّف على المزيد حول استخدام المتغيرات لعرض البيانات أو تحويلها في Shopify Flow.