الحصول على بيانات بطاقة الهدايا
في مسارات سير العمل التي تتطلب بيانات بطاقة الهدايا، يمكنك استخدام إجراء الحصول على بيانات بطاقة الهدايا لاسترداد معلومات بطاقة الهدايا من متجرك.
من المهم ملاحظة أن متجرك يحتوي على كلٍ من منتجات بطاقات الهدايا، والتي تُستخدم لإنشاء بطاقات الهدايا، وبطاقات الهدايا نفسها، وهي بطاقات الهدايا الفعلية التي يمكن للعملاء استخدامها لإجراء عمليات شراء. يسترد إجراء الحصول على بيانات بطاقة الهدايا معلومات حول بطاقات الهدايا نفسها. للحصول على معلومات حول منتجات بطاقات الهدايا، استخدم إجراءي الحصول على بيانات المنتج أو الحصول على بيانات متغير المنتج.
في هذه الصفحة
التكوين
الحقول
يحتوي إجراء الحصول على بيانات بطاقة الهدايا على الحقول التالية، والتي تُستخدم لإنشاء الاستعلام:
| الحقل | الوصف |
|---|---|
| فرز البيانات حسب | مطلوب. المُحدّدات التي يتم من خلالها فرز البيانات المُرجعة بواسطة استعلام البحث. |
| الحد الأقصى لعدد النتائج | مطلوب. الحد الأقصى لعدد النتائج التي يمكن إرجاعها من خلال استعلام البحث الذي تحدده. يمكنك إرجاع ما يصل إلى 100 نتيجة في المرة الواحدة. |
| استعلام | مطلوب. اختر من بين الاستعلامات الشائعة أو حدد متقدم لإنشاء استعلام خاص بك. |
سلسلة الاستعلام
هذا مثال على استعلام للحصول على بطاقات الهدايا التي تم تحديثها في اليوم الأخير:
created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'المتغير created_at هو عامل تصفية متاح في استعلام بطاقات الهدايا ويمكن استخدامه عدة مرات أو دمجه مع متغيرات أخرى. يتوفر متغير Liquid المسمى scheduledAt في عمليات سير العمل التي استخدمت مُشغّل الوقت المجدول. علامة Liquid المسماة date_minus هي علامة Flow خاصة تتيح لك طرح وقت من تاريخ.
عند الاستعلام عن البيانات، من المفيد معرفة ما يلي:
يجب أن تتبع الاستعلامات بناء جملة معينًا
لا يتم توثيق قيم حقول الاستعلام دائمًا. في بعض الحالات، يمكن العثور على القيم من خلال الاطلاع على مستندات API. كبديل، يمكنك غالبًا العثور على قيم الحقول في عناوين URL في لوحة تحكم المسؤول عند استخدام عوامل التصفية. على سبيل المثال، للعثور على بعض قيم استعلام الطلب، قم بتصفية صفحة الطلبات في لوحة تحكم المسؤول، ثم تحقق من عنوان URL.
يمكنك تشغيل استعلام أو اختباره في متجرك باستخدام تطبيق Shopify GraphiQL.
كن على دراية بما سيحدث في حال فشل استعلامك. فغالبًا ما ستُرجع واجهة برمجة التطبيقات (API) جميع النتائج (بدلاً من عدم إرجاع أي نتيجة).
البيانات المُرجَعة
ترجع جميع إجراءات الحصول على بيانات قائمة تتراوح ما بين 0 و100 مورد. بناءً على حالة الاستخدام الخاصة بك، قد ترغب في استخدام هذه البيانات بطرق مختلفة:
- إذا كنت بحاجة إلى التعامل مع كل عنصر في القائمة بشكل فردي، كإضافة علامة لكل منها، فيمكنك استخدام الإجراء لكل.
- إذا كنت بحاجة إلى تجميع البيانات، مثل حساب عدد النتائج المُرجَعة، فيمكنك استخدام الإجراءين العدد أو المجموع.
- إذا كنت بحاجة إلى إخراج القائمة، مثل إرسال بريد إلكتروني يتضمن جميع العناصر، فيمكنك استخدام البيانات المُرجَعة مباشرةً في الإجراءات اللاحقة.
للوصول إلى البيانات المُرجَعة في الخطوات التي تلي هذا الإجراء، استخدم المتغير المسمى الحصول على بيانات بطاقة الهدايا، وهو عبارة عن قائمة ببطاقات الهدايا. يمكنك استخدام هذا المتغير في كلٍ من الشروط والإجراءات. على سبيل المثال، يمكنك إرسال قائمة بطاقات الهدايا في الإجراء إرسال بريد إلكتروني داخلي كما يلي:
{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}المُشغِّلات
يمكنك استخدام هذا الإجراء في أي سير عمل، بما في ذلك مُشغّل الوقت المجدول. في سير العمل الذي يستخدم مُشغّل الوقت المجدول، يبدأ سير العمل في الوقت الذي حددته، وليس نتيجةً لحدث معين. ونظرًا لعدم وجود حدث محدد في متجرك أو من تطبيق يبدأ سير العمل، فلا يتم تضمين أي بيانات تلقائيًا.