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