معاينة بيانات واجهة برمجة التطبيقات (API) المستخدمة في Shopify Flow

تصل معظم مسارات العمل إلى البيانات من متجرك، حتى تتمكن من استخدامها في الشروط والإجراءات. يصل Shopify Flow إلى بيانات المتجر عن طريق استدعاء GraphQL Admin API، مما يتيح لك الوصول إلى جميع الحقول الموجودة في واجهة برمجة التطبيقات تقريبًا.

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

لمراجعة قيم البيانات، يتوفر لديك عدة خيارات في Shopify Flow.

العثور على حقل في مسؤول Shopify

في معظم الحالات، يمكنك العثور على البيانات بالبحث في مسؤول Shopify. على سبيل المثال، يُدرج product.title في صفحة المنتج.

الحصول على بيانات نموذجية

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

1. في محرر Flow، افتح إجراءً تريد استخدام البيانات فيه وانقر على إضافة متغير. وبدلاً من ذلك، في أحد الشروط، انقر على إضافة معايير.
2. انقر على تهيئة البيانات النموذجية.
3. يعرض Flow الأحداث السابقة بناءً على مُشغِّل سير العمل. انقر على تحديث الأحداث لجلب الأحداث من عمليات التشغيل الأخيرة، أو انقر على بدء الاستماع للأحداث المباشرة ثم قم بتنشيط الحدث يدويًا في مسؤول Shopify أو التطبيق ذي الصلة (بالنسبة للمُشغِّلات المستندة إلى التطبيق).
4. بعد وقوع الحدث، سيعرض Flow تفاصيل حول الحدث. اختر الحدث الذي تريد استخدامه للحصول على بيانات نموذجية. انقر على استخدام حدث المُشغِّل هذا.
5. الآن، أثناء تصفحك للأحداث، يجب أن تظهر البيانات النموذجية لكل متغير.

القيود:

• نظرًا لقيود المساحة، بالنسبة للبيانات الموجودة في قائمة، لن يعرض Flow سوى البيانات من العنصر الأول في القائمة.
• سيُخزن Flow ما يصل إلى 5 أحداث في المرة الواحدة، لكل سير عمل.
• لا يمكن لتطبيق Flow جلب الأحداث من عمليات التشغيل الحديثة لبعض المشغّلات، مثل الوقت المجدول، أو إنشاء مُدخل كائن تعريفي، أو انضمام عميل إلى شريحة، أو مغادرة عميل لشريحة.

استخدام الحقل في سير عمل نشط

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

خطوات استخدام تسجيل المخرجات:

1. اختر مشغّلاً يمكن تشغيله يدويًا.
2. أضف إجراء تسجيل المخرجات إلى سير العمل واربطه بالمشغّل.
3. في إعدادات تسجيل المخرجات، انقر على إضافة متغير لإضافة المتغيرات التي تريد فحصها إلى قسم المخرجات.
4. عند الانتهاء، انقر على تشغيل سير العمل.
5. شغّل سير العمل، إما عن طريق تشغيله يدويًا أو عن طريق التسبب في إطلاق المشغّل. على سبيل المثال، إذا كنت تستخدم مشغّل إنشاء طلب، فقم بإنشاء طلب تجريبي.
6. بعد تشغيل سير العمل، تحقق من سجل النشاط للبحث عن المتغيرات.

الرجوع إلى صفحة مورد JSON

تتيح لك معظم صفحات الموارد في مسؤول Shopify، مثل صفحات الطلب أو المنتج أو العميل، عرض البيانات التي تخدم الصفحة. لا تتطابق هذه البيانات تمامًا في التسمية والتنسيق مع ما يستخدمه تطبيق Shopify Flow، ولكن القيم تتطابق مع ما هو موجود في GraphQL Admin API. لمراجعة البيانات، أضف .json إلى عنوان URL.

على سبيل المثال، انتقل إلى طلب بالذهاب في مسؤول Shopify إلى صفحة الطلبات والنقر على طلب. في عنوان الصفحة في شريط العناوين بمتصفحك، غيّر العنوان من:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234

إلى ما يلي:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json

ملاحظة

يتّبع تنسيق .json واجهة REST API. تستخدم حالة أحرف أسماء المتغيرات في REST API شرطات سفلية، مثل line_items. ويستخدم GraphQL وShopify Flow تنسيق camelCasing (أحرف استهلالية كبيرة للكلمات المتصلة)، مثل lineItems. بالإضافة إلى ذلك، تختلف أسماء الحقول أحيانًا، مثل properties بدلاً من customAttributes. تحقق من المعلومات التي تجدها باستخدام هذا النهج.

استخدام GraphiQL أو أداة واجهة برمجة تطبيقات (API) لجهة خارجية

يمكنك الاستعلام مباشرة من واجهة برمجة التطبيقات (API) باستخدام أداة واجهة برمجة تطبيقات لجهة خارجية مثل Postman أو الأداة المجانية المقدمة من Shopify وهي GraphiQL. يوفر هذا الخيار أدق النتائج، ولكنه يتطلب بعض الإلمام بإنشاء استعلامات GraphQL.

بالنسبة لأداة GraphiQL، تقدم Shopify كلاً من مستكشف GraphiQL المستند إلى الويب ببيانات عامة وتطبيق GraphiQL. باستخدام GraphiQL، يمكنك إنشاء استعلام GraphQL يتطابق تمامًا مع أسماء الحقول في Shopify Flow. تتطابق القيم أيضًا تمامًا مع متجرك إذا كنت تستخدم التطبيق.

باستخدام هذه الأداة، يمكنك تحديد البيانات التي يستخدمها Shopify Flow بالضبط، مع بيانات متجرك الحقيقية. على سبيل المثال، يمكنك إنشاء الاستعلام التالي:

{
  orders(first:5, reverse:true) {
    nodes {
      createdAt
      app {
        name
      }
      channelInformation {
        app {
          title
        }
      }
    }
  }
}

في النتائج التالية، يعرض المتغير order / app / name اسم التطبيق للطلب. في هذه الحالة، تم إنشاء الطلب من تطبيق طلبات المسودات، لذا فإن القيمة هي Draft Orders. تتوفر معلومات القناة فقط لتطبيق Point of Sale.

{
  "data": {
    "orders": {
      "nodes": [
        {
          "createdAt": "2023-04-10T12:32:41Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-04-10T12:29:12Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:23:10Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:20:53Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T15:45:15Z",
          "app": {
            "name": "Point of Sale"
          },
          "channelInformation": {
            "app": {
              "title": "Point of Sale"
            }
          }
        }
      ]
    }
  }