אחזור נתוני אוסף
בזרימות עבודה שדורשות נתוני אוסף, אפשר להשתמש בפעולה אחזור נתוני אוסף כדי לאחזר מידע על אוספים מהחנות שלך.
תצורה
שדות
הפעולה אחזור נתוני אוסף מכילה את השדות הבאים.
| שדה | תיאור |
|---|---|
| מיון נתונים לפי | חובה. הפרמטרים שעל פיהם ימוינו הנתונים המוחזרים על-ידי שאילתת החיפוש. |
| מספר תוצאות מרבי | חובה. הכמות המרבית של תוצאות שיכולות להיות מוחזרות על ידי שאילתת החיפוש שבחרת. אפשר להחזיר עד 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_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}טריגרים
אפשר להשתמש בפעולה זו בכל זרימת עבודה, כולל בטריגר זמן מתוזמן. בזרימת עבודה שמשתמשת בטריגר זמן מתוזמן, זרימת העבודה מתחילה בזמן שציינת, ולא כתוצאה מאירוע. מכיוון שאין אירוע ספציפי בחנות שלך או באפליקציה שמתחיל את זרימת העבודה, לא נכללים נתונים באופן אוטומטי.