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