فهم الشروط في Shopify Flow

إن الشرط هو خطوة في مسار عمل يُتخذ فيها قرار حول كيفية المتابعة بناءً على ما إذا كان قد تم استيفاء مجموعة من المعايير أم لا. تحتوي كل خطوة شرط على احتمالين: صحيح (True)، عندما يتم استيفاء المعايير، وخطأ (False) عندما لا يتم استيفائها. إذا لم تحدد خطوة تالية لأي من الاحتمالين باختيار شرط أو إجراء آخر، فستتوقف عملية تشغيل مسار العمل.

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

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

صياغة شروط مسار عملك

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

• إن المتغير هو عنصر نائب يحدد البيانات التي يستخدمها الشرط. على سبيل المثال، إذا كان الشرط يحتاج للتحقق من كود خصم معين في أحد الطلبات، فسيكون المتغير هو order.discountCode. تستخدم المتغيرات تنسيق النقاط الخاص بـ GraphQL Admin API.
• إن العامل المنطقي يشير إلى كيفية تحديد مسار العمل لما إذا كان قد تم استيفاء الشرط أم لا. يمكن تطبيق العوامل المنطقية على مستوى المتغير، أو عند تضمين متغيرات متعددة كجزء من معايير الشرط الإجمالية:
  • تتضمن الخيارات على مستوى المتغير عوامل على مستوى الحقل مثل أكبر من (Greater than) أو يبدأ بـ (Starts with)، أو عوامل القائمة مثل واحد على الأقل من (At least one of) أو الكل من (All of).
  • تتضمن الخيارات على مستوى الشرط وَ (AND)، مما يعني أنه يجب أن تكون جميع المتغيرات صحيحة حتى يُعتبر الشرط صحيحًا بشكل عام، أو أو (OR)، مما يعني أنه يجب أن يكون متغير واحد على الأقل صحيحًا حتى يُعتبر الشرط صحيحًا بشكل عام.
• إن القيمة هي المعلومات الفعلية التي يبحث عنها المتغير. على سبيل المثال، إذا كان كود الخصم المحدد order.discountCode الذي تريد أن يتحقق مسار العمل منه هو AFFILIATE10، فستكون هذه هي القيمة التي يجب تضمينها كجزء من الشرط.

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

تعرّف على المزيد من المعلومات التفصيلية حول عناصر الشروط في Shopify Flow.

فهم المتغيرات في الشروط

عند صياغة خطوة شرط في مسار عمل، فإن الخطوة الأولى التي يُطلب منك اتخاذها هي إضافة متغير (Add a variable). ولكن، ما هو المتغير؟

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

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

لفهم البيانات التي يمثلها المتغير، ضع في اعتبارك المعلومات التالية حول المتغيرات:

• كيفية قراءة تنسيق النقاط للمتغير.
• فهم متطلبات البيانات للمتغيرات.
• تحديد موقع المتغير الصحيح أثناء البحث.

نصيحة: احصل على مساعدة بشأن المتغيرات من Dev Docs Assistant

إذا لم تكن متأكدًا من المتغير الذي يجب تحديده عند بناء شرطك، ففكر في طلب النصيحة من Shopify Dev Docs Assistant. يتمتع Dev Docs Assistant بإمكانية الوصول إلى جميع الوثائق المتعلقة بـ GraphQL Admin API، ويمكنه تقديم اقتراحات حول كيفية تنسيق شرط في Shopify Flow:

1. انتقل إلى Shopify Dev Docs.
2. انقر على سؤال المساعد (Ask Assistant) لفتح لوحة الدردشة.
3. في حقل الرسالة، أدخل طلبك، مثل "ما هو المتغير الذي يجب أن أستخدمه في Shopify Flow إذا كنت أرغب في الوصول إلى بيانات علامة العميل عندما يبدأ المُشغّل بـ "تم إنشاء الطلب"؟".
4. اضغط على Enter أو انقر على .

قراءة الترميز النقطي للمتغيرات

عند تحديد المتغيرات، ستلاحظ أنها منسقة ككلمات مفتاحية مفصولة بنقاط، مثل order.customer.tag. يشير هذا التنسيق إلى الخطوات التي تتخذها API للوصول إلى البيانات التي تريد استخدامها. يتم فصل كل 'خطوة' للمتغير بنقطة، ويُقرأ مسار البيانات من اليسار إلى اليمين. يمكن أن تختلف المتغيرات في الطول بناءً على مكان تخزين البيانات في API والمسار الذي يتخذه سير العمل للوصول إليها.

على سبيل المثال:

