קבלת נתוני דף

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

תצורה

שדות

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

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

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

published_status:published

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

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

• רשימת מסנני דפים זמינים

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

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

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

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

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

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

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

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

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

טריגרים

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

מסמכי עזר של API

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