עזרה
התחברות

קבלת רשומות של מטא אובייקט

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

בעמוד זה

תצורה

שדות

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

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

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

זוהי שאילתה לדוגמה לקבלת רשומות של מטא אובייקט, אם הערך בשדה email תואם לכתובת הדוא"ל שבהזמנה:

{{fields.email}}:"{{order.email}}"

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

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

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

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

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

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

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

כדי לגשת לנתונים שהוחזרו בשלבים הבאים אחרי פעולה זו, יש להשתמש במשתנה שנקרא Get metaobject entries, שהוא רשימה של רשומות מטא אובייקטים. ניתן להשתמש במשתנה זה הן בתנאים והן בפעולות. לדוגמה, אפשר לשלוח את רשימת צמדי מפתח-ערך (key-value) עבור רשומות המטא אובייקטים בפעולת Send internal email כך:

{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
  {% for fields_item in getMetaobjectEntries_item.system.fields %}
    {{fields_item.key}}:{{fields_item.value}}
  {% endfor %}
{% endfor %}

טריגרים

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

פרטי API