• order.email: يتحقق من عنوان البريد الإلكتروني المرتبط بالعميل في الطلب. يشبه هذا الأمر كيف يمكنك النقر على طلب ثم التحقق من عنوان البريد الإلكتروني في تفاصيل الطلب.
• refunds_item.staffMember.name: يتحقق من الطلب بحثًا عن استرداد قيمة عنصر، وينتقل إلى معلومات الموظف المرتبطة بهذا الاسترداد، ويتحقق من الاسم الكامل لذلك الموظف.

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

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

سيعتمد المتغير الذي ستستخدمه لإرجاع نفس البيانات في Shopify Flow مسارًا مشابهًا: order.customer.statistics.rfmGroup.

متطلبات البيانات للمتغيرات

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

على سبيل المثال، إذا كان سير عملك يبدأ بمشغّل تم إنشاء منتج، فإن الشروط التي تنشئها من هذا المشغّل تقتصر على المتغيرات المتاحة من مجموعة بيانات المنتج. لذلك، فإن جميع المتغيرات مثل product.category.name وproduct.vendor وvariants_item.displayName متاحة للاستخدام كجزء من الشرط. على النقيض من ذلك، لن تُعرض المتغيرات مثل customer.verifiedEmail أو subscriptionContracts_item.status كخيارات، لأنها غير مرتبطة بمجموعة بيانات المنتج.

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

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

التحقق من مسار المتغير عند البحث استنادًا إلى الكلمات المفتاحية

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

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

• order.tags: الإشارات المطبقة على الطلب نفسه. على سبيل المثال، #rush order أو #gift.
• order.customer.tags: الإشارات المطبقة على العميل الذي قدم الطلب. على سبيل المثال، #VIP أو #affiliate.
• order.lineItems.product.tags: الإشارات المطبقة على المنتجات المشتراة في الطلب. على سبيل المثال، #fragile أو #requiresID.

بناءً على نوع الإشارات التي تريد أن يتحقق منها سير العمل، يجب عليك تحديد المتغير الصحيح حتى يعمل شرطك كما هو متوقع.

فهم العوامل المنطقية في الشروط

تحدد العوامل المنطقية كيفية تطبيق شرطك وتؤدي إلى أن تكون العبارة إما صحيحة أو خاطئة. عندما يُقرأ شرط "إذا كان A أكبر من 10..."، فإن الجزء is greater than هو العامل المنطقي. اختيار عامل منطقي لشرط هو في الأساس إخبار للشرط بكيفية تقييم المتغير.

في مسارات سير عمل Shopify Flow، هناك 3 أنواع من العوامل المنطقية:

• عوامل على مستوى الحقل، مثل أكبر من أو يبدأ بـ.
• عوامل على مستوى القائمة، مثل واحد على الأقل من أو الكل من.
• عوامل على مستوى الشرط، مثل AND أو OR.

يتم تطبيق العوامل على مستوى الحقل وعوامل القائمة على مستوى المتغير، ويتم تطبيق العوامل على مستوى الشرط على الشرط العام ويمكن استخدامها لدمج متغيرات متعددة في شرط واحد.

العوامل على مستوى الحقل هي الأنواع الأكثر شيوعًا من العوامل، وتُستخدم في كل نوع من عبارات المتغيرات. باستخدام العوامل على مستوى الحقل، يمكنك إنشاء عبارات شرطية مثل "إذا كان A أكبر من 10، فقم بتنفيذ X" أو "إذا كان B يحتوي على 'VIP'، فقم بتنفيذ X" للحصول على درجة أكبر من التحكم في قيم المتغير التي تُرجع نتيجة صحيحة. يساوي هو العامل المنطقي الافتراضي.

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

تتيح لك العوامل على مستوى الشرط مثل AND وOR تضمين متغيرات متعددة في نفس الشرط. على سبيل المثال، بدلاً من عبارة شرطية بسيطة مثل "إذا كان A يساوي 5، فقم بتنفيذ X"، يمكنك بناء شروط أكثر تعقيدًا مثل "إذا كان A يساوي 5 وB أكبر من 10، فقم بتنفيذ X" مما يتطلب أن يكون كلا المتغيرين A وB صحيحين، أو "إذا كان A يساوي 5 أو B أكبر من 10 أو C أقل من 1، فقم بتنفيذ X" مما يتطلب أن يكون واحد فقط من A أو B أو C صحيحًا. استخدم AND عندما يجب أن يكون كل شيء في سير العمل صحيحًا؛ واستخدم OR عندما يكون استيفاء معيار واحد كافيًا ليكون الشرط صحيحًا.

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

تعرّف على معلومات أكثر تفصيلاً حول المعاملات المنطقية في الشروط.