קבלת נתוני מיקום

בזרימות עבודה שדורשות נתוני מיקום, אפשר להשתמש בפעולה קבלת נתוני מיקום כדי לאחזר מידע על מיקומים מחנות ה-Shopify שלך. מיקומים הם כל מקום שבו מאחסנים מלאי, מוכרים מוצרים, או שולחים או ממלאים הזמנות.

תצורה

שדות

הפעולה קבלת נתוני מיקום כוללת את השדות הבאים.

מחרוזת שאילתה

זוהי דוגמה לשאילתה לקבלת מיקומים שבהם מופעלת האפשרות איסוף בחנות:

pickup_in_store:enabled

המשתנה pickup_in_store הוא מסנן שזמין בשאילתת המיקומים וניתן להשתמש בו מספר פעמים או לשלב אותו עם משתנים אחרים.

בעת יצירת שאילתה לנתונים, כדאי לדעת:

• רשימה של מסנני מיקומים זמינים

• שאילתות חייבות להיות בהתאם לתחביר מסוים

• ערכי שדות של שאילתה אינם מתועדים תמיד. במקרים מסוימים, אפשר למצוא את הערכים על-ידי עיון במסמכי ה-API. לחלופין, לעתים קרובות אפשר למצוא את ערכי השדות בכתובות ה-URL בלוח המנהל בעת ביצוע סינון. לדוגמה, כדי למצוא ערכים מסוימים של שאילתת הזמנה, יש לסנן את הדף 'הזמנות' בלוח המנהל ולאחר מכן לבדוק את כתובת ה-URL.

• אפשר להפעיל או לבדוק שאילתה בחנות שלך באמצעות היישום Shopify GraphiQL.

• חשוב לשים לב למה שקורה אם השאילתה נכשלת. לעתים קרובות ה-API יחזיר את כל התוצאות (במקום לא להחזיר תוצאות כלל).

נתונים שהוחזרו

כל הפעולות מסוג קבלת נתונים מחזירות רשימה של בין 0 ל-100 משאבים. בהתאם למקרה השימוש, ייתכן שיהיה צורך להשתמש בנתונים אלה בדרכים שונות:

• אם יש צורך לטפל בכל פריט ברשימה בנפרד, למשל להוסיף תג לכל אחד מהם, אפשר להשתמש בפעולה עבור כל אחד.
• אם יש צורך לצבור נתונים, כגון ספירת התוצאות שהוחזרו, אפשר להשתמש בפעולה ספירה או סכום.
• אם יש צורך ליצור פלט של הרשימה, למשל לשלוח דוא"ל עם כל הפריטים, אפשר להשתמש בנתונים שהוחזרו ישירות בפעולות הבאות.

כדי לגשת לנתונים שהוחזרו בשלבים שאחרי פעולה זו, יש להשתמש במשתנה שנקרא קבלת נתוני מיקום, שהוא רשימה של מיקומים. אפשר להשתמש במשתנה זה גם בתנאים וגם בפעולות. לדוגמה, אפשר לשלוח את רשימת המיקומים בפעולה שליחת דוא"ל פנימי בצורה כזו:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

טריגרים

אפשר להשתמש בפעולה זו בכל זרימת עבודה, כולל בטריגר זמן מתוזמן. בזרימת עבודה המשתמשת בטריגר זמן מתוזמן, זרימת העבודה מתחילה בזמן שהגדרת, ולא כתוצאה מאירוע. מכיוון שאין אירוע ספציפי בחנות או מיישום שמתחיל את זרימת העבודה, אין נתונים שנכללים באופן אוטומטי.

הפניה ל-API

למידע נוסף על ה-API שבו נעשה שימוש בפעולה זו, ניתן לעיין בשאילתת מיקומים.