الحصول على بيانات الصفحة

في عمليات سير العمل التي تتطلب بيانات الصفحة، يمكنك استخدام إجراء الحصول على بيانات الصفحة لاسترداد معلومات الصفحة من متجرك. الصفحات هي صفحات الويب الموجودة في متجرك الإلكتروني والتي تحتوي على معلومات نادرًا ما تتغير، مثل صفحة "من نحن" أو صفحة "اتصل بنا".

التكوين

الحقول

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

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

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

published_status:published

المتغير published_status هو عامل تصفية متاح في استعلام الصفحات ويمكن استخدامه عدة مرات أو دمجه مع متغيرات أخرى.

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

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

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

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

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

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

البيانات المسترجعة

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

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

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

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

المشغّلات

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

مرجع API

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