الجداول الزمنية، وإجراءات الحصول على بيانات، ومسارات العمل الحلقية في Shopify Flow

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

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

في هذه الصفحة

مشغّل الوقت المُجدوَل

بدلاً من بدء سير عمل بسبب حدث، يبدأ مشغّل الوقت المُجدوَل (Scheduled time) سير عمل في وقت وتاريخ محددين تحددهما. يمكنك أيضًا جدولة سير العمل ليتكرر كل ساعة أو يوميًا أو أسبوعيًا أو شهريًا. ونتيجة للتشغيل بناءً على جدول زمني، يجب عليك استخدام إجراء للحصول على بيانات معينة مثل العملاء أو الطلبات أو المنتجات. يمكنك القيام بذلك باستخدام إجراءات الحصول على بيانات (Get data).

يمكن تشغيل مشغّل الوقت المُجدوَل بمعدل يصل إلى كل 10 دقائق.

إجراءات الحصول على بيانات

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

تجلب إجراءات الحصول على بيانات بيانات من متجرك لاستخدامها في Flow. تستدعي هذه الإجراءات استعلامًا يتضمن مجموعة من عوامل التصفية، مثل الحصول فقط على الأشياء التي تم تحديثها في اليوم الأخير. يُرجع الإجراء قائمة بالبيانات التي تطابق هذا المعيار. على سبيل المثال، يستدعي إجراء الحصول على بيانات الطلب (Get order data) استعلام الطلب على Admin API ويُرجع قائمة بالطلبات التي تطابق استعلامك.

يمكن تشغيل إجراءات الحصول على بيانات فقط على القوائم التي يصل طولها إلى 100 عنصر.

تسترد الإجراءات التالية معلومات من متجرك حتى تتمكن من استخدام هذه البيانات في سير عملك. راجع كل إجراء للحصول على تفاصيل حول كيفية تصفية البيانات وما هي البيانات التي يتم إرجاعها:

علامات Liquid في إجراءات الحصول على البيانات

عند استخدام إجراء الحصول على البيانات مع التواريخ، يمكنك استخدام علامتي Liquid وهما date_minus وdate_plus لتغيير التواريخ في استعلامك. على سبيل المثال، لحساب تاريخ يسبق وقت التشغيل المجدول لسير العمل بمقدار 5 أيام، يمكنك استخدام كود Liquid التالي:

{{ scheduledAt | date_minus: "5 days" }}

لمزيد من التفاصيل حول كيفية استخدام هذه العلامات، راجع وثائق متغيرات Liquid.

حلقات For each

عندما تستخدم إجراء الحصول على البيانات، فإنك تحصل على قائمة بالبيانات التي تتطابق مع استعلامك. يمكنك استخدام إجراء حلقة For each (تكرار) للتكرار عبر تلك القائمة. في حلقة For each، يمكنك استخدام شروط وإجراءات تنطبق على ذلك العنصر فقط.

على سبيل المثال، قمت بإنشاء سير عمل يتم تشغيله كل يوم اثنين. يستخدم سير العمل إجراء الحصول على بيانات الطلب لاسترداد الطلبات التي تم تقديمها خلال ذلك الأسبوع. ثم تطبق حلقة For each (تكرار) إشارة New order (طلب جديد) على كل طلب يتم إرجاعه بواسطة قائمة getOrderData. بعد وضع إشارات على جميع الطلبات في القائمة، يتم إرسال بريد إلكتروني داخلي للإشارة إلى اكتمال وضع الإشارات.

مثال على سير عمل يسترد قائمة بالطلبات التي تم تقديمها في الأسبوع الماضي ويضيف إشارة إلى كل طلب، ثم يرسل بريدًا إلكترونيًا.

إجراءات التجميع

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

يُرجع إجراء العدد عدد الإدخالات في القائمة.
يجمع إجراء المجموع قيم الإدخالات في قائمة معًا.

أمثلة على عمليات سير العمل المتقدمة في Shopify Flow

راجع بعض الأمثلة على عمليات سير العمل المتقدمة التي يمكنك استخدامها في Shopify Flow:

