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

في عمليات سير العمل التي تتطلب بيانات الموقع، يمكنك استخدام إجراء الحصول على بيانات الموقع لاسترداد معلومات الموقع من متجر Shopify الخاص بك. المواقع هي أي مكان تقوم فيه بتخزين المخزون، أو بيع المنتجات، أو شحن الطلبات أو تنفيذها.

التكوين

الحقول

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

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

هذا مثال على استعلام للحصول على المواقع التي تم تفعيل الاستلام من المتجر بها:

pickup_in_store:enabled

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

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

• قائمة عوامل تصفية المواقع المتاحة

• يجب أن تتبع الاستعلامات صيغة معينة

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

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

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

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

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

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

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

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

المشغلات

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

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

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