الحصول على بيانات طلب التجهيز

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

التكوين

الحقول

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

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

هذا مثال على استعلام للحصول على طلبات التنفيذ المُعلّقة حاليًا:

status:ON_HOLD

يُعد المتغير status عامل تصفية متاحًا في استعلام طلبات التنفيذ ويمكن استخدامه عدة مرات أو دمجه مع متغيرات أخرى.

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

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

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

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

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

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

{% for fulfillment_order in GetFulfillmentOrderData %}
* Order: {{ fulfillment_order.order.name }} Location: {{ fulfillment_order.assignedLocation.name }}
{% endfor %}

المُشغّلات

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

تفاصيل API

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

القوالب

إرسال ملخص يومي عبر البريد الإلكتروني مع قائمة بطلبات التنفيذ المُعلّقة

سيقوم سير العمل هذا بالاستعلام يوميًا عن جميع طلبات التنفيذ المُعلّقة (ما يصل إلى 100 طلب في المرة الواحدة). وسيُرسل ملخصًا عبر البريد الإلكتروني يتضمن اسم الطلب وموقع التنفيذ المعيَّن. عرض القالب