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

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

תצורה

שדות

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

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

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

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

המשתנה published_at הוא מסנן הזמין בשאילתת מאמרים (Articles) וניתן להשתמש בו מספר פעמים או לשלבו עם משתנים אחרים. משתנה ה-Liquid‏ scheduledAt זמין בתהליכי עבודה המשתמשים בטריגר זמן מתוזמן (Scheduled time). תג ה-Liquid‏ date_minus הוא תג Flow מיוחד המאפשר להחסיר זמן מתאריך.

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

• רשימה של מסנני מאמרים זמינים

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

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

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

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

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

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

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

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

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

טריגרים

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

חומר עזר ל-API

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