קבלת נתוני טיוטת הזמנה
בזרימות עבודה שמשתמשות בנתוני טיוטת הזמנה, ניתן להשתמש בפעולה קבלת נתוני טיוטת הזמנה כדי לאחזר מידע על טיוטות הזמנה מהחנות שלך.
תצורה
שדות
הפעולה קבלת נתוני טיוטת הזמנה מכילה את השדות הבאים, שמשמשים לבניית השאילתה:
| שדה | תיאור |
|---|---|
| מיון נתונים לפי | חובה. הפרמטרים שלפיהם ממוינים הנתונים שמוחזרים על ידי שאילתת החיפוש. |
| מספר תוצאות מרבי | חובה. הכמות המרבית של תוצאות שיכולות להיות מוחזרות על ידי שאילתת החיפוש שבחרת. ניתן לאחזר עד 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_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}טריגרים
ניתן להשתמש בפעולה זו בכל זרימת עבודה, כולל הטריגר שעה מתוזמנת. בזרימת עבודה שמשתמשת בטריגר שעה מתוזמנת, זרימת העבודה מתחילה בשעה שציינת, ולא כתוצאה מאירוע. מאחר שאין אירוע ספציפי בחנות שלך או מיישום שמתחיל את זרימת העבודה, אין נתונים שנכללים באופן אוטומטי.
פרטי API
תבניות
שליחת התראה יומית עם כל טיוטות ההזמנה הפתוחות
מדי יום, קבלת טיוטות הזמנה פתוחות, ספירתן ושליחת הודעת Slack. משתמש בטריגר 'שעה מתוזמנת' ובפעולות 'קבלת טיוטות הזמנה' ו'ספירה'. צפייה בתבנית