الحصول على بيانات عنصر المخزون

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

التهيئة

الحقول

يحتوي إجراء الحصول على بيانات عنصر المخزون على الحقول التالية:

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

هذا مثال على استعلام للحصول على عناصر المخزون المُتتبعة:

tracked:true

المتغير tracked هو عامل تصفية متاح في استعلام عناصر المخزون ويمكن استخدامه عدة مرات أو دمجه مع متغيرات أخرى.

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

• قائمة عوامل تصفية عناصر المخزون المتاحة

• يجب أن تتبع الاستعلامات بناء جملة معينًا

• لا يتم توثيق قيم حقول الاستعلام دائمًا. في بعض الحالات، يمكن العثور على القيم من خلال الاطلاع على مستندات API. كبديل، يمكنك غالبًا العثور على قيم الحقول في عناوين URL في لوحة تحكم المسؤول عند استخدام عوامل التصفية. على سبيل المثال، للعثور على بعض قيم استعلام الطلب، قم بتصفية صفحة الطلبات في لوحة تحكم المسؤول، ثم تحقق من عنوان URL.

• يمكنك تشغيل استعلام أو اختباره في متجرك باستخدام تطبيق Shopify GraphiQL.

• كن على دراية بما سيحدث في حال فشل استعلامك. فغالبًا ما ستُرجع واجهة برمجة التطبيقات (API) جميع النتائج (بدلاً من عدم إرجاع أي نتيجة).

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

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

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

للوصول إلى البيانات المرجعة في الخطوات التي تلي هذا الإجراء، استخدم المتغير المسمى Get inventory item data (الحصول على بيانات عنصر المخزون)، والذي يمثل قائمة بعناصر المخزون. يمكنك استخدام هذا المتغير في كل من الشروط والإجراءات. على سبيل المثال، يمكنك إرسال قائمة عناصر المخزون في إجراء Send internal email (إرسال بريد إلكتروني داخلي) بشكل مشابه لما يلي:

{% for single_inventory_item in getInventoryItemData %}
  * SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}

المشغلات

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

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

لمزيد من المعلومات حول واجهة برمجة التطبيقات (API) المستخدمة في هذا الإجراء، راجع استعلام عناصر المخزون.