קבלת נתוני גרסת מוצר
בזרימות עבודה שמשתמשות בנתוני גרסאות מוצרים, ניתן להשתמש בפעולה Get product variant data כדי לאחזר מידע על גרסאות מוצרים מהחנות.
תצורה
שדות
הפעולה קבלת נתוני גרסת מוצר מכילה את השדות הבאים, שמשמשים לבניית השאילתה:
| שדה | תיאור |
|---|---|
| מיון נתונים לפי | חובה. הפרמטרים שלפיהם ממוינים הנתונים שמוחזרים על ידי שאילתת החיפוש. |
| מספר התוצאות המרבי | חובה. המספר המרבי של תוצאות שיכולות להיות מוחזרות משאילתת החיפוש שבחרת. אפשר להחזיר עד 100 בכל פעם. |
| שאילתה | חובה. אפשר לבחור מתוך שאילתות נפוצות או לבחור באפשרות מתקדם כדי ליצור שאילתה משלך. |
מחרוזת שאילתה
זוהי שאילתה לדוגמה לקבלת גרסאות מוצר שעודכנו ביום האחרון:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'המשתנה updated_at הוא מסנן שזמין בשאילתת גרסאות המוצר ואפשר להשתמש בו מספר פעמים או לשלב אותו עם משתנים אחרים. המשתנה Liquid scheduledAt זמין בזרימות עבודה שהשתמשו בטריגר של זמן מתוזמן. התג Liquid date_minus הוא תג Flow מיוחד שמאפשר להחסיר זמן מתאריך.
בעת יצירת שאילתת נתונים, כדאי לדעת:
- רשימה של מסננים זמינים לגרסאות מוצר
- שאילתות צריכות לעקוב אחר תחביר מסוים
- הערכים של שדות השאילתה לא תמיד מתועדים. במקרים מסוימים, אפשר למצוא את הערכים על ידי עיון בתיעוד של ה-API. לחלופין, לרוב אפשר למצוא את ערכי השדות בכתובות ה-URL במנהל כאשר מבצעים סינון. לדוגמה, כדי למצוא ערכים של שאילתת 'הזמנות', יש לסנן את הדף 'הזמנות' במנהל ולבדוק את כתובת ה-URL.
- אפשר להפעיל או לבדוק שאילתה בחנות שלך באמצעות היישום Shopify GraphiQL.
- שים לב למה שקורה אם השאילתה נכשלת. לרוב ה-API יחזיר את כל התוצאות (במקום כלום).
נתונים שהוחזרו
כל הפעולות מסוג קבלת נתונים מחזירות רשימה של בין 0 ל-100 משאבים. בהתאם למקרה השימוש, ייתכן שתרצה להשתמש בנתונים אלה בדרכים שונות:
- אם עליך לטפל בכל פריט ברשימה בנפרד, לדוגמה כדי להוסיף תג לכל אחד מהם, תוכל להשתמש בפעולה עבור כל אחד.
- אם עליך לצבור נתונים, לדוגמה לספור כמה תוצאות הוחזרו, תוכל להשתמש בפעולות ספירה או סכום.
- אם עליך להפיק פלט של הרשימה, לדוגמה לשלוח דוא"ל עם כל הפריטים, תוכל להשתמש בנתונים שהוחזרו ישירות בפעולות הבאות.
כדי לגשת לנתונים שהוחזרו בשלבים שבאים לאחר פעולה זו, יש להשתמש במשתנה שנקרא קבלת נתוני גרסת מוצר, שהוא רשימה של גרסאות מוצר. אפשר להשתמש במשתנה זה גם בתנאים וגם בפעולות. לדוגמה, אפשר לשלוח את רשימת ההזמנות בפעולת שליחת דוא"ל פנימי כך:
{% for single_variant in GetProductVariantData %}
* {{ single_variant.name }}
{% endfor %}טריגרים
אפשר להשתמש בפעולה זו בכל זרימת עבודה, כולל בטריגר זמן מתוזמן. בזרימת עבודה שמשתמשת בטריגר זמן מתוזמן, זרימת העבודה מתחילה בזמן שציינת, ולא כתוצאה מאירוע. מכיוון שאין אירוע מסוים בחנות שלך או מיישום שמתחיל את זרימת העבודה, לא נכללים נתונים באופן אוטומטי.
פרטי API
תבניות
הוספת פריט בחינם (בהנחה של 100%) להזמנות חדשות
תבנית זו מוסיפה פריט בחינם, בהנחה, להזמנות חדשות אם הפריט נמצא במלאי. היא בודקת את מערכת המלאי, מחילה הנחה של 100% ומעדכנת את ההזמנה ללא יידוע הלקוח. אוטומציה זו תהיה שימושית כדי (1) לשפר את שביעות רצון הלקוחות על ידי הוספת פריט הפתעה בחינם להזמנה שלהם, (2) לקדם מוצרים חדשים או מוכרים פחות על ידי הוספתם כדוגמיות בחינם להזמנות, או (3) לייעל מבצעים על ידי אוטומציה של הכללת פריטים בחינם ומתן הנחה עליהם. הצג תבנית
שליחת סיכום שבועי בדוא"ל עם רשימת גרסאות במלאי נמוך
זרימת עבודה זו פועלת לפי לוח זמנים (לדוגמה, פעם בשבוע). היא מקבלת רשימה של גרסאות מוצר שנמצאות במלאי נמוך, סופרת את התוצאות ושולחת סיכום בדוא"ל עם כותרות הגרסאות וקישור לדף המנהל של הגרסה. הצג תבנית