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