קבלת נתונים של פריט מערכת מלאי

בזרימות עבודה שדורשות נתונים של פריטי מערכת מלאי, אפשר להשתמש בפעולה Get inventory item data כדי לאחזר מידע על פריטי מערכת מלאי מהחנות שלך. פריטי מערכת מלאי מייצגים את יחידות המלאי בפועל שנמצאות תחת מעקב עבור גרסאות מוצר.

הגדרת תצורה

שדות

הפעולה Get inventory item data מכילה את השדות הבאים:

מחרוזת שאילתה

זוהי שאילתה לדוגמה לקבלת פריטי מערכת מלאי שנמצאים תחת מעקב:

tracked:true

המשתנה tracked הוא מסנן שזמין בשאילתת פריטי מערכת המלאי וניתן להשתמש בו מספר פעמים או לשלב אותו עם משתנים אחרים.

בעת תשאול נתונים, כדאי לדעת את הדברים הבאים:

• רשימה של מסנני פריט מערכת מלאי זמינים

• שאילתות חייבות להיות בהתאם לתחביר מסוים

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

• ניתן להפעיל או לבדוק שאילתה בחנות שלך באמצעות האפליקציה Shopify GraphiQL.

• יש לשים לב למה שקורה במקרה של כשל בשאילתה. לרוב ה-API יחזיר את כל התוצאות (במקום לא להחזיר אף תוצאה).

נתונים שהוחזרו

כל הפעולות מסוג Get data מחזירות רשימה שכוללת בין 0 ל-100 משאבים. בהתאם לתרחיש השימוש שלך, ייתכן שתרצה להשתמש בנתונים האלה בדרכים שונות:

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

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

{% for single_inventory_item in getInventoryItemData %}
  * SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}

טריגרים

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

הפניה ל-API

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