الحصول على بيانات جلسة تتبع النقد

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

التهيئة

الحقول

يحتوي إجراء الحصول على بيانات جلسة تتبّع النقد على الحقول التالية.

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

فيما يلي مثال على استعلام للحصول على جلسات تتبّع النقد التي تم إغلاقها في اليوم الأخير:

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

المتغيّر closing_time هو عامل تصفية متاح في استعلام CashTrackingSessions ويمكن استخدامه عدّة مرّات أو دمجه مع متغيّرات أخرى. يتوفّر متغيّر Liquid المسمّى scheduledAt في مهام سير العمل التي استخدمت مُشغّل الوقت المُجدوَل (Scheduled time). علامة Liquid المسمّاة date_minus هي علامة Flow خاصة تتيح لك طرح وقت من تاريخ معيّن.

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

• قائمة عوامل التصفية المتاحة لجلسات تتبّع النقد

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

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

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

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

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

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

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

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

{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}

المُشغّلات

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

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

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