קבלת נתוני קטלוג

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

בדף זה

תצורה

שדות

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

שדות בשימוש בפעולות קבלת נתונים.
שדה	תיאור
מיון נתונים לפי	שדה חובה. הפרמטרים שלפיהם ממוינים הנתונים שמוחזרים על ידי שאילתת החיפוש.
מספר מקסימלי של תוצאות	שדה חובה. הכמות המרבית של תוצאות שיכולות לחזור משאילתת החיפוש שבחרת. אפשר להחזיר עד 100 בכל פעם.
שאילתה	שדה חובה. יש לבחור מבין השאילתות הנפוצות או לבחור באפשרות מתקדם (Advanced) כדי ליצור אחת משלך.

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

זוהי שאילתה לדוגמה לקבלת כל הקטלוגים הפעילים:

status:ACTIVE

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

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

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

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

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

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

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

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

טריגרים

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

הפניה ל-API

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