الحصول على بيانات مسودة الطلب

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

التهيئة

الحقول

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

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

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

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

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

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

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

البيانات المُرجَعة

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

• إذا كنت بحاجة إلى التعامل مع كل عنصر قائمة على حدة، مثل إضافة إشارة لكل عنصر، فيمكنك استخدام إجراء لكل عنصر (For each).
• إذا كنت بحاجة إلى تجميع البيانات، مثل حساب عدد النتائج التي تم إرجاعها، فيمكنك استخدام إجراء العدّ (Count) أو المجموع (Sum).
• إذا كنت بحاجة إلى إخراج القائمة، مثل إرسال بريد إلكتروني يحتوي على جميع العناصر، فيمكنك استخدام البيانات المُرجَعة مباشرةً في الإجراءات اللاحقة.

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

{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}

المُشغِّلات

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

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

• مورد مسودة الطلب
• عوامل تصفية استعلام مسودة الطلب

القوالب

إرسال إشعار يومي بجميع مسودات الطلبات المفتوحة

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