الحصول على ملخص يومي للطلبات التي تتجاوز نافذة التنفيذ المحددة بيومين

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

في هذا المثال، يتم تشغيل سير العمل كل يوم في الساعة 5:00 مساءً. يستخدم سير العمل إجراء الحصول على بيانات الطلب لاسترداد قائمة بالطلبات التي لم يتم تنفيذها ضمن نافذة شحن مدتها يومان. بعد ذلك، يضيف إجراء For each إشارة إلى جميع الطلبات المتأخرة. كما يستخدم سير العمل إجراء العدد لتحديد عدد الطلبات المتأخرة وإجراء المجموع لتحديد قيمة تلك الطلبات. تُستخدَم المتغيرات التي تم إنشاؤها بواسطة إجرائي العدد والمجموع لإرسال بريد إلكتروني يشير إلى عدد الطلبات وقيمتها.

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

قم بتثبيت قالب سير العمل هذا في متجرك.

عند إنشاء طلب جديد، تحقق مما إذا كان نفس العميل قد قدّم طلبات أخرى خلال آخر 24 ساعة

يمكن استخدام سير العمل هذا لتحديد ما إذا كان نفس العميل قد قدّم طلبات متعددة في نفس اليوم، وفي حالة حدوث ذلك، يتم تعليق التنفيذ بحيث يمكن شحن الطلبات معًا.

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

مثال على سير عمل يسترد قائمة بطلبات متعددة، ويضع إشارة عليها، ويعلق تنفيذها.

قم بتثبيت قالب سير العمل هذا في متجرك.

الحصول يوميًا على بريد إلكتروني ملخص يعرض المنتجات غير المتوفرة في المخزون

يمكن استخدام سير العمل هذا لإنشاء قائمة بجميع منتجاتك غير المتوفرة في المخزون وإرسال بريد إلكتروني بها.

في هذا المثال، يتم تشغيل سير العمل كل يوم في الساعة 9:00 مساءً. يستخدم سير العمل إجراء الحصول على بيانات المنتج لاسترداد قائمة بالمنتجات التي ليس لها مخزون. يحدد إجراء العدد عدد العناصر غير المتوفرة في المخزون. وتُستخدَم المتغيرات التي تم إنشاؤها بواسطة إجرائي الحصول على بيانات الطلب والعدد لإرسال بريد إلكتروني يشير إلى عدد المنتجات وقائمة بتلك المنتجات.

مثال على سير عمل يسترد قائمة بطلبات متعددة، ويضيف إشارات إليها، ويعلّق تلبيتها.

قم بتثبيت قالب سير العمل هذا في متجرك.

البحث عن جميع الطلبات المرتبطة برد مدفوعات مرة واحدة يوميًا وإضافة إشارة إلى العميل

يمكن استخدام سير العمل هذا لتتبّع العملاء الذين أجروا طلب رد مدفوعات.

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

مثال على سير عمل يسترد قائمة بالطلبات التي تتضمن عمليات رد مدفوعات ويضيف إشارة إلى العميل المرتبط بها.

قم بتثبيت قالب سير العمل هذا في متجرك.

عند إنشاء طلب جديد، معرفة عدد الطلبات التي أجراها العميل في الأشهر الستة الماضية

يمكن استخدام سير العمل هذا لتحديد عدد الطلبات التي أجراها العميل في الأشهر الستة الماضية وإضافة إشارات ولاء.

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

مثال على سير عمل يسترد قائمة بالطلبات، ويحسب عدد الطلبات وقيمتها الإجمالية، ويضيف إشارات للعملاء.

قم بتثبيت قالب سير العمل هذا في متجرك.

الحصول كل يوم على قائمة بجميع الطلبات المسودة المفتوحة وإرسال رسالة على Slack

يمكن استخدام سير العمل هذا لإرسال رسالة على Slack تشير إلى ما إذا كان هناك أي طلبات مسودة مفتوحة في متجرك، وعددها إن وجدت.

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

مثال على سير عمل يسترد قائمة بالطلبات المسودة، ويحسب عدد الطلبات المسودة المفتوحة، ويرسل رسالة على Slack.

قم بتثبيت قالب سير العمل هذا في متجرك.