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

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

التهيئة

الحقول

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

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

هذا مثال على استعلام للحصول على المقالات المنشورة في اليوم الماضي:

published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'

المتغير published_at هو عامل تصفية متاح في استعلام المقالات ويمكن استخدامه عدة مرات أو دمجه مع متغيرات أخرى. يتوفر متغير Liquid المسمى scheduledAt في عمليات سير العمل التي تستخدم مشغّل الوقت المُجدوَل. علامة Liquid المسماة date_minus هي علامة خاصة بتطبيق Shopify Flow تتيح لك طرح الوقت من تاريخ.

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

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

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

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

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

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

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

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

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

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

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

المشغّلات

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

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

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