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