קבלת נתוני מוצר

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

תצורה

שדות

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

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

זוהי דוגמה לשאילתה לאחזור מוצרים שעודכנו ביום האחרון:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

המשתנה updated_at הוא מסנן שזמין בשאילתת מוצרים וניתן להשתמש בו מספר פעמים או לשלב אותו עם משתנים אחרים. משתנה Liquid‏ scheduledAt זמין בזרימות עבודה שהשתמשו בטריגר Scheduled time. תג Liquid‏ date_minus הוא תג Flow מיוחד שמאפשר להחסיר זמן מתאריך.

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

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

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

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

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

כדי לגשת לנתונים שהוחזרו בשלבים שאחרי הפעולה הזו, השתמש במשתנה שנקרא Get product data, שהוא רשימה של מוצרים. ניתן להשתמש במשתנה זה גם בתנאים וגם בפעולות. לדוגמה, אפשר לשלוח את רשימת המוצרים בפעולה Send internal email באופן הבא:

{% for single_product in GetProductData %}
* {{ single_product.name }}
{% endfor %}

טריגרים

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

פרטי API

• משאב מוצר
• מסנני שאילתת מוצרים

תבניות

הוספת מוצרים עם תג לאוסף בעתיד

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

מחיקת מוצרים לא פעילים

מחיקת מוצרים ללא מלאי שלא עודכנו במשך שנה. הצגת תבנית

פרסום מוצרים עם תג מסוים בעתיד

בתאריך עתידי, אחזור מוצרים עם תג מסוים ופרסומם. שימוש בטריגר Scheduled time ובפעולה Get product data. הצגת תבנית

הסרת תג של מוצר חדש 90 ימים לאחר יצירת המוצר

בכל יום, מאחזר עד 100 מוצרים שנוצרו לפני יותר מ-90 ימים ועדיין יש להם את התג 'חדש' (new). לאחר מכן, זרימת העבודה מסירה את התגים האלה מכל מוצר. הצגת תבנית

תזמון הסרת מוצרים מהחנות המקוונת בתאריך ובשעה שצוינו

בתאריך אחד בעתיד, הסרת מוצרים מהחנות המקוונת לפי תג, מזהה (id) או מק"ט (sku). התבנית משתמשת בטריגר Scheduled time, בפעולה Get Product Data ובלולאת For Each. הצגת תבנית

שליחת סיכום דוא"ל יומי עם מוצרים שאזלו מהמלאי

בכל יום, מאחזר את כל המוצרים שיש להם מלאי של 0 ושולח סיכום בדוא"ל. התבנית משתמשת בפעולה Get product data ובטריגר Scheduled time. הצגת תבנית

שליחת התראה בדוא"ל כאשר מתווספת גרסה עם מק"ט כפול

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

מעקב אחר גרסאות מוצרים שנמצאות במבצע באמצעות מטא שדה של מוצר

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