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

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

التكوين

الحقول

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

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

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

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 each).
• إذا كنت بحاجة إلى تجميع البيانات، مثل حساب عدد النتائج التي تم إرجاعها، فيمكنك استخدام إجرائي العدد أو المجموع.
• إذا كنت بحاجة إلى إخراج القائمة، مثل إرسال بريد إلكتروني يحتوي على جميع العناصر، فيمكنك استخدام البيانات المُرجعة مباشرةً في الإجراءات اللاحقة.

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

{% for single_product in GetProductData %}
* {{ single_product.name }}
{% endfor %}

المُشغّلات

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

تفاصيل API

• مورد المنتج
• فلاتر استعلام المنتجات

القوالب

إضافة المنتجات التي تحتوي على علامة إلى مجموعة في المستقبل

في وقت لاحق في المستقبل، احصل على جميع المنتجات التي تحتوي على علامة معينة ثم أضفها إلى مجموعة. عرض القالب

حذف المنتجات غير النشطة

احذف المنتجات التي ليس لها مخزون ولم يتم تحديثها منذ عام. عرض القالب

نشر المنتجات التي تحتوي على علامة معينة في المستقبل

في تاريخ لاحق في المستقبل، احصل على المنتجات التي تحتوي على علامة معينة وانشرها. يستخدم مُشغّل الوقت المُجدوَل وإجراء الحصول على بيانات المنتج. عرض القالب

إزالة علامة المنتج الجديد بعد 90 يومًا من إنشاء المنتج

احصل كل يوم على ما يصل إلى 100 منتج تم إنشاؤها منذ أكثر من 90 يومًا وما زالت تحتوي على علامة "جديد (new)". بعد ذلك، يُزيل سير العمل هذه العلامات من كل منتج. عرض القالب

جدولة إزالة المنتجات من المتجر الإلكتروني في التاريخ والوقت المحددين

في تاريخ محدد في المستقبل، أزل المنتجات من المتجر الإلكتروني حسب العلامة أو المعرّف (id) أو رمز التخزين التعريفي (SKU). يستفيد من مُشغّل الوقت المُجدوَل، وإجراء الحصول على بيانات المنتج، وحلقة لكل (For Each). عرض القالب

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

احصل كل يوم على جميع المنتجات التي يبلغ مخزونها 0 وأرسل ملخصًا عبر البريد الإلكتروني. يستخدم الحصول على بيانات المنتج، ومُشغّل الوقت المُجدوَل. عرض القالب

إرسال إشعار عبر البريد الإلكتروني عند إضافة متغيّر برمز تخزين تعريفي (SKU) مكرر

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

تتبع متغيّرات المنتجات المشمولة في التخفيضات باستخدام حقل وصفي للمنتج

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