קבלת נתוני כרטיס מתנה
בזרימות עבודה שדורשות נתוני כרטיסי מתנה, ניתן להשתמש בפעולה קבלת נתוני כרטיס מתנה (Get gift card data) כדי לאחזר מידע על כרטיסי מתנה מהחנות.
חשוב לדעת שבחנות שלך יש גם מוצרי כרטיס מתנה (gift card products), שמשמשים להפקת כרטיסי מתנה, וגם כרטיסי מתנה עצמם, שהם כרטיסי המתנה בפועל שלקוחות יכולים להשתמש בהם לביצוע רכישות. הפעולה קבלת נתונים של כרטיס מתנה מאחזרת מידע על כרטיסי המתנה עצמם. כדי לקבל מידע על מוצרי כרטיס מתנה, יש להשתמש בפעולות קבלת נתונים של מוצר או קבלת נתונים של גרסת מוצר.
תצורה
שדות
הפעולה קבלת נתונים של כרטיס מתנה מכילה את השדות הבאים, המשמשים לבניית השאילתה:
| שדה | תיאור |
|---|---|
| מיון נתונים לפי | חובה. הפרמטרים שלפיהם ימוינו הנתונים המוחזרים משאילתת החיפוש. |
| מספר התוצאות המקסימלי | חובה. הכמות המקסימלית של תוצאות שניתן להחזיר משאילתת החיפוש שבחרת. ניתן להחזיר עד 100 בכל פעם. |
| שאילתה | חובה. יש לבחור מבין שאילתות נפוצות או לבחור באפשרות מתקדם כדי ליצור שאילתה משלך. |
מחרוזת שאילתה
זוהי שאילתה לדוגמה לקבלת כרטיסי מתנה שעודכנו ביום האחרון:
created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'המשתנה created_at הוא מסנן שזמין בשאילתת כרטיסי המתנה וניתן להשתמש בו מספר פעמים או לשלב אותו עם משתנים אחרים. משתנה ה-Liquid scheduledAt זמין בזרימות עבודה שמשתמשות בטריגר Scheduled time. תג ה-Liquid date_minus הוא תג Flow מיוחד שמאפשר להחסיר זמן מתאריך.
בעת תשאול נתונים, כדאי לדעת את הדברים הבאים:
שאילתות חייבות להיות בהתאם לתחביר מסוים
ערכים של שדות שאילתה אינם מתועדים תמיד. במקרים מסוימים, ניתן למצוא את הערכים על ידי עיון במסמכי ה-API. לחלופין, לרוב אפשר למצוא את ערכי השדות בכתובות ה-URL במנהל בעת ביצוע סינון. לדוגמה, כדי למצוא ערכים מסוימים של שאילתת הזמנה, יש לסנן את הדף 'הזמנות' במנהל, ולאחר מכן לבדוק את כתובת ה-URL.
ניתן להפעיל או לבדוק שאילתה בחנות שלך באמצעות האפליקציה Shopify GraphiQL.
יש לשים לב למה שקורה במקרה של כשל בשאילתה. לרוב ה-API יחזיר את כל התוצאות (במקום לא להחזיר אף תוצאה).
נתונים שהוחזרו
כל הפעולות מסוג Get data מחזירות רשימה שכוללת בין 0 ל-100 משאבים. בהתאם לתרחיש השימוש שלך, ייתכן שתרצה להשתמש בנתונים האלה בדרכים שונות:
- אם יש לך צורך לטפל בכל פריט ברשימה בנפרד, למשל כדי להוסיף תג לכל אחד מהם, ניתן להשתמש בפעולה For each.
- אם יש לך צורך לצבור נתונים, למשל כדי לספור כמה תוצאות הוחזרו, תוכל להשתמש בפעולות Count או Sum.
- אם ברצונך להוציא את הרשימה כפלט, למשל כדי לשלוח דוא"ל עם כל הפריטים, ניתן להשתמש בנתונים שהוחזרו ישירות בפעולות הבאות.
כדי לגשת לנתונים שהוחזרו בשלבים שבאים לאחר פעולה זו, יש להשתמש במשתנה שנקרא Get gift card data, שהוא רשימה של כרטיסי מתנה. ניתן להשתמש במשתנה זה גם בתנאים וגם בפעולות. לדוגמה, ניתן לשלוח את רשימת כרטיסי המתנה בפעולה Send internal email כך:
{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}טריגרים
ניתן להשתמש בפעולה זו בכל זרימת עבודה, כולל בטריגר Scheduled time. בזרימת עבודה שמשתמשת בטריגר Scheduled time, זרימת העבודה מתחילה בזמן שציינת, ולא כתוצאה מאירוע. מכיוון שאין אירוע ספציפי בחנות שלך או באפליקציה שמתחיל את זרימת העבודה, לא נכללים נתונים באופן אוטומטי.