עזרה
התחברות

תצוגה מקדימה של נתוני API שמשמשים ב-Shopify Flow

רוב זרימות העבודה ניגשות לנתונים מהחנות שלך, כך שתוכל להשתמש בהם בתנאים ובפעולות. Shopify Flow ניגש לנתוני חנות על ידי קריאה ל-GraphQL Admin API, מה שמעניק לך גישה כמעט לכל השדות ב-API.

במהלך בניית זרימת עבודה, תיתקל לעתים קרובות בשמות שדות ותיאורים המבוססים על ה-API, אך ייתכן שתצטרך לדעת מהם הערכים של הנתונים האלה. לדוגמה, ייתכן שתרצה לדעת מהו שם האפליקציה עבור הזמנה שנוצרה מתוך טיוטת הזמנה. בנוסף, ייתכן שתרצה לוודא שזרימת העבודה שלך מפיקה את הנתונים להם אתה מצפה, או בצורה לה אתה מצפה.

כדי לעיין בערכים של הנתונים, יש לך מספר אפשרויות ב-Shopify Flow.

בדף זה

איתור שדה במנהל של Shopify

ברוב המקרים, ניתן למצוא נתונים על ידי חיפוש במנהל של Shopify. לדוגמה, product.title מופיע בדף Product (מוצר).

קבלת נתונים לדוגמה

בעת בניית זרימת עבודה, אפשר לקבל נתונים לדוגמה ישירות בעורך של Flow. מכיוון שהנתונים של Flow מגיעים מאירועים, על מנת לקבל נתונים מדויקים לדוגמה, עליך להתחיל בבחירת אירוע רלוונטי:

  1. בעורך של Flow, פתח פעולה שבה ברצונך להשתמש בנתונים ולחץ על הוספת משתנה (Add a variable). לחלופין, בתנאי, לחץ על הוספת קריטריון (Add criteria).
  2. לחץ על הגדרת נתונים לדוגמה (Configure sample data).
  3. Flow מציג אירועים קודמים המבוססים על הטריגר של זרימת העבודה. לחץ על רענון אירועים (Refresh events) כדי לאחזר אירועים מהריצות האחרונות, או לחץ על התחל להאזין לאירועים חיים (Start listening for live events) ואז הפעל את האירוע באופן ידני במנהל או באפליקציה הרלוונטית (עבור טריגרים מבוססי אפליקציה).
  4. לאחר התרחשות האירוע, Flow יציג פרטים לגביו. בחר באירוע שבו ברצונך להשתמש כדי לקבל נתונים לדוגמה. לחץ על שימוש באירוע טריגר זה (Use this trigger event).
  5. כעת, בזמן דפדוף בין אירועים, יוצגו נתונים לדוגמה עבור כל משתנה.

מגבלות:

  • עקב אילוצי מקום, עבור נתונים ברשימה, Flow יציג נתונים רק מהפריט הראשון שברשימה.
  • Flow ישמור עד 5 אירועים בכל פעם, לכל זרימת עבודה.
  • ל-Flow אין אפשרות לשלוף אירועים מריצות אחרונות עבור טריגרים מסוימים, כגון Scheduled time (זמן מתוזמן), ‏Metaobject entry created (נוצרה רשומת מטא אובייקט), ‏Customer joined segment (לקוח הצטרף לפלח), או Customer left segment (לקוח עזב פלח).

שימוש בשדה בזרימת עבודה פעילה

אפשר להשתמש בשדות בבטחה בזרימת עבודה באמצעות הפעולה Log output (פלט יומן). בעת הפעלת זרימת עבודה, הפעולה Log output (פלט יומן) תדפיס את הפלט של כל משתנה וטקסט לעמוד Run history (היסטוריית ריצות). אפשר גם להשתמש בפעולות התראה כמו Send internal email (שליחת אימייל פנימי).

שלבים לשימוש בפלט יומן:

  1. יש לבחור טריגר שאפשר להפעיל באופן ידני.
  2. יש להוסיף את הפעולה Log output (פלט יומן) לזרימת העבודה ולחבר אותה לטריגר.
  3. בהגדרות Log output (פלט יומן), יש ללחוץ על Add a variable (הוספת משתנה) כדי להוסיף את המשתנים שרוצים לבדוק לסעיף Output (פלט).
  4. בסיום, יש ללחוץ על Turn on workflow (הפעלת זרימת עבודה).
  5. יש להפעיל את זרימת העבודה, על ידי הפעלתה באופן ידני או על ידי גרימה לטריגר לפעול. לדוגמה, אם משתמשים בטריגר Order created (נוצרה הזמנה), יש ליצור הזמנת בדיקה.
  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

שימוש ב-GraphiQL או בכלי API של צד שלישי

אפשר לבצע שאילתות ל-API באופן ישיר באמצעות כלי API של צד שלישי כגון Postman או הכלי החינמי GraphiQL ש-Shopify מספקת. אפשרות זו מספקת את התוצאות המדויקות ביותר, אך היא דורשת היכרות מסוימת עם יצירת שאילתות ב-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"
            }
          }
        }
      ]
    }
  }