الحصول على بيانات الشركة
في مسارات العمل التي تستخدم بيانات الشركة، يمكنك استخدام إجراء الحصول على بيانات الشركة لاسترداد معلومات الشركة من متجرك.
التهيئة
الحقول
يحتوي إجراء الحصول على بيانات الشركة على الحقول التالية، والتي تُستخدم لإنشاء الاستعلام:
| الحقل | الوصف |
|---|---|
| فرز البيانات حسب | مطلوب. المعلمات التي يتم من خلالها فرز البيانات المُرجَعة بواسطة استعلام البحث. |
| الحد الأقصى لعدد النتائج | مطلوب. الحد الأقصى لعدد النتائج التي يمكن إرجاعها بواسطة استعلام البحث الذي تحدده. يمكنك إرجاع ما يصل إلى 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 GetCompanyData %}
* {{ single_company.name }}
{% endfor %}المُشغّلات
يمكنك استخدام هذا الإجراء في أي مسار عمل، بما في ذلك مُشغّل الوقت المجدول. وفي مسار العمل الذي يستخدم مُشغّل الوقت المجدول، يبدأ مسار العمل في الوقت الذي حددته، وليس نتيجة لحدث. ونظرًا لعدم وجود حدث معين في متجرك أو من أحد التطبيقات لبدء مسار العمل، فلن يتم تضمين أي بيانات تلقائيًا.