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