الحصول على بيانات متغيّر المنتج

في مهام سير العمل التي تستخدم بيانات متغيّر المنتج، يمكنك استخدام إجراء الحصول على بيانات متغيّر المنتج لاسترداد معلومات متغيّر المنتج من متجرك.

التكوين

الحقول

يحتوي إجراء الحصول على بيانات متغير المنتج على الحقول التالية، والتي تُستخدم لإنشاء الاستعلام:

سلسلة الاستعلام

فيما يلي مثال على استعلام للحصول على متغيرات المنتج التي تم تحديثها في اليوم الأخير:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

يُعد المتغير updated_at عامل تصفية متاحًا في استعلام متغيرات المنتج ويمكن استخدامه عدة مرات أو دمجه مع متغيرات أخرى. يتوفر متغير Liquid scheduledAt في مسارات العمل التي استخدمت مشغّل الوقت المجدول. يُعد وسم Liquid date_minus وسمًا خاصًا بتطبيق Flow يتيح لك طرح وقت من تاريخ.

عند الاستعلام عن البيانات، من المفيد معرفة ما يلي:

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

البيانات المستردة

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

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

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

{% for single_variant in GetProductVariantData %}
* {{ single_variant.name }}
{% endfor %}

المشغّلات

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

تفاصيل واجهة برمجة التطبيقات (API)

• مورد متغير المنتج
• عوامل تصفية استعلام متغير المنتج

القوالب

إضافة عنصر مجاني (بخصم 100%) للطلبات الجديدة

يضيف هذا القالب عنصرًا مجانيًا مخفضًا إلى الطلبات الجديدة إذا كان العنصر متوفرًا في المخزون. يتحقق القالب من المخزون، ويطبق خصمًا بنسبة 100%، ويحدّث الطلب دون إعلام العميل. ستكون هذه الأتمتة مفيدة في (1) تعزيز رضا العملاء من خلال تضمين عنصر مجاني مفاجئ في طلبهم، (2) الترويج لمنتجات جديدة أو غير معروفة من خلال إضافتها كعينات مجانية في الطلبات، أو (3) تبسيط العروض الترويجية من خلال أتمتة تضمين العناصر المجانية وخصمها. عرض القالب

إرسال ملخص أسبوعي بالبريد الإلكتروني يحتوي على قائمة بالمتغيرات منخفضة المخزون

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